mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-15 10:52:30 +00:00
2.7 KiB
2.7 KiB
slug |
---|
/zh/engines/table-engines/special/file |
文件(输入格式)
数据源是以 Clickhouse 支持的一种输入格式(TabSeparated,Native等)存储数据的文件。
用法示例:
- 从 ClickHouse 导出数据到文件。
- 将数据从一种格式转换为另一种格式。
- 通过编辑磁盘上的文件来更新 ClickHouse 中的数据。
在 ClickHouse 服务器中的使用
File(Format)
选用的 Format
需要支持 INSERT
或 SELECT
。有关支持格式的完整列表,请参阅 格式。
ClickHouse 不支持给 File
指定文件系统路径。它使用服务器配置中 路径 设定的文件夹。
使用 File(Format)
创建表时,它会在该文件夹中创建空的子目录。当数据写入该表时,它会写到该子目录中的 data.Format
文件中。
你也可以在服务器文件系统中手动创建这些子文件夹和文件,然后通过 ATTACH 将其创建为具有对应名称的表,这样你就可以从该文件中查询数据了。
!!! 注意 "注意" 注意这个功能,因为 ClickHouse 不会跟踪这些文件在外部的更改。在 ClickHouse 中和 ClickHouse 外部同时写入会造成结果是不确定的。
示例:
1. 创建 file_engine_table
表:
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
文件,并且包含内容:
$ cat data.TabSeparated
one 1
two 2
3. 查询这些数据:
SELECT * FROM file_engine_table
┌─name─┬─value─┐
│ one │ 1 │
│ two │ 2 │
└──────┴───────┘
在 Clickhouse-local 中的使用
使用 clickhouse-local 时,File 引擎除了 Format
之外,还可以接收文件路径参数。可以使用数字或名称来指定标准输入/输出流,例如 0
或 stdin
,1
或 stdout
。
例如:
$ 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
- 索引
- 副本