DSN=MSSQL;UID=test;PWD=test300360ksString
```
或
``` sql
CREATE DICTIONARY test (
k UInt64,
s String DEFAULT ''
)
PRIMARY KEY k
SOURCE(ODBC(table 'dict' connection_string 'DSN=MSSQL;UID=test;PWD=test'))
LAYOUT(FLAT())
LIFETIME(MIN 300 MAX 360)
```
## DBMS {#dbms}
### Mysql {#dicts-external_dicts_dict_sources-mysql}
设置示例:
``` xml
3306clickhouseqwertyexample01-11example01-21db_name
table_name
id=10SQL_QUERY
```
或
``` sql
SOURCE(MYSQL(
port 3306
user 'clickhouse'
password 'qwerty'
replica(host 'example01-1' priority 1)
replica(host 'example01-2' priority 1)
db 'db_name'
table 'table_name'
where 'id=10'
invalidate_query 'SQL_QUERY'
))
```
设置字段:
- `port` – The port on the MySQL server. You can specify it for all replicas, or for each one individually (inside ``).
- `user` – Name of the MySQL user. You can specify it for all replicas, or for each one individually (inside ``).
- `password` – Password of the MySQL user. You can specify it for all replicas, or for each one individually (inside ``).
- `replica` – Section of replica configurations. There can be multiple sections.
- `replica/host` – The MySQL host.
- `replica/priority` – The replica priority. When attempting to connect, ClickHouse traverses the replicas in order of priority. The lower the number, the higher the priority.
- `db` – Name of the database.
- `table` – Name of the table.
- `where` – The selection criteria. The syntax for conditions is the same as for `WHERE` 例如，mysql中的子句, `id > 10 AND id < 20`. 可选参数。
- `invalidate_query` – Query for checking the dictionary status. Optional parameter. Read more in the section [更新字典](external-dicts-dict-lifetime.md).
MySQL可以通过套接字在本地主机上连接。 要做到这一点，设置 `host` 和 `socket`.
设置示例:
``` xml
localhost/path/to/socket/file.sockclickhouseqwertydb_name
table_name
id=10SQL_QUERY
```
或
``` sql
SOURCE(MYSQL(
host 'localhost'
socket '/path/to/socket/file.sock'
user 'clickhouse'
password 'qwerty'
db 'db_name'
table 'table_name'
where 'id=10'
invalidate_query 'SQL_QUERY'
))
```
### ClickHouse {#dicts-external_dicts_dict_sources-clickhouse}
设置示例:
``` xml
example01-01-19000defaultdefault
ids
id=10
```
或
``` sql
SOURCE(CLICKHOUSE(
host 'example01-01-1'
port 9000
user 'default'
password ''
db 'default'
table 'ids'
where 'id=10'
))
```
设置字段:
- `host` – The ClickHouse host. If it is a local host, the query is processed without any network activity. To improve fault tolerance, you can create a [分布](../../../engines/table-engines/special/distributed.md) 表并在后续配置中输入它。
- `port` – The port on the ClickHouse server.
- `user` – Name of the ClickHouse user.
- `password` – Password of the ClickHouse user.
- `db` – Name of the database.
- `table` – Name of the table.
- `where` – The selection criteria. May be omitted.
- `invalidate_query` – Query for checking the dictionary status. Optional parameter. Read more in the section [更新字典](external-dicts-dict-lifetime.md).
### Mongodb {#dicts-external_dicts_dict_sources-mongodb}
设置示例:
``` xml
localhost27017testdictionary_source
```
或
``` sql
SOURCE(MONGO(
host 'localhost'
port 27017
user ''
password ''
db 'test'
collection 'dictionary_source'
))
```
设置字段:
- `host` – The MongoDB host.
- `port` – The port on the MongoDB server.
- `user` – Name of the MongoDB user.
- `password` – Password of the MongoDB user.
- `db` – Name of the database.
- `collection` – Name of the collection.
### Redis {#dicts-external_dicts_dict_sources-redis}
设置示例:
``` xml
localhost6379simple0
```
或
``` sql
SOURCE(REDIS(
host 'localhost'
port 6379
storage_type 'simple'
db_index 0
))
```
设置字段:
- `host` – The Redis host.
- `port` – The port on the Redis server.
- `storage_type` – The structure of internal Redis storage using for work with keys. `simple` 适用于简单源和散列单键源, `hash_map` 用于具有两个键的散列源。 不支持具有复杂键的范围源和缓存源。 可以省略，默认值为 `simple`.
- `db_index` – The specific numeric index of Redis logical database. May be omitted, default value is 0.
[原始文章](https://clickhouse.tech/docs/en/query_language/dicts/external_dicts_dict_sources/)