Funções de tabela

Documentação sobre Funções de tabela

Funções de tabela são usadas para construir tabelas.

​

Uso

Funções de tabela podem ser usadas na cláusula FROM de uma consulta SELECT. Por exemplo, você pode usar SELECT para selecionar dados de um arquivo na sua máquina local usando a função de tabela file.

Query

echo "1, 2, 3" > example.csv

Response

./clickhouse client
:) SELECT * FROM file('example.csv')
┌─c1─┬─c2─┬─c3─┐
│  1 │  2 │  3 │
└────┴────┴────┘

Você também pode usar funções de tabela para criar uma tabela temporária disponível apenas na consulta atual. Por exemplo:

Query

SELECT * FROM generateSeries(1,5);

Response

┌─generate_series─┐
│               1 │
│               2 │
│               3 │
│               4 │
│               5 │
└─────────────────┘

A tabela é excluída quando a consulta é concluída.

As funções de tabela podem ser usadas para criar tabelas, usando a seguinte sintaxe:

Query

CREATE TABLE [IF NOT EXISTS] [db.]table_name AS table_function()

Por exemplo:

Query

CREATE TABLE series AS generateSeries(1, 5);
SELECT * FROM series;

Response

┌─generate_series─┐
│               1 │
│               2 │
│               3 │
│               4 │
│               5 │
└─────────────────┘

Por fim, funções de tabela podem ser usadas para inserir dados em uma tabela. Por exemplo, poderíamos gravar o conteúdo da tabela que criamos no exemplo anterior em um arquivo no disco usando novamente a função de tabela file:

Query

INSERT INTO FUNCTION file('numbers.csv', 'CSV') SELECT * FROM series;

Query

cat numbers.csv
1
2
3
4
5

A maioria das funções de tabela precisa do privilégio CREATE TEMPORARY TABLE para ser executada, portanto um SELECT ou INSERT que execute uma delas é recusado quando readonly está definido como 1.