リスティングを表示して登録する
Analytics Hub のサブスクライバーは、アクセス権を付与されているリスティングを表示して登録できます。リスティングに登録すると、プロジェクトにリンクされたデータセットが作成されます。
必要なロール
リスティングを使用するために必要な権限を取得するには、管理者に次の IAM ロールを付与するよう依頼してください。
-
リスティングを検索する: プロジェクトに対する Analytics Hub 閲覧者(
roles/analyticshub.viewer
) -
リスティングに登録する:
-
プロジェクトに対する Analytics Hub サブスクライバー(
roles/analyticshub.subscriber
) -
プロジェクトに対する BigQuery ユーザー(
roles/bigquery.user
)
-
プロジェクトに対する Analytics Hub サブスクライバー(
- リンクされたデータセットを表示する: プロジェクトに対する BigQuery データ閲覧者(
roles/bigquery.dataViewer
) - リンクされたデータセットに対してクエリを実行する: プロジェクトに対する BigQuery データ閲覧者(
roles/bigquery.dataViewer
) - リンクされたデータセットを更新する: プロジェクトに対する BigQuery データ編集者(
roles/bigquery.dataEditor
) - テーブルのメタデータを表示する: プロジェクトに対する BigQuery データ閲覧者(
roles/bigquery.dataViewer
) -
リンクされたデータセットを削除: プロジェクトに対する BigQuery 管理者(
roles/bigquery.admin
)
ロールの付与の詳細については、アクセスの管理をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
これらの事前定義ロールには、このドキュメントのタスクを実行するために必要な権限が含まれています。データセットの作成とクエリに必要な権限を確認するには、[必要な権限] セクションを開きます。
必要な権限
- 新しいデータセットを作成する: データセットに対して追加のアクションを実行するための
bigquery.datasets.create
またはbigquery.datasets.*
。 - データセットに対してクエリを実行する: ジョブに対して追加のアクションを実行するための
bigquery.jobs.create
またはbigquery.jobs.*
。
カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。
リスティングを検索する
一般公開リスティングと限定公開リスティングを紹介する手順は次のとおりです。
Google Cloud コンソールで [BigQuery] ページに移動します。
[エクスプローラ] ペインで、
[データを追加] をクリックします。[データを追加] ダイアログで、[Analytics Hub] をクリックします。アクセス可能なリスティングを含む [Analytics Hub] ダイアログが表示されます。
または、[Analytics Hub] ダイアログを開くには、Analytics Hub に移動し、[リスティングを検索] をクリックします。
リスティングの名前または説明でフィルタリングするには、[リスティングを検索する] フィールドにリスティングの名前または説明を入力します。
[フィルタ] セクションで、次のフィールドに基づいてリスティングをフィルタリングできます。
リスティング: 限定公開リスティング、一般公開リスティング、組織内のリスティングのどれを表示するかを選択します。
カテゴリ: 目的のカテゴリを選択します。
ロケーション: 目的のロケーションを選択します。詳細については、サポートされているリージョンをご覧ください。
プロバイダ: データ プロバイダを選択します。一部のデータ プロバイダでは、商用データセットへのアクセス権をリクエストする必要があります。アクセス権をリクエストすると、データ プロバイダからデータセットを共有するよう求められます。
フィルタしたリスティングを参照します。
リスティングに登録する
リスティングに登録すると、プロジェクトにリンクされたデータセットを作成することによって、リスティング内のデータに対する読み取り専用権限が付与されます。
リスティングに登録するには、次の操作を行います。
コンソール
アクセス可能なリスティングのリストを表示するには、リスティングを表示するの手順に沿って操作します。
リスティングを参照し、登録先のリスティングをクリックします。リスティングの詳細情報を含むダイアログが表示されます。
商用データセットを参照するリスティングなど、リスティングに登録するためのアクセス権を付与されていない場合は、[アクセスをリクエスト] をクリックします。登録可能なデータセットをクリックした場合は、[データセットをプロジェクトに追加] をクリックして [リンクされたデータセットを作成] ダイアログを開きます。
プロジェクトで Analytics Hub API が有効になっていない場合は、API を有効にするリンクを含むエラー メッセージが表示されます。[Analytics Hub API を有効にする] をクリックします。
[リンクされたデータセットを作成] ダイアログで、次の詳細を指定します。
- プロジェクト: データセットを追加するプロジェクトの名前を指定します。
- リンクされたデータセット名: リンクされたデータセットの名前を指定します。
変更を保存するには、[保存] をクリックします。リンクされたデータセットがプロジェクトに表示されます。
API
projects.locations.dataExchanges.listings.subscribe
メソッドを使用します。
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:subscribe
次のように置き換えます。
PROJECT_ID
: 登録するリスティングのプロジェクト ID。LOCATION
: 登録するリスティングの場所。DATAEXCHANGE_ID
: 登録するリスティングのデータ交換 ID。LISTING_ID
: 登録するリスティング ID。
リクエストの本文で、リンクされたデータセットを作成するデータセットを指定します。成功すると、レスポンスの本文は空になります。
リンクされたデータセットを表示する
リンクされたデータセットは、他のデータセットとともに Google Cloud コンソールに表示されます。
プロジェクト内のリンクされたデータセットを表示するには、次の手順で操作します。
コンソール
Google Cloud コンソールで [BigQuery] ページに移動します。
[エクスプローラ] パネルで、 リンクされたデータセットを含むプロジェクト名をクリックします。
または、Data Catalog を使用して、リンクされたデータセットを検索して表示することもできます。述部 type=dataset.linked
を使用すると、Analytics Hub にあるすべてのリンクされたデータセットを照合できます。詳細については、Data Catalog の検索構文をご覧ください。
Cloud Shell
次のコマンドを実行します。
PROJECT=<your project ID> \ for dataset in $(bq ls --project_id $PROJECT | tail +3); do [ "$(bq show -d --project_id $PROJECT $dataset | egrep LINKED)" ] && echo $dataset; done
リンクされたデータセットに対してクエリを実行する
他の BigQuery テーブルに対してクエリを実行するのと同じ方法で、リンクされたデータセット内のテーブルとビューに対してクエリを実行できます。
リンクされたデータセットを更新する
リンクされたデータセット内のリソースは読み取り専用です。リンクされたデータセット内のリソースのデータまたはメタデータを編集する、または個々のリソースに対する権限を指定することはできません。
リンクされたデータセットの説明とラベルのみ更新できます。リンクされたデータセットを変更しても、ソース データセットと共有データセットには影響しません。
リンクされたデータセットの説明とラベルを更新するには、次の手順に沿って操作します。
Google Cloud コンソールで [BigQuery] ページに移動します。
[エクスプローラ] パネルでプロジェクト名をクリックし、リンクされたデータセットをクリックします。
アクション オプションを開いて、[開く] をクリックします。
[詳細] パネルで、
[詳細を編集] をクリックして、次の詳細を指定します。- ラベルを追加するには、データセットへのラベルの追加をご覧ください。
照合を有効にするには、[詳細オプション] セクションを開いて、次の操作を行います。
- [デフォルトの照合を有効にする] を選択します。
- [デフォルトの照合] リストからオプションを選択します。
[保存] をクリックします。
テーブルのメタデータを表示する
基盤となるテーブルのメタデータを表示するには、INFORMATION_SCHEMA.TABLES
ビューに対してクエリを実行します。
SELECT * FROM `LINKED-DATASET.INFORMATION_SCHEMA.TABLES`
LINKED-DATASET は、リンクされたデータセットの名前に置き換えます。
リンクされたデータセットを削除
Analytics Hub パブリッシャーによってサブスクリプションが削除された場合、リンクされたデータセットは共有データセットからリンク解除されます。リンクが解除されたデータセットに対するクエリは実行できないため、リンクが解除されたデータセットは削除できます。
リンクされたデータセットを削除しても、ソース データセットは削除されません。削除したリンクされたデータセットは取得できません。ただし、リスティングに登録してデータセットをプロジェクトに追加することで、再作成できます。
リンクされたデータセットを削除するには、次の手順に沿って操作します。
Google Cloud コンソールで [BigQuery] ページに移動します。
[エクスプローラ] パネルでプロジェクト名をクリックし、リンクされたデータセットをクリックします。
アクション オプションを開き、[削除] をクリックします。
[リンクされたデータセットを削除しますか?] ダイアログで「削除」と入力して削除を確定します。
[削除] をクリックします。
次のステップ
- Analytics Hub について確認する。
- リスティングの管理について詳細を確認する。
- データ交換の管理について確認する。
- Analytics Hub の監査ロギングについて確認する。