mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-17 13:13:36 +00:00
d91c97d15d
* Replace underscores with hyphens * remove temporary code * fix style check * fix collapse
91 lines
3.5 KiB
Markdown
91 lines
3.5 KiB
Markdown
---
|
||
machine_translated: true
|
||
machine_translated_rev: 3e185d24c9fe772c7cf03d5475247fb829a21dfa
|
||
toc_priority: 37
|
||
toc_title: File
|
||
---
|
||
|
||
# File {#table_engines-file}
|
||
|
||
El motor de tabla de archivos mantiene los datos en un archivo en uno de los [file
|
||
formato](../../../interfaces/formats.md#formats) (TabSeparated, Native, etc.).
|
||
|
||
Ejemplos de uso:
|
||
|
||
- Exportación de datos de ClickHouse a archivo.
|
||
- Convertir datos de un formato a otro.
|
||
- Actualización de datos en ClickHouse mediante la edición de un archivo en un disco.
|
||
|
||
## Uso En El Servidor De Clickhouse {#usage-in-clickhouse-server}
|
||
|
||
``` sql
|
||
File(Format)
|
||
```
|
||
|
||
El `Format` parámetro especifica uno de los formatos de archivo disponibles. Realizar
|
||
`SELECT` consultas, el formato debe ser compatible para la entrada, y para realizar
|
||
`INSERT` queries – for output. The available formats are listed in the
|
||
[Formato](../../../interfaces/formats.md#formats) apartado.
|
||
|
||
ClickHouse no permite especificar la ruta del sistema de archivos para`File`. Utilizará la carpeta definida por [camino](../../../operations/server-configuration-parameters/settings.md) configuración en la configuración del servidor.
|
||
|
||
Al crear una tabla usando `File(Format)` crea un subdirectorio vacío en esa carpeta. Cuando los datos se escriben en esa tabla, se colocan en `data.Format` en ese subdirectorio.
|
||
|
||
Puede crear manualmente esta subcarpeta y archivo en el sistema de archivos del servidor y luego [ATTACH](../../../sql-reference/statements/misc.md) para mostrar información con el nombre coincidente, para que pueda consultar datos desde ese archivo.
|
||
|
||
!!! warning "Advertencia"
|
||
Tenga cuidado con esta funcionalidad, ya que ClickHouse no realiza un seguimiento de los cambios externos en dichos archivos. El resultado de las escrituras simultáneas a través de ClickHouse y fuera de ClickHouse no está definido.
|
||
|
||
**Ejemplo:**
|
||
|
||
**1.** Configurar el `file_engine_table` tabla:
|
||
|
||
``` sql
|
||
CREATE TABLE file_engine_table (name String, value UInt32) ENGINE=File(TabSeparated)
|
||
```
|
||
|
||
Por defecto, ClickHouse creará una carpeta `/var/lib/clickhouse/data/default/file_engine_table`.
|
||
|
||
**2.** Crear manualmente `/var/lib/clickhouse/data/default/file_engine_table/data.TabSeparated` contener:
|
||
|
||
``` bash
|
||
$ cat data.TabSeparated
|
||
one 1
|
||
two 2
|
||
```
|
||
|
||
**3.** Consultar los datos:
|
||
|
||
``` sql
|
||
SELECT * FROM file_engine_table
|
||
```
|
||
|
||
``` text
|
||
┌─name─┬─value─┐
|
||
│ one │ 1 │
|
||
│ two │ 2 │
|
||
└──────┴───────┘
|
||
```
|
||
|
||
## Uso En Clickhouse-local {#usage-in-clickhouse-local}
|
||
|
||
En [Sistema abierto.](../../../operations/utilities/clickhouse-local.md) El motor de archivos acepta la ruta del archivo además de `Format`. Los flujos de entrada / salida predeterminados se pueden especificar utilizando nombres numéricos o legibles por humanos como `0` o `stdin`, `1` o `stdout`.
|
||
**Ejemplo:**
|
||
|
||
``` bash
|
||
$ 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"
|
||
```
|
||
|
||
## Detalles De La implementación {#details-of-implementation}
|
||
|
||
- Multiple `SELECT` las consultas se pueden realizar simultáneamente, pero `INSERT` las consultas se esperarán entre sí.
|
||
- Apoyado la creación de nuevos archivos por `INSERT` consulta.
|
||
- Si el archivo existe, `INSERT` añadiría nuevos valores en él.
|
||
- No soportado:
|
||
- `ALTER`
|
||
- `SELECT ... SAMPLE`
|
||
- Indice
|
||
- Replicación
|
||
|
||
[Artículo Original](https://clickhouse.tech/docs/en/operations/table_engines/file/) <!--hide-->
|