文件(输入格式)

数据源是以 Clickhouse 支持的一种输入格式（TabSeparated，Native等）存储数据的文件。

用法示例：

  • 从 ClickHouse 导出数据到文件。
  • 将数据从一种格式转换为另一种格式。
  • 通过编辑磁盘上的文件来更新 ClickHouse 中的数据。

在 ClickHouse 服务器中的使用

  1. File(Format)

选用的 Format 需要支持 INSERT 或 SELECT 。有关支持格式的完整列表，请参阅 格式。

ClickHouse 不支持给 File 指定文件系统路径。它使用服务器配置中 路径 设定的文件夹。

使用 File(Format) 创建表时，它会在该文件夹中创建空的子目录。当数据写入该表时，它会写到该子目录中的 data.Format 文件中。

你也可以在服务器文件系统中手动创建这些子文件夹和文件，然后通过 ATTACH 将其创建为具有对应名称的表，这样你就可以从该文件中查询数据了。

注意

注意这个功能，因为 ClickHouse 不会跟踪这些文件在外部的更改。在 ClickHouse 中和 ClickHouse 外部同时写入会造成结果是不确定的。

示例：

1. 创建 file_engine_table 表：

  1. CREATE TABLE file_engine_table (name String, value UInt32) ENGINE=File(TabSeparated)

默认情况下，Clickhouse 会创建目录 /var/lib/clickhouse/data/default/file_engine_table 。

2. 手动创建 /var/lib/clickhouse/data/default/file_engine_table/data.TabSeparated 文件，并且包含内容：

  1. $ cat data.TabSeparated
  2. one 1
  3. two 2

3. 查询这些数据:

  1. SELECT * FROM file_engine_table
  1. ┌─name─┬─value─┐
  2. │ one  │     1 │
  3. │ two  │     2 │
  4. └──────┴───────┘

在 Clickhouse-local 中的使用

使用 clickhouse-local 时，File 引擎除了 Format 之外，还可以接收文件路径参数。可以使用数字或名称来指定标准输入/输出流，例如 0 或 stdin，1 或 stdout。
例如：

  1. $ echo -e "1,2\n3,4" | clickhouse-local -q "CREATE TABLE table (a Int64, b Int64) ENGINE = File(CSV, stdin); SELECT a, b FROM table; DROP TABLE table"

功能实现

  • 读操作可支持并发，但写操作不支持
  • 不支持:
    • ALTER
    • SELECT ... SAMPLE
    • 索引
    • 副本