リスティングを管理する

Console

Google Cloud プロジェクトの Analytics Hub API に移動して有効にします。

Analytics Hub API を有効にする

gcloud

gcloud サービス有効化 コマンドを実行します。

gcloud services enable analyticshub.googleapis.com

コンソール

1. Analytics Hub ページに移動します。

   Analytics Hub に移動

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

2. リスティングを作成するデータ エクスチェンジの名前をクリックします。

3. [add_boxリスティングを作成] をクリックします。

4. [リスティングを作成] ページの [表示名] に、リスティングの名前を入力します。

5. 商用リスティングを作成する場合は、[アクセスの連絡先をリクエスト] フィールドに入力する必要があります。サブスクライバーが連絡するためのメールまたは登録フォームの URL を入力する必要があります。

6. 省略可: 次の詳細情報を入力します。

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

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

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

     • プロバイダ名: データセット プロバイダの名前。
     • プロバイダの連絡先担当者: データセット プロバイダの連絡先担当者のメールアドレスまたは URL。

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

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

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

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

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

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

8. [下り（外向き）データ] で、適切な下り（外向き）オプションを選択します。エディション以外のサービスまたは Enterprise Plus エディションのサブスクライバーのみが、下り（外向き）データの制限があるデータをクエリできます。

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

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

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

10. オプション: [ドキュメント] > [マークダウン] セクションでは、データセットで実行できるサンプルクエリや、関連するドキュメントへのリンク、およびサブスクライバーがデータセットを使用するために役立つその他の情報など、追加情報を入力できます。

11. [保存] をクリックします。

API

projects.locations.dataExchanges.listings.create メソッドを使用します。

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

以下を置き換えます。

• PROJECT_ID: リスティングを作成するデータ交換を含むプロジェクト ID。
• LOCATION: データ エクスチェンジのロケーション。Analytics Hub をサポートするロケーションの詳細については、サポート対象のリージョンをご覧ください。
• DATAEXCHANGE_ID: データ エクスチェンジ ID。
• LISTING_ID: リスティング ID。

リクエストの本文で、リスティングの詳細を指定します。 リクエストが成功した場合は、レスポンスの本文にリスティングの詳細が含まれます。

API を使用してリスティングに対して実行できるタスクの詳細については、projects.locations.dataExchanges.listings メソッドをご覧ください。

コンソール

1. Analytics Hub ページに移動します。

   Analytics Hub に移動

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

3. サブスクライバーを追加するリスティングをクリックします。

4. [person権限を設定] をクリックします。

5. プリンシパルを追加するには、[person_add プリンシパルを追加] をクリックします。

6. [新しいプリンシパル] フィールドに、リスティングの種類に基づいて次の詳細情報を追加します。

   • 限定公開リスティングの場合は、アクセス権を付与する ID のメールアドレスを入力します。

   • 公開リスティングの場合は、allAuthenticatedUsers を追加します。

   • Google Cloud ユーザー以外を含むすべてのユーザーが検索できる公開リスティングの場合は、allUsers を追加します。

7. [ロールを選択] で、[Analytics Hub] の上にポインタを置き、リスティングの種類に基づいて、次のいずれかのロールを選択します。

   • 商用リスティングの場合は、Analytics Hub 閲覧者のロールを選択します。このロールにより、ユーザーはリスティングを表示してアクセス権をリクエストできます。

   • 限定公開または商用以外のリスティングの場合は、Analytics Hub サブスクライバーのロールを選択します。このロールにより、ユーザーはリスティングに登録できます。

   詳しくは、Analytics Hub のサブスクライバーと閲覧者のロールをご覧ください。

8. [保存] をクリックします。

API

1. projects.locations.dataExchanges.listings.getIamPolicy メソッドを使用して、リスティング getIamPolicy メソッドがある既存のポリシーを読み取ります。

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:getIamPolicy
   

   次のように置き換えます。

   • PROJECT_ID: プロジェクト ID（例: my-project-1）。
   • LOCATION: リスティングを含むデータ交換の場所。
   • DATAEXCHANGE_ID: データ エクスチェンジ ID。
   • LISTING_ID: リスティング ID。

   Analytics Hub は、レスポンスで現在のポリシーを返します。

