> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Источник словаря Cassandra

> Настройка Cassandra как источника словаря в ClickHouse.

Пример настроек:

<Tabs>
  <Tab title="DDL">
    ```sql theme={null}
    SOURCE(CASSANDRA(
        host 'localhost'
        port 9042
        user 'username'
        password 'qwerty123'
        keyspace 'database_name'
        column_family 'table_name'
        allow_filtering 1
        partition_key_prefix 1
        consistency 'One'
        where '"SomeColumn" = 42'
        max_threads 8
        query 'SELECT id, value_1, value_2 FROM database_name.table_name'
    ))
    ```
  </Tab>

  <Tab title="Файл конфигурации">
    ```xml theme={null}
    <source>
        <cassandra>
            <host>localhost</host>
            <port>9042</port>
            <user>username</user>
            <password>qwerty123</password>
            <keyspase>database_name</keyspase>
            <column_family>table_name</column_family>
            <allow_filtering>1</allow_filtering>
            <partition_key_prefix>1</partition_key_prefix>
            <consistency>One</consistency>
            <where>"SomeColumn" = 42</where>
            <max_threads>8</max_threads>
            <query>SELECT id, value_1, value_2 FROM database_name.table_name</query>
        </cassandra>
    </source>
    ```
  </Tab>
</Tabs>

Поля настроек:

| Настройка              | Описание                                                                                                                                                                                                                                                                                                                                                     |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `host`                 | Хост Cassandra или список хостов, разделённых запятыми.                                                                                                                                                                                                                                                                                                      |
| `port`                 | Порт серверов Cassandra. Если не указан, используется порт по умолчанию `9042`.                                                                                                                                                                                                                                                                              |
| `user`                 | Имя пользователя Cassandra.                                                                                                                                                                                                                                                                                                                                  |
| `password`             | Пароль пользователя Cassandra.                                                                                                                                                                                                                                                                                                                               |
| `keyspace`             | Имя keyspace (базы данных).                                                                                                                                                                                                                                                                                                                                  |
| `column_family`        | Имя семейства столбцов (таблицы).                                                                                                                                                                                                                                                                                                                            |
| `allow_filtering`      | Флаг, разрешающий или запрещающий потенциально затратные условия для столбцов ключа кластеризации. Значение по умолчанию — `1`.                                                                                                                                                                                                                              |
| `partition_key_prefix` | Количество столбцов ключа партиционирования в первичном ключе таблицы Cassandra. Обязательно для словарей с составным ключом. Порядок столбцов ключа в определении словаря должен совпадать с порядком в Cassandra. Значение по умолчанию — `1` (первый столбец ключа является ключом партиционирования, а остальные столбцы ключа — ключами кластеризации). |
| `consistency`          | Уровень согласованности. Возможные значения: `One`, `Two`, `Three`, `All`, `EachQuorum`, `Quorum`, `LocalQuorum`, `LocalOne`, `Serial`, `LocalSerial`. Значение по умолчанию — `One`.                                                                                                                                                                        |
| `where`                | Необязательное условие отбора.                                                                                                                                                                                                                                                                                                                               |
| `max_threads`          | Максимальное число потоков, используемых для загрузки данных из нескольких партиций в словарях с составным ключом.                                                                                                                                                                                                                                           |
| `query`                | Пользовательский запрос. Необязательный параметр.                                                                                                                                                                                                                                                                                                            |

<Note>
  Поля `column_family` и `where` нельзя использовать совместно с полем `query`. При этом должно быть объявлено либо поле `column_family`, либо поле `query`.
</Note>