DataLakeCatalog データベースエンジンを使用します。
接続後、カタログ内のテーブルは指定したデータベース名の下に SQL コンソールで表示されます。標準の ClickHouse SQL でクエリを実行したり、MergeTree テーブルと結合したり、materialized view のソースとして使用したりできます。
前提条件
- サービスの権限。 データソースページにアクセスしてカタログを追加するには、
control-plane:service:manage権限が必要です。 - 実行中のサービス。 サービスがアイドル状態の場合は、接続またはリンク済みカタログを表示する前に、データソースページまたはサービス設定ページからサービスを起動してください。
- カタログの認証情報。 フライアウトを開く前に、カタログの種類に応じた接続情報を用意してください。カタログごとに必要なフィールドと認証方法は異なります。以下の「カタログ接続を追加する」を参照してください。
カタログに接続する
1
データカタログのフライアウトを開く
- 左側のナビゲーションでデータソースを選択します。
- データソースをまだ設定していない場合は、+ カタログを追加をクリックします。設定済みの場合は、データソースを追加 > データレイクカタログを追加をクリックします。
- データカタログに接続フライアウトで、カタログを選択ドロップダウンからカタログを選択します。カタログが複数のオープンテーブルフォーマットに対応している場合は、オープンテーブルフォーマットでフォーマットを選択します。
2
カタログ接続を追加する
以下からカタログを選択し、手順と前提条件を確認してください。次に、接続パラメータと データベース名 (SQLコンソールでカタログのテーブルを公開する ClickHouse データベース) を入力します。
- AWS Glue
- Unity Catalog（Iceberg）
- Unity Catalog（Delta）
- REST カタログ
- Microsoft OneLake
- Polaris
- BigLake Metastore
AWS Glue Catalog は、Glue Data Catalog に登録されている Iceberg テーブルを公開します。接続する前に、以下を確認してください。
- ClickHouse のバージョンが 25.12 以降であること。
- Iceberg テーブルが、対象リージョンの AWS Glue Data Catalog に登録されていること。
- アクセスキー認証の場合、Glue メタデータと基盤となる S3 オブジェクトの読み取り権限を持つ IAM ユーザーのアクセスキーがあること。
- IAM ロール認証 (26.2 以降) の場合、ClickHouse サービスロールを信頼する IAM ロールがあること。ロールの信頼ポリシーに、Settings → Network security information に表示されるサービスロール ARN を含めてください。IAM ポリシーの例については、Iceberg データへの安全なアクセスを参照してください。
us-west-2) を入力し、認証方法を選択します。アクセスキー認証- Authentication method として AWS Access Key を選択します。
- Access Key ID と Secret Access Key を入力します。
- Glue テーブルを公開する ClickHouse データベースの Database name を入力します。
- Authentication method として AWS IAM Role を選択します。
- フライアウトパネルから Service role ID (IAM) をコピーし、IAM ロールの信頼ポリシーに追加します。
- AWS Role ARN と、任意の AWS Role Session Name を入力します。
- Glue テーブルを公開する ClickHouse データベースの Database name を入力します。
Glue は複数のテーブルフォーマットをサポートしていますが、ClickHouse が Glue から読み取れるのは Iceberg テーブルのみです。
3
接続を保存
フィールドに入力したら:
- カタログを追加をクリックします。保存時に、ClickHouse が接続と認証情報を検証します。
- 成功すると、SQL コンソールで表示へのリンクを含む確認トーストが表示されます。カタログは、接続ステータスとテーブル数とともに リンクされたカタログテーブルに表示されます。
データをクエリする
1
カタログのテーブルを表示する
データソースページで、リンク済みカタログテーブルからカタログを見つけ、テーブルを表示をクリックします。ClickHouse で SQL コンソールが開き、カタログデータベースが選択された状態で利用可能なテーブルが一覧表示されます。
カタログを接続した直後は、テーブルが表示されないことがあります。カタログによっては、すべてのテーブルが一覧表示されるまでに最大 3 分かかる場合があります。
2
クエリを実行する
SQL エディタでクエリを記述し、実行をクリックします。完全なテーブル名をバッククォートで囲みます。
トラブルシューティング
- SQL コンソールにテーブルが表示されない場合は、カタログ内の認証情報、ネットワークアクセス、テーブルの種類を確認してください。表示したいテーブルが、サポートされているファイル形式およびテーブル形式であることを確認してください。
関連項目
- レイクハウスデータの分析を高速化 — 繰り返し実行するクエリに備え、カタログテーブルをMergeTreeに読み込む
- Icebergデータへの安全なアクセス — AWS IcebergおよびGlueへのアクセスに必要なIAMロールの設定