2. メンバーとそれに関連するロールを追加または削除するには、テキスト エディタでポリシーを編集します。メンバーを追加するには、次の形式を使用します。

   • user:test-user@gmail.com
   • group:admins@example.com
   • serviceAccount:test123@example.domain.com
   • domain:example.domain.com

   たとえば、roles/analyticshub.subscriber ロールを group:subscribers@example.com に付与するには、次のバインディングをポリシーに追加します。

   {
    "members": [
      "group:subscribers@example.com"
    ],
    "role":"roles/analyticshub.subscriber"
   }
   

3. projects.locations.dataExchanges.listings.setIamPolicy メソッドを使用して、更新したポリシーを書き込みます。リクエストの本文で、前のステップで更新した IAM ポリシーを指定します。

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

   リクエストの本文で、リスティングの詳細を指定します。リクエストが成功した場合は、レスポンスの本文にリスティングの詳細が含まれます。

API を使用してリスティングに対して実行できるタスクの詳細については、projects.locations.dataExchanges.listings メソッドをご覧ください。

Console

1. Analytics Hub ページに移動します。

   Analytics Hub に移動

2. サブスクリプションを管理するリスティングを含むデータ交換名をクリックします。

3. すべてのサブスクライバーを一覧表示するリスティングをクリックします。

4. リスティングのすべてのサブスクライバーを表示するには、[サブスクリプションを管理] をクリックします。

   

5. 省略可: サブスクライバーの詳細で結果をフィルタできます。

また、共有データセットにアクセスできる場合は、次の手順でサブスクライバーを一覧表示します。

1. BigQuery ページに移動します。

   BigQuery に移動

2. [エクスプローラ] ペインでプロジェクトを開き、共有データセットを選択します。

3. person_add [共有] リストで、[サブスクリプションを管理] を選択します。

SQL

次の例では、INFORMATION_SCHEMA.SCHEMATA_LINKS ビューを使用して、us リージョンにある myproject の共有データセットにリンクされているすべてのデータセットを一覧表示します。

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                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

API

projects.locations.dataExchanges.listings.listSubscriptions メソッドを使用します。

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

以下を置き換えます。

• PROJECT_ID: 登録するリスティングのプロジェクト ID。
• LOCATION: 登録するリスティングの場所。
• DATAEXCHANGE_ID: 登録するリスティングを含むデータ エクスチェンジ ID。
• LISTING_ID: 登録するリスティングの ID。

コンソール

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

2. [サブスクリプション] タブをクリックします。

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

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

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

API

projects.locations.subscriptions.revoke メソッドを使用します。

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

次のように置き換えます。

• PROJECT_ID: 削除するサブスクリプションのプロジェクト ID。
• LOCATION: 削除するサブスクリプションの場所。
• SUBSCRIPTION: 削除するサブスクリプションの ID。

コンソール

1. Analytics Hub ページに移動します。

   Analytics Hub に移動

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

3. 更新するリスティングをクリックします。

4. mode_edit [リスティングを編集] をクリックします。

5. フィールドの値を変更します。リスティングのソース データセットを除くすべての値を変更できます。

6. オプション:

   • 一般公開の検出可能性を有効にする場合は、allUsers または allAuthenticatedUsers に Analytics Hub 閲覧者のロール（roles/analyticshub.viewer）を付与します。詳細については、リスティングのロールを付与するをご覧ください。
   • 一般公開の検出可能性を無効にする場合は、allUsers と allAuthenticatedUsers から Analytics Hub 閲覧者のロールを削除します。公開エクスチェンジには非公開リスティングを含めることはできませんが、非公開エクスチェンジには公開リスティングを含めることができます。

7. 変更内容をプレビューするには、[プレビュー] をクリックします。

8. 変更を保存するには、[Save] をクリックします。

API

projects.locations.dataExchanges.listings.patch メソッドを使用します。

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

UPDATEMASK は、更新するフィールドのリストに置き換えます。複数の値を更新するには、カンマ区切りのリストを使用します。リクエストの本文で、更新した値を指定します。

API を使用してリスティングに対して実行できるタスクの詳細については、projects.locations.dataExchanges.listings メソッドをご覧ください。

コンソール

1. Analytics Hub ページに移動します。

   Analytics Hub に移動

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

3. 削除するリスティングをクリックします。

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

5. [リスティングを削除しますか？] ダイアログで「削除」と入力して削除を確定します。

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

API

projects.locations.dataExchanges.listings.delete メソッドを使用します。

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

API を使用してリスティングに対して実行できるタスクの詳細については、projects.locations.dataExchanges.listings メソッドをご覧ください。