リスティングを管理する

Analytics Hub のパブリッシャーは、次の操作を行うことができます。

• 公開アクセス権を付与されているデータ エクスチェンジにリスティングを作成します。
• リスティングの使用状況の指標を更新、削除、共有、表示します。
• 管理者、サブスクライバー、閲覧者など、BigQuery Sharing（旧 Analytics Hub）のリストのさまざまなロールを管理します。
• リスティングに登録しているすべてのサブスクライバーを表示します。
• リスティングの使用量をモニタリングします。
• リスティングからサブスクライバーを削除します。

リスティングは、パブリッシャーがデータ エクスチェンジに掲載する共有データセットへの参照です。リスティングには、そのリスティングに対して設定された Identity and Access Management（IAM）ポリシーと、そのリスティングを含むデータ エクスチェンジの種類に基づいて、次の 2 種類があります。

• 公開リスティング。Google Cloud ユーザー（allAuthenticatedUsers）が検出して登録できます。一般公開データ エクスチェンジのリスティングは、公開リスティングです。これらのリスティングでは、無料の一般公開データセットまたは商用データセットを参照できます。リスティングが商用データセットを参照する場合、サブスクライバーはデータ プロバイダに直接リスティングへのアクセスをリクエストできます。または、Google Cloud Marketplace に統合された商用リスティングをブラウジングして購入することもできます。

• 限定公開リスティング。個人またはグループと直接共有されます。たとえば、限定公開リスティングは、組織内の他の内部チームと共有するマーケティング指標データセットを参照できます。allAuthenticatedUsersがリスティングに登録できるようにしても、リスティングは限定公開のままになり、BigQuery Sharing ページで公開リスティングとして表示されません。このようなリスティングをユーザーと共有するには、リスティングの URL をユーザーと共有します。非公開リスティングを検出可能にするには、エクスチェンジを公開する必要があります。

始める前に

BigQuery Sharing（旧 Analytics Hub）を開始するには、 Google Cloud プロジェクト内で Analytics Hub API を有効にする必要があります。

必要な権限

Analytics Hub API を有効にするには、次の Identity and Access Management（IAM）権限が必要です。

• serviceUsage.services.get
• serviceUsage.services.list
• serviceUsage.services.enable

次の IAM 事前定義ロールには、Analytics Hub API を有効にするために必要な権限が含まれています。

• roles/serviceusage.serviceUsageAdmin

BigQuery での IAM のロールの詳細については、事前定義ロールと権限をご覧ください。

Analytics Hub API を有効にする

Analytics Hub API を有効にする方法は次のとおりです。

gcloud services enable analyticshub.googleapis.com

必要な権限

リスティングとサブスクリプションを管理するには、次のいずれかの Analytics Hub のロールが必要です。

• Analytics Hub パブリッシャーのロール（roles/analyticshub.publisher）。リスティングの IAM ポリシーを作成、更新、削除、設定できます。

• Analytics Hub リスティング管理者のロール（roles/analyticshub.listingAdmin）。このロールでは、リスティングの IAM ポリシーを更新、削除、設定できます。

• Analytics Hub 管理者ロール（roles/analyticshub.Admin）。これにより、データ エクスチェンジのすべてのリスティングで IAM ポリシーを作成、更新、削除、設定できます。

詳細については、Analytics Hub のユーザーロールをご覧ください。これらのロールを他のユーザーに付与する方法については、リスティング管理者を作成するをご覧ください。

さらに、リスティングを作成するには、リスティングを作成するデータセットに対する bigquery.datasets.get 権限と bigquery.datasets.update 権限も付与されている必要があります。次の BigQuery の事前定義ロールには、bigquery.datasets.update 権限が含まれています。

• BigQuery データのオーナーのロール（roles/bigquery.dataOwner）
• BigQuery 管理者ロール（roles/bigquery.admin）

アクセスできる組織内のプロジェクト間のすべてのデータ エクスチェンジを表示するには、resourcemanager.organizations.get 権限が必要です。この権限を含む BigQuery の事前定義ロールはないため、IAM カスタムロールを使用する必要があります。

データ エクスチェンジを表示する

アクセス可能な組織内のデータ エクスチェンジの一覧を表示するには、データ エクスチェンジを表示するをご覧ください。データ エクスチェンジが別の組織にある場合、Analytics Hub 管理者がそのデータ エクスチェンジへのリンクを共有する必要があります。

リスティングを作成する

リスティングは、パブリッシャーがデータ エクスチェンジに掲載する共有デーセットへの参照です。

リスティングを作成する手順は次のとおりです。

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings?listingId=LISTING_ID

データセットからリスティングを作成する

次の手順でデータセットからリスティングを作成することもできます。

1. Google Cloud コンソールで、[BigQuery] ページに移動します。

   [BigQuery] に移動

2. データセットをクリックすると詳細が表示されます。

3. [person_add共有] > [リスティングとして公開] をクリックします。

   [リスティングを作成] ダイアログが開きます。

