テーブル関数

テーブル関数は、テーブルを構築するための機能です。

使用方法

テーブル関数は、SELECTクエリのFROM 句で使用できます。たとえば、fileテーブル関数を使って、ローカルマシン上のファイルからデータをSELECTできます。

Query

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

Response

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

現在のクエリ内でのみ利用可能な一時テーブルを作成するために、テーブル関数を使用することもできます。たとえば、次のとおりです。

Query

SELECT * FROM generateSeries(1,5);

Response

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

テーブルは、クエリの終了時に削除されます。テーブル関数は、次の構文を使用してテーブルを作成するための方法として利用できます。

Query

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

例:

Query

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

Response

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

最後に、テーブル関数を使ってテーブルにデータを INSERT することもできます。たとえば、前の例で作成したテーブルの内容を、再度 file テーブル関数を使ってディスク上のファイルに書き出せます:

Query

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

Query

cat numbers.csv
1
2
3
4
5

ほとんどのテーブル関数は実行に CREATE TEMPORARY TABLE 権限を必要とするため、 readonly が 1 に設定されている場合、テーブル関数を実行する SELECT や INSERT は拒否されます。