AWS Glue Iceberg カタログに接続する

このガイドでは、ビジュアルインターフェースを使用してVeloDB CloudをAWS Glue Iceberg catalogに接続する手順を説明します。

警告

前提条件: 作業を進める前に、AWS Setup Guideを完了して、S3バケット、Glueデータベース、適切な権限を持つIAMユーザーを作成してください。

ステップ1: カタログsに移動する

VeloDBウェアハウスで、左サイドバーのDevelopmentの下にあるDataセクションに移動し、カタログsをクリックします。

Add 外部カタログボタンがあるカタログsページが表示されます。

ステップ2: 外部カタログを追加する

Add 外部カタログをクリックして、利用可能なカタログタイプを表示します。

利用可能なカタログタイプには以下が含まれます:

• AWS Glue - Glue管理のIceberg/HiveTable用
• Hive Metastore - オンプレミスのHive用
• Amazon S3 Tables - S3ネイティブTable用
• Iceberg REST カタログ - Polaris、Gravitino、Tabular用
• Apache Polaris - Polarisカタログ用

ステップ3: AWS Glueを選択する

AWS Glueをクリックして設定フォームを開きます。

ステップ4: カタログ設定を構成する

AWS Setup Guideの値を使用してフォームに入力します:

基本情報

フィールド	説明	例
カタログ Name	カタログの一意識別子	glue_iceberg_useast1
コメント	オプションの説明	AWS Glue Iceberg catalog

Metastore設定

フィールド	説明	例
Table Format	IcebergまたはHiveを選択	Iceberg
Warehouse	IcebergウェアハウスへのS3パス	s3://my-bucket/iceberg
AWS Glue Region	GlueカタログのAWSリージョン	us-east-1
AWS Glue Endpoint	Glue APIエンドポイント	https://glue.us-east-1.amazonaws.com

認証

フィールド	説明
認証 タイプ	Access KeyまたはIAM Role
AK (Access Key)	あなたのAWS Access Key ID
SK (Secret Key)	あなたのAWS Secret Access Key

ストレージ

**"Use the authentication details configured for Metastore access"**にチェックを入れたままにして、S3アクセスに同じ認証情報を使用します。

備考

AKとSKフィールドには、AWS Setup Guideの実際のAWS認証情報を入力してください。

ステップ5: カタログを作成する

Confirmをクリックしてカタログを作成します。

VeloDBはAWS Glueへの接続を検証します。成功すると、成功通知が表示され、カタログがリストに表示されます。

ステップ6: SQLで検証する

左サイドバーのQuery > SQL Editorに移動して、カタログ接続をテストします。以下のクエリを実行してセットアップを検証してください（your_catalog_nameとyour_databaseを実際の名前に置き換えてください）:

すべてのカタログを一覧表示

SHOW CATALOGS;

期待される出力: リスト内に新しいGlueカタログが表示されます。

カタログ内のデータベースを一覧表示する

-- Replace 'your_catalog_name' with your catalog name (e.g., glue_iceberg_useast1)
SHOW DATABASES FROM your_catalog_name;

データベース内のTable一覧

-- Replace with your catalog and database names
SHOW TABLES FROM your_catalog_name.your_database;

Iceberg Tableからのデータクエリ

-- Example: Query the sample table created in Setup ステップ 5
SELECT * FROM your_catalog_name.lakehouse_iceberg_db.sample_table LIMIT 10;

備考

外部でデータを書き込んだ後にTableが表示されない場合は、REFRESH CATALOG your_catalog_name;を実行してメタデータキャッシュをクリアしてください。

---

トラブルシューティング

問題	解決策
"Cannot convert namespace to Glue database name"	データベース名にハイフンが含まれています。アンダースコアのみを使用してください。
"Lake Formation permission denied"	AWS CLIを使用してLake Formationの権限を付与してください。AWS Setup Guideを参照してください。
"Connection timeout"	VeloDBウェアハウスとAWS Glueが同じリージョンにあることを確認してください。
データ書き込み後に"Table does not exist"	REFRESH CATALOG catalog_name;を実行してメタデータキャッシュをクリアしてください。