4. このリスティングを公開するデータ エクスチェンジを選択します。データ エクスチェンジは、データセットと同じリージョンに存在する必要があります。データ エクスチェンジの作成の詳細については、エクスチェンジを作成して権限を設定するをご覧ください。

5. [共有データセット] メニューで、既存のデータセットを選択するか、[データセットを作成] をクリックして新しいデータセットを作成します。データ エクスチェンジに表示するデータセットを選択します。データセットは、データ エクスチェンジと同じリージョンに存在する必要があります。リスティングの作成後にこのフィールドを更新することはできません。

   サブスクライバーがリンクされたデータセットのメタデータを表示すると、データセットを含むプロジェクトのソース データセット名と ID が返されます。

6. [データ下り（外向き）の制御] で、適切な下り（外向き）データ オプションを選択します。

   • 共有データセットにデータ下り（外向き）制限を適用し、共有データセットのクエリ結果には適用しない場合は、[共有データのコピーとエクスポートを無効にする] を選択します。
   • 共有データセットと共有データセットのクエリ結果に下り（外向き）制限を適用するには、[クエリ結果のコピーとエクスポートを無効にする] を選択します。これにより、[共有データのコピーとエクスポートを無効にする] も自動的に設定されます。
   • 共有データセットに Data API のコピーとエクスポートの下り（外向き）制限を適用するには、[API を介したテーブルのコピーとエクスポートを無効にする] を選択します。これにより、[共有データのコピーとエクスポートを無効にする] も自動的に設定されます。

7. [リスティングの詳細] セクションの [表示名] に、リスティングの名前を入力します。

8. 必要に応じて、次の詳細情報を入力します。

   • カテゴリ: リスティングを最もよく表すカテゴリを 2 つまで選択します。サブスクライバーは、これらのカテゴリに基づいてリスティングをフィルタできます。

   • データ アフィニティ: パブリッシャーがデータの公開に使用するリージョン。この情報は、サブスクライバーが同じリージョンからデータを読み取ることで、Pub/Sub ネットワークの下り（外向き）費用を最小限に抑えるか回避するのに役立ちます。下り（外向き）費用の詳細については、データ転送の費用をご覧ください。

   • アイコン: リスティングのアイコン。PNG と JPEG のファイル形式がサポートされています。アイコンのファイルサイズは 512 KiB 未満、サイズは 512 x 512 ピクセル以下である必要があります。

   • 説明: リスティングの簡単な説明。サブスクライバーは、説明に基づいてリスティングを検索できます。

   • 一般公開の検出可能性: BigQuery Sharing カタログ内のリスティングの一般公開の検出可能性を有効にします。このオプションを有効にする場合は、allUsers または allAuthenticatedUsers に Analytics Hub 閲覧者のロール（roles/analyticshub.viewer）を付与します。詳細については、リスティングのロールを付与するをご覧ください。すでに公開されているエクスチェンジの場合、リスティング権限がすでに継承されているため、追加の対応は必要ありません。

     一般に検索可能なエクスチェンジには、権限の継承により非公開リスティングを含めることはできませんが、非公開エクスチェンジには公開リスティングを含めることができます。公開リスティングを作成するには、データ リスティングが含まれているプロジェクトに、関連付けられた組織と請求先アカウントが必要です。Cloud Marketplace 統合の商業リスティングを作成する場合は、リスティングを一般公開することをおすすめします。

   • サブスクライバーのメールのロギング: このリスティングのリンクされたデータセットの使用状況について、サブスクライバー ユーザーのメールを保持します。メールのロギングを有効にして保存すると、この設定は編集できなくなります。メールのロギングを無効にするには、リスティングを削除し、[サブスクライバーのメールのロギング] 切り替えボタン（プレビュー）をクリックせずにリスティングを再作成します。

   • [ドキュメント] > [マークダウン]: 関連するドキュメントへのリンクや、サブスクライバーがトピックを使用するために役立つその他の情報などの追加情報。

9. [リスティングの連絡先情報] セクションで、次のオプションの詳細を入力します。

   • 連絡先担当者: リスティングのメインの連絡先のメール ID または URL を入力します。

   • アクセス権要求の連絡先: サブスクライバーが連絡するためのメール ID または登録フォームの URL を入力します。

   • プロバイダ: [プロバイダ] セクションを展開し、次のフィールドで詳細を指定します。

     • プロバイダ名: プロバイダの名前。
     • プロバイダの連絡先担当者: トピック プロバイダの連絡先担当者のメール ID または URL。

     サブスクライバーはデータ プロバイダに基づいてリスティングをフィルタリングできます。

   • パブリッシャー: [パブリッシャー] セクションを展開し、次のフィールドで詳細を指定します。

     • パブリッシャー名: リスティングを作成しているパブリッシャーの名前。
     • パブリッシャーの連絡先担当者: トピック パブリッシャーの連絡先担当者のメール ID または URL。

10. [リスティングのプレビュー] セクションを確認します。

11. [公開] をクリックします。

リスティングへのアクセス権をユーザーに付与する

