> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fonte de dicionário do Cassandra

> Configure o Cassandra como fonte de dicionário no ClickHouse.

Exemplo de configurações:

<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="Arquivo de configuração">
    ```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>

Campos de configuração:

| Configuração | Descrição |
| - | - |
| `host` | O host do Cassandra ou uma lista de hosts separada por vírgulas. |
| `port` | A porta dos servidores Cassandra. Se não for especificada, a porta padrão `9042` será usada. |
| `user` | Nome do usuário do Cassandra. |
| `password` | Senha do usuário do Cassandra. |
| `keyspace` | Nome do keyspace (banco de dados). |
| `column_family` | Nome da família de colunas (tabela). |
| `allow_filtering` | Indicador para permitir ou não condições potencialmente dispendiosas nas colunas da chave de clustering. O valor padrão é `1`. |
| `partition_key_prefix` | Número de colunas da chave de partição na chave primária da tabela Cassandra. Obrigatório para dicionários de chave composta. A ordem das colunas de chave na definição do dicionário deve ser a mesma do Cassandra. O valor padrão é `1` (a primeira coluna de chave é uma chave de partição, e as demais colunas de chave são chaves de clustering). |
| `consistency` | Nível de consistência. Valores possíveis: `One`, `Two`, `Three`, `All`, `EachQuorum`, `Quorum`, `LocalQuorum`, `LocalOne`, `Serial`, `LocalSerial`. O valor padrão é `One`. |
| `where` | Critério de seleção opcional. |
| `max_threads` | O número máximo de threads a ser usado para carregar dados de várias partições em dicionários de chave composta. |
| `query` | Consulta personalizada. Opcional. |

<Note>
  Os campos `column_family` e `where` não podem ser usados junto com o campo `query`. Além disso, um dos campos `column_family` ou `query` deve ser declarado.
</Note>