mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-16 11:22:12 +00:00
2e1f6bc56d
* replace exit with assert in test_single_page * improve save_raw_single_page docs option * More grammar fixes * "Built from" link in new tab * fix mistype * Example of include in docs * add anchor to meeting form * Draft of translation helper * WIP on translation helper * Replace some fa docs content with machine translation * add normalize-en-markdown.sh * normalize some en markdown * normalize some en markdown * admonition support * normalize * normalize * normalize * support wide tables * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * lightly edited machine translation of introdpection.md * lightly edited machhine translation of lazy.md * WIP on translation utils * Normalize ru docs * Normalize other languages * some fixes * WIP on normalize/translate tools * add requirements.txt * [experimental] add es docs language as machine translated draft * remove duplicate script * Back to wider tab-stop (narrow renders not so well)
74 lines
3.6 KiB
Markdown
74 lines
3.6 KiB
Markdown
## INSERTAR {#insert}
|
|
|
|
Adición de datos.
|
|
|
|
Formato de consulta básico:
|
|
|
|
``` sql
|
|
INSERT INTO [db.]table [(c1, c2, c3)] VALUES (v11, v12, v13), (v21, v22, v23), ...
|
|
```
|
|
|
|
La consulta puede especificar una lista de columnas para insertar `[(c1, c2, c3)]`. En este caso, el resto de las columnas se llenan con:
|
|
|
|
- Los valores calculados a partir del `DEFAULT` expresiones especificadas en la definición de la tabla.
|
|
- Ceros y cadenas vacías, si `DEFAULT` expresiones no están definidas.
|
|
|
|
Si [strict\_insert\_defaults=1](../operations/settings/settings.md), columnas que no tienen `DEFAULT` definido debe figurar en la consulta.
|
|
|
|
Los datos se pueden pasar al INSERT en cualquier [formato](../interfaces/formats.md#formats) con el apoyo de ClickHouse. El formato debe especificarse explícitamente en la consulta:
|
|
|
|
``` sql
|
|
INSERT INTO [db.]table [(c1, c2, c3)] FORMAT format_name data_set
|
|
```
|
|
|
|
Por ejemplo, el siguiente formato de consulta es idéntico a la versión básica de INSERT … VALUES:
|
|
|
|
``` sql
|
|
INSERT INTO [db.]table [(c1, c2, c3)] FORMAT Values (v11, v12, v13), (v21, v22, v23), ...
|
|
```
|
|
|
|
ClickHouse elimina todos los espacios y un avance de línea (si hay uno) antes de los datos. Al formar una consulta, recomendamos colocar los datos en una nueva línea después de los operadores de consulta (esto es importante si los datos comienzan con espacios).
|
|
|
|
Ejemplo:
|
|
|
|
``` sql
|
|
INSERT INTO t FORMAT TabSeparated
|
|
11 Hello, world!
|
|
22 Qwerty
|
|
```
|
|
|
|
Puede insertar datos por separado de la consulta mediante el cliente de línea de comandos o la interfaz HTTP. Para obtener más información, consulte la sección “[Interfaz](../interfaces/index.md#interfaces)”.
|
|
|
|
### Limitación {#constraints}
|
|
|
|
Si la tabla tiene [limitación](create.md#constraints), sus expresiones se verificarán para cada fila de datos insertados. Si alguna de esas restricciones no se satisface, el servidor generará una excepción que contenga el nombre y la expresión de la restricción, la consulta se detendrá.
|
|
|
|
### Insertar los resultados de `SELECT` {#insert-query-insert-select}
|
|
|
|
``` sql
|
|
INSERT INTO [db.]table [(c1, c2, c3)] SELECT ...
|
|
```
|
|
|
|
Las columnas se asignan de acuerdo con su posición en la cláusula SELECT. Sin embargo, sus nombres en la expresión SELECT y la tabla para INSERT pueden diferir. Si es necesario, se realiza la fundición de tipo.
|
|
|
|
Ninguno de los formatos de datos, excepto Valores, permite establecer valores para expresiones como `now()`, `1 + 2` y así sucesivamente. El formato Values permite el uso limitado de expresiones, pero esto no se recomienda, porque en este caso se usa código ineficiente para su ejecución.
|
|
|
|
No se admiten otras consultas para modificar partes de datos: `UPDATE`, `DELETE`, `REPLACE`, `MERGE`, `UPSERT`, `INSERT UPDATE`.
|
|
Sin embargo, puede eliminar datos antiguos usando `ALTER TABLE ... DROP PARTITION`.
|
|
|
|
`FORMAT` cláusula debe especificarse al final de la consulta si `SELECT` cláusula contiene la función de tabla [entrada()](table_functions/input.md).
|
|
|
|
### Consideraciones de rendimiento {#performance-considerations}
|
|
|
|
`INSERT` ordena los datos de entrada por clave principal y los divide en particiones por una clave de partición. Si inserta datos en varias particiones a la vez, puede reducir significativamente el rendimiento del `INSERT` consulta. Para evitar esto:
|
|
|
|
- Agregue datos en lotes bastante grandes, como 100.000 filas a la vez.
|
|
- Agrupe los datos por una clave de partición antes de cargarlos en ClickHouse.
|
|
|
|
El rendimiento no disminuirá si:
|
|
|
|
- Los datos se agregan en tiempo real.
|
|
- Carga datos que normalmente están ordenados por tiempo.
|
|
|
|
[Artículo Original](https://clickhouse.tech/docs/es/query_language/insert_into/) <!--hide-->
|