> ## 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.

# 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` | 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>