このページでは、BigQuery および BigQuery Data Transfer Service で利用可能なアクセス制御の包括的なリファレンスを提供します。
BigQuery ML のアクセス制御については、BigQuery ML ドキュメントのアクセス制御をご覧ください。
概要
BigQuery は Identity and Access Management（IAM）を使用してリソースへのアクセスを管理します。BigQuery で使用可能なリソースは組織、プロジェクト、データセットの 3 種類です。IAM ポリシー階層では、データセットはプロジェクトの子リソースになります。テーブルとビューはデータセットの子リソースで、親データセットから権限を継承します。
リソースへのアクセスを許可するには、ユーザー、グループ、またはサービス アカウントに 1 つ以上の役割を割り当てます。組織とプロジェクトの役割はジョブの実行またはプロジェクトのリソース管理に関して可能な操作を制御し、データセットの役割は特定のプロジェクト内のデータへのアクセスとその変更に関して可能な操作を制御します。
IAM には、事前定義された役割と基本の役割の 2 種類があります。ある特定のユーザーに事前定義された役割と基本の役割の両方を割り当てると、それぞれの役割の権限を結合したものが付与されます。
権限と役割
事前定義された役割の比較表
BigQuery では次の事前定義された役割を割り当てることができます。
| 機能 | dataViewer |
dataEditor |
dataOwner |
metadataViewer |
user |
jobUser |
admin |
|---|---|---|---|---|---|---|---|
| プロジェクトの一覧表示 / 取得 | |||||||
| テーブルのリスト表示 | |||||||
| テーブル メタデータの取得 | |||||||
| テーブルデータの取得 | |||||||
| テーブルの作成 | |||||||
| テーブルの変更 / 削除 | |||||||
| ルーティンの一覧表示 | |||||||
| ルーティンの定義の取得 | |||||||
| ルーティンの作成 | |||||||
| ルーティンの変更 / 削除 | |||||||
| データセットのメタデータの取得 | |||||||
| 新しいデータセットの作成 | |||||||
| データセットの変更 / 削除 | 自分が作成した データセット |
||||||
| ジョブ / クエリの作成 | |||||||
| ジョブの取得 | 自分が作成した ジョブ |
すべてのジョブ | |||||
| ジョブの一覧表示 | すべてのジョブ（他のユーザーのジョブは詳細が除去されます） | すべてのジョブ | |||||
| ジョブのキャンセル | 自分が作成した ジョブ |
自分が作成した ジョブ |
すべてのジョブ | ||||
| 保存したクエリの取得 / 一覧表示 | |||||||
| 保存したクエリの作成 / 更新 / 削除 | |||||||
| BigQuery Storage API を介した読み取りセッションの作成 | |||||||
| 転送の取得 | |||||||
| 転送の作成 / 更新 / 削除 |
BigQuery の権限
次の表に、BigQuery で使用可能な権限とその説明を示します。
| 権限 | 説明 |
|---|---|
bigquery.jobs.create |
新しいジョブを作成します。 |
bigquery.jobs.listAll |
すべてのジョブを一覧表示し、任意のユーザーが送信した任意のジョブのメタデータを取得します。* |
bigquery.jobs.list |
すべてのジョブを一覧表示し、任意のユーザーが送信した任意のジョブのメタデータを取得します。* 他のユーザーが送信したジョブについては、詳細とメタデータが除去されます。 |
bigquery.jobs.get |
ジョブのデータとメタデータを取得します。* |
bigquery.jobs.update |
ジョブをキャンセルします。* |
bigquery.datasets.create |
新しい空白のデータセットを作成します。 |
bigquery.datasets.delete |
データセットを削除します。 |
bigquery.datasets.get |
データセットに関するメタデータを取得します。 |
bigquery.datasets.update |
データセットのメタデータを更新します。 |
bigquery.tables.create |
新しいテーブルを作成します。 |
bigquery.tables.list |
テーブルとテーブルのメタデータをリスト表示します。 |
bigquery.tables.delete |
テーブルを削除します。 |
bigquery.tables.get |
テーブルのメタデータを取得します。 テーブルのデータを取得するには、 bigquery.tables.getData が必要です。 |
bigquery.tables.getData |
テーブルのデータを取得します。 テーブルのメタデータを取得するには、 bigquery.tables.get が必要です。 |
bigquery.tables.export |
BigQuery からテーブルのデータをエクスポートします。 |
bigquery.tables.update |
テーブルのメタデータを更新します。 |
bigquery.tables.updateData |
テーブルのデータを更新します。 |
bigquery.routines.create |
新しいルーティン（関数とストアド プロシージャ）を作成します。 |
bigquery.routines.list |
ルーティンおよびルーティンに関するメタデータを一覧表示します。 |
bigquery.routines.delete |
ルーティンを削除します。 |
bigquery.routines.get |
ルーティンの定義とメタデータを取得します。 |
bigquery.routines.update |
ルーティンの定義とメタデータを更新します。 |
bigquery.transfers.get |
転送のメタデータを取得します。 |
bigquery.transfers.update |
転送を作成、更新、削除します。 |
bigquery.savedqueries.create |
保存したクエリを作成します。 |
bigquery.savedqueries.get |
保存したクエリのメタデータを取得します。 |
bigquery.savedqueries.list |
保存したクエリの一覧を表示します。 |
bigquery.savedqueries.update |
保存したクエリを更新します。 |
bigquery.savedqueries.delete |
保存したクエリを削除します。 |
bigquery.readsessions.create |
BigQuery Storage API を介した新しい読み取りセッションを作成します。 |
* ジョブを作成すると、ジョブの作成者に、そのジョブの bigquery.jobs.get 権限および bigquery.jobs.update 権限に相当する権限が自動的に付与されます。
メソッドに必要な権限
発信者が各メソッドを呼び出す際に必要となる権限のリストを次の表に示します。
| メソッド | 必要な権限 |
|---|---|
datasets.delete |
bigquery.datasets.deleteデータセット内に、テーブルがある場合は bigquery.tables.delete も必要です。ルーティンがある場合は bigquery.routines.delete も必要です。
|
datasets.get |
bigquery.datasets.get |
datasets.insert |
bigquery.datasets.create |
datasets.list |
返されたデータセットに対する権限を確認するために、bigquery.datasets.get を使用します。
|
datasets.patch |
bigquery.datasets.update |
datasets.update |
bigquery.datasets.update |
jobs.cancel |
bigquery.jobs.updateこの権限なしで自分のジョブをキャンセルできます。 |
jobs.get |
bigquery.jobs.getこの権限なしで自分のジョブを取得できます。 |
jobs.getQueryResults |
bigquery.jobs.getジョブの結果を取得するには、 bigquery.jobs.get 権限を持っているか、ジョブの所有者である必要があります。さらに、ジョブの結果が書き込まれるテーブルの所有者である必要があります。
|
jobs.insert |
bigquery.jobs.create（ジョブを開始する場合）ジョブを完了するには、追加の権限が必要となることがあります。 |
jobs.list |
すべてのユーザーのすべてのジョブを表示する場合は bigquery.jobs.list。他のユーザーが送信したジョブについては、詳細とメタデータが除去されます。allUsers=true パラメータを使用してすべてのユーザーのすべてのジョブの詳細を完全に表示する場合は bigquery.jobs.listAll。 |
jobs.query |
bigquery.jobs.create（ジョブを開始する場合）ジョブを完了するには、追加の権限が必要となることがあります。 |
projects.list |
resourcemanager.projects.get |
tabledata.insertAll |
bigquery.tables.updateData |
tabledata.list |
bigquery.tables.getData |
tables.delete |
bigquery.tables.delete |
tables.get |
bigquery.tables.get |
tables.insert |
bigquery.tables.createこのメソッドでビューを作成する場合、ビューで参照されるすべてのテーブルに対する bigquery.tables.getData 権限も必要です。
|
tables.list |
bigquery.tables.list |
tables.patch |
bigquery.tables.update |
tables.update |
bigquery.tables.updateこのメソッドでビューを更新する場合、ビューで参照されるすべてのテーブルに対する bigquery.tables.getData 権限も必要です。このビューがデータセットに対してすでに承認されている場合、このメソッドではテーブルに関連付けられているすべてのデータセットに対する bigquery.datasets.update も必要です。
|
routines.delete |
bigquery.routines.delete |
routines.get |
bigquery.routines.get |
routines.insert |
bigquery.routines.create |
routines.list |
bigquery.routines.list |
routines.update |
bigquery.routines.update |
projects.transferConfigs.create |
bigquery.transfers.update |
projects.transferConfigs.get |
bigquery.transfers.get |
projects.transferConfigs.patch |
bigquery.transfers.update |
役割
次の表に、Google BigQuery API IAM の役割と、各役割に含まれているすべての権限に対応するリストを示します。各権限は、それぞれ特定のリソースタイプを対象としています。
| 役割 | 含まれている権限 | リソースタイプ |
|---|---|---|
roles/bigquery.metadataViewer |
resourcemanager.projects.get |
組織 |
resourcemanager.projects.list |
組織 | |
bigquery.datasets.get |
データセット | |
bigquery.tables.list |
データセット | |
bigquery.tables.get |
データセット | |
bigquery.routines.list |
データセット | |
bigquery.routines.get |
データセット | |
roles/bigquery.dataViewer |
上記のすべてと次のもの | |
bigquery.tables.getData |
データセット | |
bigquery.tables.export |
データセット | |
roles/bigquery.dataEditor |
上記のすべてと次のもの | |
bigquery.datasets.create |
プロジェクト | |
bigquery.tables.create |
データセット | |
bigquery.tables.delete |
データセット | |
bigquery.tables.update |
データセット | |
bigquery.tables.updateData |
データセット | |
bigquery.routines.create |
データセット | |
bigquery.routines.delete |
データセット | |
bigquery.routines.update |
データセット | |
roles/bigquery.dataOwner |
上記のすべてと次のもの | |
bigquery.datasets.delete |
プロジェクト | |
bigquery.datasets.update |
データセット | |
roles/bigquery.user |
resourcemanager.projects.get |
組織 |
resourcemanager.projects.list |
組織 | |
bigquery.jobs.create |
プロジェクト | |
bigquery.jobs.list |
プロジェクト | |
bigquery.datasets.create |
プロジェクト | |
bigquery.datasets.get |
プロジェクト | |
bigquery.tables.list |
プロジェクト | |
bigquery.routines.list |
プロジェクト | |
bigquery.transfers.get |
プロジェクト | |
bigquery.savedqueries.get |
プロジェクト | |
bigquery.savedqueries.list |
プロジェクト | |
bigquery.readsessions.create |
プロジェクト | |
roles/bigquery.jobUser |
resourcemanager.projects.get |
組織 |
bigquery.jobs.create |
プロジェクト | |
roles/bigquery.readSessionUser |
resourcemanager.projects.get |
組織 |
resourcemanager.projects.list |
組織 | |
bigquery.readsessions.create |
プロジェクト | |
roles/bigquery.admin |
他の役割のすべての権限と次のもの | |
bigquery.jobs.get |
プロジェクト | |
bigquery.jobs.listAll |
プロジェクト | |
bigquery.jobs.update |
プロジェクト | |
bigquery.savedqueries.create |
プロジェクト | |
bigquery.savedqueries.delete |
プロジェクト | |
bigquery.savedqueries.update |
プロジェクト | |
bigquery.transfers.update |
プロジェクト | |
事前定義された役割の詳細
| 事前定義された役割の詳細 | |
|---|---|
|
プロジェクト内でジョブ（クエリを含む）を実行する権限。通常、企業に属するほとんどの個人（データ サイエンティストやアナリスト）にはユーザーの役割を与えます。ユーザーの役割は、自分が所有するジョブの列挙、自分が所有するジョブのキャンセル、プロジェクト内のデータセットの列挙ができます。また、プロジェクト内に新しいデータセットを作成することもできます。作成者には新しいデータセットに対する 根拠: この役割はプロジェクトで作業する権限をデータアクセスから分離します。これはチームメンバーが複数のプロジェクトのデータを照会する場合に役立ちます。ユーザーがデータソースを探すための手段としてデータセットとテーブルの列挙が許可されています。 リソースタイプ:
|
|
プロジェクト内でジョブ（クエリを含む）を実行する権限。jobUser 役割は、自分のジョブに関する情報を取得したり、自分のジョブを取り消したりできます。 根拠: この役割はプロジェクトで作業する権限をデータアクセスから分離します。これはチームメンバーが複数のプロジェクトのデータを照会する場合に役立ちます。この役割では、BigQuery データへのアクセスを許可できません。データへのアクセスが必要な場合には、データセット レベルのアクセス制御を付与してください。 リソースタイプ:
|
|
BigQuery Storage API を介した、プロジェクト内の読み取りセッションを作成、使用する権限。 根拠: この役割はプロジェクトで読み取りセッションを作成する権限をデータアクセスから分離します。ユーザーに リソースタイプ:
|
|
データセットに適用した場合、dataViewer には次の権限が与えられます。
プロジェクトまたは組織レベルで適用した場合、この役割はプロジェクト内のすべてのデータセットを列挙することもできます。ただし、ジョブを実行するためには追加の役割が必要です。 たとえば、あるデータセットに対して bigquery.dataViewer 権限のみを持つユーザーは、データセット内のテーブルとルーティンを一覧表示し、get() API を使用して、テーブルの内容とルーティンの定義を読み取ることだけが可能です。追加の権限がなければデータに対してクエリを実行することはできません。 クエリを実行する権限を持つユーザーの例としては、次のような場合が考えられます。projectA に対する BigQuery ストレージの外部に存在する外部データソースの場合は、これらの非 BigQuery データソースに対する追加の権限が必要となることがあります。 根拠: dataViewer の役割は読み取り専用のデータアクセスを目的とします。dataViewer はデータにアクセスできますが、クエリジョブを発行するためには追加の権限（bigquery.user や bigquery.admin の役割によって付与される権限など）が必要です。dataViewer は料金の発生する操作は実行できません。 リソースタイプ:
|
|
組織レベルやプロジェクト レベルで適用した場合、metadataViewer により次の操作を行う権限が提供されます。
ジョブを実行するには、追加の役割が必要となります。 根拠: metadataViewer 役割は、メタデータに限定したアクセスを目的としています。metadataViewer は、データセットやテーブルにアクセスしてメタデータを表示できますが、クエリジョブを実行するには、追加の権限（bigquery.user 役割によって付与される権限など）が必要です。 リソースタイプ:
|
|
データセットに適用した場合、dataEditor には次の権限が与えられます。
プロジェクトまたは組織レベルで適用した場合、この役割は新しいデータセットを作成することもできます。 根拠: dataEditor 役割は、 リソースタイプ:
|
|
データセットに適用した場合、dataOwner には次の権限が与えられます。
プロジェクトまたは組織レベルで適用した場合、この役割は新しいデータセットを作成することもできます。 根拠: dataOwner 役割は、 リソースタイプ:
|
|
プロジェクト内のすべてのリソースを管理する権限。プロジェクト内のすべてのデータを管理でき、プロジェクト内で実行されている他のユーザーのジョブもキャンセルできます。 根拠: これは最大の権限が与えられる最上位の役割であり、同僚の分析業務をサポートするスーパーユーザーです。 リソースタイプ:
|
カスタムの役割
事前定義された役割に加えて、BigQuery ではカスタムの役割もサポートされています。詳細については、Cloud IAM ドキュメントのカスタムの役割の作成と管理をご覧ください。
サポートされていない権限
次の権限は、組織レベルのカスタム役割にのみ追加できます。プロジェクト以下のレベルでは、これらの権限は効果がありません。
resourcemanager.projects.list
次の権限は下位互換性のない方法で変更される可能性があり、本番環境用途での使用は推奨されません。また、サービスレベル契約（SLA）と非推奨ポリシーの適用対象ではありません。
bigquery.config.getbigquery.config.update
基本の IAM 役割
基本の IAM 役割は、BigQuery の従来の viewer/editor/owner プロジェクト役割と reader/writer/owner データセット役割に直接対応付けられています。
基本の役割からの移行
従来の承認設定に慣れているユーザーのために、基本の役割を組み合わせたものがプロジェクト レベル権限として公開されています（Reader、Writer、Owner）。
互換性を維持するため、従来のデータセット レベル権限は同等の事前定義された役割に直接対応付けられています。
| BigQuery の従来の権限 | 同等の IAM 役割 |
|---|---|
| プロジェクト - 閲覧可能 | 基本の役割 - Viewer |
| プロジェクト - 編集可能 | 基本の役割 - Editor |
| プロジェクト - オーナー | 基本の役割 - Owner |
| データセット - 読み取り | bigquery.dataViewer |
| データセット - 書き込み | bigquery.dataEditor |
| データセット - オーナー | bigquery.dataOwner |
プロジェクトに対する基本の役割
デフォルトでは、プロジェクトへのアクセス権限を付与すると、その中のデータセットにもアクセス権が付与されます。デフォルトのアクセス権限はデータセット単位でオーバーライドできます。プロジェクトの Owner 役割を持つユーザーは、任意のプロジェクト役割を取り消しまたは変更できます。
プロジェクトを作成すると、その作成者に Owner の役割が与えられます。
| 基本の役割 | 可能な操作 |
|---|---|
Viewer |
|
Editor |
|
Owner |
|
プロジェクトに対する基本の役割は Google Cloud Platform Console を使用して付与または取り消します。新しいプロジェクト役割を付与したりプロジェクト役割を取り消したりするには、プロジェクトに対する Owner アクセス権限が必要です。
プロジェクト役割に対するアクセス権限の付与または取り消しを行う方法について詳しくは、プロジェクト メンバーの管理をご覧ください。
データセットに対する基本の役割
データセットに対する基本の役割は、基本の役割からの移行で説明した事前定義された役割と機能的に同等です。
データセット役割を付与できるエンティティ タイプは次のとおりです。
| エンティティ タイプ | API |
|---|---|
| 単一のユーザー（メールアドレスによって識別） | access.userByEmail |
| Google グループ（メールアドレスによって識別） | access.groupByEmail |
| 事前に定義されたユーザーのグループ（すべてのユーザー、データセットを含むプロジェクトに対して同じプロジェクトの役割を持つユーザーのグループなど） | access.specialGroup |
データセットには次の基本の役割が適用されます。
| データセット役割 | 可能な操作 |
|---|---|
READER |
|
WRITER |
|
OWNER |
注: データセットには、 |
新しいデータセットを作成すると、デフォルトのデータセット アクセス権限が次のエンティティに追加されます。データセットの作成時に役割を指定すると、デフォルトの値がオーバーライドされます。
| エンティティ | データセット役割 |
|---|---|
プロジェクトに対する Viewer アクセス権限を持つすべてのユーザー |
READER |
プロジェクトに対する Editor アクセス権限を持つすべてのユーザー |
WRITER |
プロジェクトに対する Owner アクセス権限を持つすべてのユーザー |
例外: ユーザーがクエリを実行すると、キャッシュに保存された結果テーブルを格納するために匿名データセットが作成されます。クエリを実行するユーザーにのみ、匿名データセットに対する |
データセット役割の付与または取り消しを行うには、次のいずれかの方法を使用します。
- BigQuery API で update を使用する
- ウェブ UI でデータセット名の横のプルダウンをクリックし、[共有データセット] をクリックします。
- bq コマンドライン ツールの bq update コマンドを使用する。access フィールドが設定された部分的な dataset リソースを含む JSON ファイルを指定するには、--source フラグを使用します。
サンプル事例
以下に、全員が AnalystGroup という Google グループに属しているデータ サイエンティストのグループにアクセス権を与える例を示します。
データセットのデータへの読み取り / 書き込みアクセス
CompanyProject というプロジェクトに dataset1 と dataset2 が存在します。AnalystGroup1 は dataset1 のみを扱うデータ サイエンティストのグループで、AnalystGroup2 は dataset2 のみを扱うグループです。データ サイエンティストには各自が扱うデータセットのみ対する完全アクセス（クエリ実行のためのアクセス権限を含む）を許可します。
| データセットへの読み取り / 書き込みアクセス | |
|---|---|
| データセット CompanyProject:dataset1 | AnalystGroup1 に dataset1 への WRITER アクセス権を付与します。この役割は事前定義された IAM 役割 bigquery.dataEditor に対応しています。 |
| データセット CompanyProject:dataset2 | AnalystGroup2 に dataset2 への WRITER アクセス権を付与します。この役割は事前定義された IAM 役割 bigquery.dataEditor に対応しています。 |
| プロジェクト CompanyProject | AnalystGroup1 と AnalystGroup2 に CompanyProject への bigquery.user アクセス権を付与します。 |
データセットのレベルでデータ サイエンティストに WRITER アクセス権を付与すると、データセットのテーブル内でデータをクエリできるようになりますが、プロジェクトでのクエリジョブの実行権限は付与されません。アクセス権が付与されたデータセットに対してデータ サイエンティストがクエリジョブを実行できるようにするには、データ サイエンティストのグループに対して、プロジェクト レベルの事前定義された役割 bigquery.user が付与されている必要があります。bigquery.user 役割によって bigquery.jobs.create 権限が付与されます。
または、bigquery.jobs.create 権限を付与するプロジェクト レベルの IAM のカスタム役割に、データ サイエンティストのグループを追加することもできます。
プロジェクトのデータへの完全アクセス
AnalystGroup は BigQuery を駆使するデータ サイエンティストのグループであり、CompanyProject というプロジェクトにおいて BigQuery の使用に関する全責任を負っています。AnalystGroup はメンバー全員にすべてのデータへの読み取り / 書き込み権限を与えようとしています。組織の他のグループでは、BigQuery 以外の Cloud Platform サービスは使用していますが、BigQuery は誰も使っていません。AnalystGroup は BigQuery 以外の Cloud Platform サービスは使用しません。
| プロジェクトのデータへの完全アクセス | |
|---|---|
| プロジェクト CompanyProject | AnalystGroup を事前定義された役割 bigquery.admin に追加する。 |
組織全体にわたる完全アクセス
CompanyA という組織では、Admin1 という名前の特定の人物を全プロジェクトのすべての BigQuery データの管理者にしようとしています。MonitoringServiceAccount は、組織内の全プロジェクトのすべてのテーブルのサイズをモニタリングするサービス アカウントです。
| 組織全体にわたる完全アクセス | |
|---|---|
| 組織 CompanyA |
|
company が、MonitoringServiceAccount の一定サイズを超えたテーブルを縮小して一定期間よりも古いデータを削除すべきだと判断した場合は、MonitoringServiceAccount を事前定義された役割 bigquery.user に追加する必要があります。
同じプロジェクトのデータへの読み取りアクセス
AnalystGroup は CompanyProject というプロジェクトで分析サービスを担当しているデータ サイエンティストのグループです。OperationsServiceAccount は、CompanyProject:AppLogs データセットへの一括読み込みジョブによってアプリケーション ログを BigQuery に読み込むサービス アカウントです。AnalystGroup のメンバーにはログの変更は許可しません。
| 同じプロジェクトのデータへの読み取りアクセス | |
|---|---|
| プロジェクト CompanyProject |
|
| データセット CompanyProject:AppLogs |
|
異なるプロジェクトのデータへの読み取りアクセス
AnalystGroup は CompanyAnalytics というプロジェクトで分析サービスを担当しているデータ サイエンティストのグループです。ただし、AnalystGroup が分析するデータは CompanyLogs という別のプロジェクトに存在します。OperationsServiceAccount は、CompanyLogs プロジェクトの各種データセットへの一括読み込みジョブによってアプリケーション ログを BigQuery に読み込むサービス アカウントです。
AnalystGroup は CompanyLogs プロジェクトにおいてデータの読み取りのみが許可されており、同プロジェクトで追加のストレージを作成したり、クエリジョブを実行したりすることはできません。その代わりに、AnalystGroup のメンバーは CompanyAnalytics プロジェクトを使用して業務を行い、出力を CompanyAnalytics プロジェクトに保持します。
| 異なるプロジェクトのデータへの読み取りアクセス | |
|---|---|
| プロジェクト CompanyLogs |
|
| プロジェクト CompanyAnalytics |
|
プログラムによる役割の操作
次のメソッドを使用して、データセット レベル、
プロジェクト レベル、組織レベルで事前定義された役割をプログラムによって操作できます。
データセットについては、dataset.insert、dataset.update、dataset.patch の各オペレーションにより、access フィールドを使用して個々のデータセットに対する役割をきめ細かく設定できます。
プロジェクト レベルと組織レベルの設定については、organizations.setIamPolicy と projects.setIamPolicy を使用して、IAM 役割に対するユーザーとサービス アカウントの追加や削除を行います。
ご不明な点がありましたら、Google の