ユーザーに非公開リスティングへのアクセスを許可する場合は、そのリスティングに対する個人またはグループの IAM ポリシーを設定する必要があります。商用リスティングの場合、データ エクスチェンジを公開する必要があります。一般公開データ エクスチェンジのリスティングが、すべての Google Cloud ユーザー（allAuthenticatedUsers）の BigQuery Sharing に表示されます。ユーザーが商用リスティングを閲覧してアクセス権をリクエストできるようにするには、ユーザーに Analytics Hub 閲覧者のロールを付与する必要があります。ユーザーが商用リスティングに登録できるようにするには、ユーザーに Analytics Hub サブスクライバーのロールを明示的に付与する必要があります。Cloud Marketplace と統合された商用リスティングの場合、Analytics Hub サブスクライバーのロールは、Cloud Marketplace の注文に基づいて自動的にプロビジョニングされます。

Google Cloudを使用していないユーザーを含むすべてのユーザーがリスティングにアクセスできるようにするには、allUsers に Analytics Hub 閲覧者のロール（roles/analyticshub.viewer）を付与する必要があります。

ユーザーにリスティングの閲覧や登録のアクセス権を与えるには、以下の手順を実施します。

公開リスティングの未認証 URL を作成する

Google Cloud ユーザー以外にも表示できる、認証されていない BigQuery Sharing リスティング URL を作成するには、次の操作を行います。

1. [共有（Analytics Hub）] ページに移動します。

   [共有（Analytics Hub）] に移動

   アクセス可能なすべてのデータ エクスチェンジを示すページが表示されます。

2. リスティングを含むデータ交換名をクリックします。

3. 表示名をクリックすると、リスティングの詳細が表示されます。リスティングで一般公開の検出可能性が有効になっている必要があります。

4. [公開リンクをコピー] をクリックして、未認証のリスティング URL を生成します。このリスティングで、allUsers に Analytics Hub 閲覧者のロール（roles/analyticshub.viewer）が付与されていることを確認します。

リスティング管理者を作成する

ユーザーがリスティングを管理できるようにするには、BigQuery Sharing のリスティング管理者を作成する必要があります。リスティング管理者を作成するには、リスティング レベルで Analytics Hub パブリッシャーまたは Analytics Hub リスティング管理者のロールをユーザーに付与する必要があります。リスティングに対するこれらのロールを付与する方法については、リスティングに対するロールを付与するをご覧ください。

サブスクリプションをすべて見る

リスティングへの現在のすべてのサブスクリプションを表示するには、次のいずれかのオプションを選択します。

SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg                |
| myproject      | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg                |
| myproject      | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:listSubscriptions

サブスクリプションを削除する

2023 年 7 月 25 日より前に作成されたサブスクリプションをリスティングから削除すると、リンクされたデータセットは共有データセットからリンク解除されます。サブスクライバーは自分のプロジェクト内のデータセットを表示できますが、共有データセットにリンクされなくなります。

2023 年 7 月 25 日より前に作成されたサブスクリプションをリスティングから削除する手順は次のとおりです。

1. リスティングのすべてのサブスクライバーを一覧表示するには、すべてのサブスクリプションを表示するに記載されている Google Cloud コンソールの手順を実施します。

2. リスティングからサブスクライバーを削除するには、delete [削除] をクリックします。すべてのサブスクリプションを削除するには、[すべてのサブスクリプションを削除] をクリックします。

3. [サブスクリプションを削除しますか？] ダイアログに「remove」と入力して確定します。

4. [削除] をクリックします。

2023 年 7 月 25 日以降に作成されたサブスクリプションを削除する手順は次のとおりです。

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

リスティングを更新する

リスティングを更新する方法は次のとおりです。

PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID?updateMask=UPDATEMASK

リスティングを削除する

リスティングを削除すると、リスティングンを閲覧できなくなります。リスティングを削除すると、サブスクライバーのプロジェクトからリンクされたすべてのデータセットも削除されます（すべてのサブスクリプションが解除されます）。

リスティングを削除した場合、元に戻すことはできません。リスティングの削除方法は次のとおりです。

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID

注目のセクションにリスティングを表示する

BigQuery Sharing カタログでリスティングの可視性と認知度を高めるには、[注目] セクションにリスティングを表示します。注目のリスティングは、 Google Cloud Partner Advantage 契約に則っています。

BigQuery Sharing カタログの [注目] セクションにリスティングを表示するには、次の条件を満たしている必要があります。

• 共有データは BigQuery に保存されている必要があります。

• Build の指定で Partner Advantage プログラムに登録されている必要があります。

• リスティングが作成され、一般公開の検出可能性が有効になっている必要があります。

リスティングが [注目] セクションに表示されるようリクエストするには、受付フォームに入力して送信してください。セクションからリスティングを削除するようリクエストするには、同じ受付フォームを送信してください。

次のステップ

• BigQuery Sharing のアーキテクチャについて読む
• リスティングを表示して登録する方法について詳細を確認する。
• Analytics Hub のユーザーロールについて確認する。
• データセットの作成について確認する。
• 共有監査ロギングについて確認する。
• 詳しくは、リスティングをモニタリングする方法をご覧ください。