注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
このページに記載されているデフォルトロールは、Palantir が提供する初期設定です。管理者がカスタムロールセットを使用して、環境に合わせたカスタム設定を構成している場合があります。
このページでは、Foundry の Iceberg テーブルで実行できることを制御する操作権限について説明します。操作権限は、アクションを許可する前に Foundry が確認する個別の権限です。ロールは、ユーザーに付与できる操作権限の集まりです。操作権限とロールの関係について詳しくは、ロールと操作権限についてを参照してください。
Iceberg テーブルの読み取りと書き込みは、より広範な table:read 操作と table:write 操作によって制御されます。これらの操作は、Iceberg テーブルと仮想テーブルの両方に適用されます。
Iceberg テーブルのメインブランチ保護のサポートはベータ版であり、お使いの環境ではまだ利用できない場合があります。
メインブランチ保護は、テーブルのリソースブランチ保護を指しており、その元となるコードのコードブランチ保護ではありません。
Iceberg テーブルリソースでメインブランチ保護が有効になっている場合、そのテーブルを所有する Foundry Job Spec の外部から変更を加えるには、次の操作権限が必要です。
Foundry は、そのテーブルを作成したパイプラインから Job Spec を自動的に生成します。たとえば、リソースを作成した Pipeline Builder や Python トランスフォームのロジックが該当します。この所有元リソースの外部から変更を加えるには、テーブルのメインブランチ保護をバイパスする追加の昇格権限が必要です。
| 操作権限 | 表示名 | デフォルトロール |
|---|---|---|
iceberg:bypass-branch-protection | ブランチ保護をバイパス | 所有者 |
通常、メンテナンスタスクまたは外部クライアントからブランチ保護されたテーブルに変更を加えるには、この操作権限が必要です。
これらの操作権限は、Iceberg テーブルのメンテナンスタスクを読み書きできるユーザーを制御します。
| 操作権限 | 表示名 | デフォルトロール |
|---|---|---|
iceberg:read-maintenance-tasks | テーブルのメンテナンスタスクを読み取り | 閲覧者 |
iceberg:write-maintenance-tasks | テーブルのメンテナンスタスクを書き込み | 編集者 |
iceberg:write-sql-maintenance-tasks | カスタム SQL メンテナンスタスクを書き込み | 編集者 |
iceberg:write-data-altering-maintenance-tasks | データを変更するメンテナンスタスクを書き込み | 編集者 |
iceberg:schedule-maintenance-tasks | メンテナンスタスク（種類を問わず）に新しいスケジュールを作成 | 編集者 |
3個の write 操作は累積的に必要となります。メンテナンスタスクの書き込みや編集には、常に iceberg:write-maintenance-tasks が必要です。タスクのカテゴリーに応じて、Foundry はさらに、より具体的な iceberg:write-sql-maintenance-tasks 操作と iceberg:write-data-altering-maintenance-tasks 操作も確認します。そのため、ロールから iceberg:write-maintenance-tasks を外すと、そのロールに残りの2個の操作が含まれていても、メンテナンスタスクを作成することは一切できなくなります。
タスクの作成や編集には、基になるテーブルデータの読み取りと書き込みの権限も必要です。ブランチ保護されたテーブルには、メインブランチ保護も適用されます。
次のテーブルは、各種類のタスクの書き込みに必要な操作権限を示しています。
| タスクの種類 | 必要な操作権限 |
|---|---|
| フォームベースのプロシージャ： たとえば、データファイルの書き換えやスナップショットの有効期限切れ | iceberg:write-maintenance-tasks |
| 現在のスナップショットを論理的に変更しないカスタム SQL： たとえば、 CALL system.rewrite_data_files(...) | iceberg:write-maintenance-tasks+ iceberg:write-sql-maintenance-tasks |
| 現在のスナップショットを論理的に変更するカスタム SQL： たとえば、 INSERT、UPDATE、DELETE | iceberg:write-maintenance-tasks+ iceberg:write-sql-maintenance-tasks+ iceberg:write-data-altering-maintenance-tasks |
Foundry は、メインブランチ保護をバイパスする操作権限と、メンテナンスタスクを編集する操作権限を個別に確認します。これにより、ある種類の変更を作成できるユーザーと、その変更を適用できるテーブルを分けて管理できます。
たとえば：
iceberg:write-sql-maintenance-tasks と iceberg:write-maintenance-tasks が必要です。iceberg:bypass-branch-protection が必要です。