URL - ClickHouse Documentation

URL データベースエンジンは、テーブル名を URL として扱い、その URL にあるデータをテーブルとして公開します。内部では url テーブル関数を使用し、各 URL を file、s3、HDFS、Azure Blob Storage、HTTP などの適切なバックエンドへディスパッチします。

データベースの作成

CREATE DATABASE web_data
ENGINE = URL([base_url]);

base_url を指定すると、相対テーブル名はその base URL を基準に解決されます。base URL を指定しない場合、すべてのテーブル名を完全な URL で指定する必要があります。

Usage

CREATE DATABASE web_data
ENGINE = URL('https://example.com/data/');

SELECT * FROM web_data.`daily.csv`;

このデータベースはテーブル定義を保持しません。各テーブルは使用時に URL から解決されるため、そのスキーマは現在のデータから推論されます。テーブル名には完全な URL も使用でき、例えば web_data.s3://bucket/data/events.parquet“ のように指定できます。

アクセス制御

このデータベースを作成するには、table_engines_require_grant の設定にかかわらず、URL に対する READ および WRITE のソース権限が必要です。テーブルの読み取りには、解決後のバックエンドに対する READ ソース権限が必要であり、書き込みには対応する WRITE 権限が必要です。例:

GRANT READ, WRITE ON URL TO user_name;
GRANT READ, WRITE ON S3 TO user_name;

file:// を base URL とするデータベースの場合、ユーザーには READ ON FILE が必要です。ClickHouse server では、ローカルファイルへのアクセスはさらに user_files_path 配下に制限されます。バージョンおよび互換性設定の詳細については、SOURCES privileges を参照してください。

関連項目

最終更新日 2026年9月26日