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

# 本地文件字典源

> 在 ClickHouse 中将本地文件配置为字典源。

本地文件源会从本地文件系统中的文件加载字典数据。这适用于以 TSV、CSV 或任何其他[支持的格式](/zh/reference/formats)存储为平面文件的小型静态查找表。

设置示例：

<Tabs>
  <Tab title="DDL">
    ```sql theme={null}
    SOURCE(FILE(path './user_files/os.tsv' format 'TabSeparated'))
    ```
  </Tab>

  <Tab title="配置文件">
    ```xml theme={null}
    <source>
      <file>
        <path>/opt/dictionaries/os.tsv</path>
        <format>TabSeparated</format>
      </file>
    </source>
    ```
  </Tab>
</Tabs>

<br />

设置字段：

| Setting  | Description                                        |
| -------- | -------------------------------------------------- |
| `path`   | 文件的绝对路径。                                           |
| `format` | 文件格式。支持 [Formats](/zh/reference/formats) 中描述的所有格式。 |

当通过 DDL 命令 (`CREATE DICTIONARY ...`) 创建源为 `FILE` 的字典时，源文件必须位于 `user_files` 目录中，以防止数据库用户访问 ClickHouse 节点上的任意文件。

**另请参阅**

* [字典函数](/zh/reference/functions/table-functions/dictionary)