テーブルの作成

Apache Iceberg テーブルを作成すると、テーブル メタデータが Lakehouse ランタイム カタログの Namespace に登録されます。

サポートされている表の形式

Apache Iceberg V2 テーブルのみがサポートされています。Iceberg V1 テーブルは対象外です。既存の Iceberg V1 テーブルがある場合は、登録または使用する前に、V2 にアップグレードする必要があります（たとえば、ALTER TABLE catalog.schema.table SET TBLPROPERTIES ('format-version'='2'); を実行するか、同様のエンジン オペレーションを使用します）。

テーブルの作成時に名前空間またはテーブルレベルで明示的なストレージの場所を指定しない場合、システムは、名前空間とテーブルの識別子を追加して、カタログのデフォルトの場所（カタログのベースとなる Cloud Storage バケットから派生）の下にテーブルのメタデータとデータ ディレクトリを自動的に作成します。

クエリエンジンの統合に加えて、Lakehouse ランタイム カタログはオープンソースの Iceberg REST Catalog API 仕様（POST /v1/{prefix}/namespaces/{namespace}/tables）を実装しているため、互換性のある REST クライアントでテーブルを直接作成できます。

始める前に

さまざまなタイプのテーブルと、それらを使用した場合の影響については、テーブルの概要をご覧ください。

1. Google Cloud プロジェクトに対して課金が有効になっていることを確認します。

2. BigLake API を有効にします。

   API を有効にするために必要なロール

   API を有効にするには、serviceusage.services.enable 権限を含む Service Usage 管理者 IAM ロール（roles/serviceusage.serviceUsageAdmin）が必要です。詳しくは、ロールを付与する方法をご覧ください。

   API の有効化

必要なロール

テーブルの作成に必要な権限を取得するには、プロジェクトとストレージ バケットに対する次の IAM ロールを付与するよう管理者に依頼してください。

• すべて:
  • BigLake 管理者（roles/biglake.admin）- プロジェクト
  • ストレージ管理者（roles/storage.admin） - ターゲット Cloud Storage バケット

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

テーブルを作成する

Iceberg テーブルを作成します。

spark.sql("CREATE TABLE NAMESPACE_NAME.TABLE_NAME (id int, data string) USING ICEBERG;")

spark.sql("DESCRIBE NAMESPACE_NAME.TABLE_NAME").show()

CREATE TABLE SCHEMA_NAME.TABLE_NAME (id int, data varchar);

DESCRIBE SCHEMA_NAME.TABLE_NAME;

POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables

次のステップ

• テーブルを一覧表示する方法を学習する。
• テーブルにデータを挿入する方法をご覧ください。