データを挿入すると、新しいレコードとデータファイルが Apache Iceberg テーブルに追加されます。
書き込みオペレーションは、テーブルを最初に作成した特定のエンジン(Spark や Trino など)に制限され、 Lakehouse ランタイム カタログ全体でメタデータの整合性が維持されます。
始める前に
テーブルの概要で、 さまざまな種類のテーブルと、それらを使用する場合の影響について確認してください。
-
BigLake API を有効にします。
API を有効にするために必要なロール
API を有効にするには、
serviceusage.services.enable権限を含む Service Usage 管理者 IAM ロール(roles/serviceusage.serviceUsageAdmin)が必要です。詳しくは、ロールを付与する方法をご覧ください。
必要なロール
テーブルにデータを挿入するために必要な権限を取得するには、プロジェクトとストレージ バケットに対する次の IAM ロールを付与するように管理者に依頼してください。
-
認証情報ベンダーモードでテーブルデータを書き込む: BigLake 編集者(
roles/biglake.editor)- プロジェクト -
認証情報ベンダーモード以外でテーブルデータを書き込む:
- BigLake 編集者(
roles/biglake.editor)- プロジェクト - Storage オブジェクト ユーザー(
roles/storage.objectUser)- Cloud Storage バケット
- BigLake 編集者(
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
必要な権限は、カスタム ロールや他の事前定義 ロールから取得することもできます。
テーブルにデータを挿入する
テーブルにサンプルデータを挿入します。
Spark
spark.sql("INSERT INTO TABLE_NAME VALUES (1, \"first row\"), (2, \"second row\"), (3, \"third row\");")
Trino
INSERT INTO TABLE_NAME VALUES (1, 'first row'), (2, 'second row'), (3, 'third row');
次のステップ
- テーブルにクエリを実行する方法を学習する。