データリストの管理

承認されたデータプロバイダーになると、Snowflake Data Marketplaceへのデータリストの追加を開始できます。

Snowflake Data Marketplaceに送信された各データリストは、Snowflakeのレビューと承認プロセスを通過する必要があります。

データプロバイダーはデータリストを作成し、承認のために送信します。Snowflake Data Marketplaceに複数のリストがある場合、各リストは個別に承認プロセスを通過する必要があります。

リストが承認されると、Snowflake Data Marketplaceで公開できます。リストが拒否された場合は、フィードバックコメントを確認し、リストを更新して、承認のために再送信します。

承認済みのリストを編集する場合は、承認のために再送信する必要があります。例外は リージョン可視性 セクションで、追加の承認なしにいつでも編集できます。

データリストがスムーズに送信され、拒否がトリガーされないようにするために、リストの メタデータ が要件を満たしていることを確認します。

このトピックの内容:

リストと共有を操作するために必要な許可

タスク

必要な許可

リストの詳細/メタデータの変更

このタスクを実行するには、リストに対する OWNERSHIP または MODIFY 権限がロールに必要です。

リストの表示

このタスクを実行するには、リストに対する OWNERSHIP、 MODIFY、または USAGE 権限がロールに必要です。

リストへの共有の添付

タスクを実行するには、ロールに次のものが必要です。 . - 共有の OWNERSHIP、 および . - リストに対する OWNERSHIP または MODIFY 権限。

ロールに必要なアクセス許可の組み合わせがないときに、共有でこれらのタスクを実行すると失敗します。

ロールの詳細については、 Snowflake MarketplaceまたはData Exchangeにおける、他のロールへのプロバイダー権限を付与 をご参照ください。

データリストを作成する際の考慮事項

データリストを作成する際の一般的な考慮事項

注釈

これらの考慮事項は、リモートリージョンでのリストの作成にも適用されます。

  • データは異なるアカウント間で共有されるため、データコンシューマーは二重引用符で囲まれた識別子を使用せずに、共有データオブジェクトを使用できるはずです( 識別子の要件 を参照)。そのため、テーブル、列、共有名のオブジェクト識別子は、 大文字 で、 英数字 のみを使用する必要があります。

  • 共有データベース内の機密データがコンシューマーアカウントのユーザーに公開されないようにするには、 セキュアオブジェクトを使用したデータアクセスの制御 をご参照ください。

  • 現在コンシューマーアカウントと共有されている共有(つまり、直接共有を介して)は、リストに追加できます。コンシューマーは、共有からデータベースを作成する前に、Snowflake Data Marketplaceウェブインターフェイスのリスト条件に同意する必要があります。

  • 共有の所有者のみが、共有をリストに添付できます。データ共有の権限の詳細については、 他のロールに権限を付与 をご参照ください。

  • 共有は1つのリストのみに添付できます。共有が既にリストに添付されている場合は、そのリストが削除されていても、別のリストに添付することはできません。

  • 新規または変更された標準リストを承認または公開する前に、すべてのサンプルクエリが自動検証され、参照されるオブジェクトが共有に追加され、クエリを正常に実行できるようになります。

  • データは、法的に共有可能である必要があります(つまり、プロバイダーはデータを所有するか、データを共有する権利を持っている必要がある)。

    注釈

    データリストまたはデータセット内のデータに対する法律上または契約上の義務が適用される限り、そうしたデータを共有する法律上および契約上の権利があることを確認する必要があります。たとえば、保護された医療情報(PHI)は、パーソナライズされたデータ共有を介してのみ共有できます。そのためには、(1)ユーザーとSnowflake、およびユーザーと PHI を受け取るコンシューマーとの間に署名済みのビジネスアソシエイト契約(BAA)があること、(2)コンシューマーはSnowflakeとの BAA に署名していることを確認する必要があります。また、標準データ共有またはパーソナライズされたデータ共有の両方を介して個人データを共有できますが、公開されていないデータを共有する場合は、該当する法律上および契約上の権利が必要です。

  • リストとデータ共有は、Snowflakeの プロバイダーポリシー に準拠している必要があります。

リモートリージョンでデータリストを作成する際の考慮事項

  • リストを公開すると、選択したすべてのリージョンでコンシューマーにリストが表示されます。

  • リストは自動的に複製されますが、データは複製されません。

  • 標準のリストの場合は、リストを公開する前に、選択した各リージョンにデータを複製する必要があります。

  • パーソナライズされたリストの場合は、コンシューマーのリクエストに応じてデータを複製できます。

  • 複製を設定するための時間を割り当て、関連するコストを理解してください。

  • リージョンでデータを共有するには、データを複製するためにそのリージョンのアカウントが必要です。アカウントが複数ある場合は、すべてのアカウントが同じ組織に属している必要があります。

  • リモート地域でリストを公開する場合、組織内のすべてのアカウントがリストのリクエストを実行できるようにするか、個々のアカウントをプロバイダーとして明示的に追加することができます。リストの所有者のみが、リストのリクエストを実行できるユーザーを指定できます。

  • リージョン間でのデータ共有には、Snowflakeデータ複製関数を利用します。詳細については、 地域とクラウドプラットフォーム間で安全にデータを共有する をご参照ください。

  • コンシューマーがリクエストするまで、データを各地域に複製する必要はありません。

  • 標準のリストの場合は、共有をリモート地域のリストに事前に関連付けるオプションがあります。これにより、コンシューマーはリクエストを送信せずに即座に共有を取得できます。

  • リモート地域のリストに添付された共有のリストを表示するには、リストに共有を添付したリモートアカウントからのログインが必要です。

新しいデータリストの作成

データリストの作成と公開

標準またはパーソナライズされたデータリストを作成するには、

  1. 新しいSnowflakeウェブインターフェイスで、 Data » Manage » Snowflake Data Marketplace » My Listings に移動します。

  2. 新しいリスト ボタンをクリックします。

  3. New Listing ダイアログボックスで、コンシューマーに表示されるリストのタイトルを入力し、リスト型を選択します。リスト型の詳細については、 データリストの種類 をご参照ください。

  4. 新しいリストの各セクションを完了します。ドラフトはいつでも保存して、後で完成させることができます。各セクションと関連フィールドの説明については、 データリストフィールド をご参照ください。

    標準のリストの場合、 Data セクションを編集するときに、共有をリストに関連付けるには、

    注釈

    リストが公開されるまで、ローカル/プライマリアカウントの共有のみに関連付けることができます。リストが公開された後、選択した追加のリージョンの共有に関連付けることができます。

    1. Select Data をクリックします。

    2. 安全な共有が存在する場合は、共有に移動して選択します。共有が存在しない場合は、目的のデータベースに移動して、共有に追加するデータベースオブジェクトを選択します。

      注釈

      共有が表示されない場合は、既に別のリストに添付されているか、以前にコンシューマーと共有されています。

    3. Done をクリックします。

    4. (オプション)安全な共有のデフォルト名を変更できます。

    5. Save をクリックします。

  5. すべてのセクションを完了すると、 Submit for Approval ボタンがアクティブになり、承認のためにリストを送信できます。

    次の場合、 Submit for Approval ボタンはアクティブになりません。

    • 提供されているいずれかのサンプル SQL クエリが検証に失敗する。詳細については、 データリストフィールド をご参照ください。

    • 共有所有者ではありません。

  6. リストがSnowflakeによってレビューされると、状態は Approved または Denied に変わります。リストが拒否された場合は、コメントで提供されたフィードバックに基づいてリストを更新し、承認のために再送信します。

    Snowflake Data Marketplaceプロバイダーは、リストが承認または拒否されたときに通知されます。メール通知は、リストに関連付けられたプロバイダープロファイルの Business ContactTechnical Contact の両方のメールアドレスに送信されます。

    詳細については、 プロバイダープロファイルフィールド をご参照ください。

  7. リストが承認されたら、 Data » Manage » Snowflake Data Marketplace » My Listings に移動します。

  8. 承認されたリストを選択します。

  9. Publish Listing をクリックして、選択したリージョンにリストを公開します。承認されたリストは、自動的には公開されません。

データリストフィールド

次のテーブルは、Snowflake Data Marketplaceでデータリストを作成および構成するために必要なパラメーターを示しています。

セクション

フィールド名

説明

基本情報

リスト型

データリストの種類 をご参照ください。リストを公開すると、リストの種類と安全な共有を変更することはできません。

使用可能な値: 標準 / パーソナライズ

プロファイル

共有を所有するプロバイダープロファイルの名前。リストを公開する前に、プロバイダープロファイルを作成する必要があります。

タイトル

データセットのタイトル。リストのタイトルは110文字を超えることはできませんが、タイトルは40~60文字の間にすることをお勧めします。すべての主要な単語は大文字にする必要があります(つまり、タイトルケース形式に従います)。 . タイトルは、リストタイルの会社名の下に表示され、一意である必要があります(つまり、他のリストとは異なる必要があります)。 . データのサブセットを紹介するために 標準 リストを使用し、コンシューマーが完全なデータセットを要求できるようにするために パーソナライズされた リストを使用する場合は、異なるものの関連するタイトルで2つのリストを識別できるようにします。たとえば、 標準 リストの場合は <タイトル-デモ>、 パーソナライズされた リストの場合は<タイトル>です。 . 他のパーソナライズされたリストを紹介するために使用される標準のリストでは、 -デモ または -サンプル のサフィックスを使用する必要があります。 . 期間限定で利用可能な標準リストでは、 -試用版 のサフィックスを使用する必要があります。

郵便番号別の過去の天気。

サブタイトル

データリストのサブタイトル。サブタイトルは110文字を超えることはできず、サブタイトルの最初の単語のみを大文字にする必要があります。タイトルとサブタイトルは重複させられません。

場所別の過去の気象データ。

データ更新頻度

データが更新される頻度。使用可能な値のドロップダウンリストから目的の頻度を選択します。

カテゴリ

データリストは、簡単に探索できるように分類されています。使用可能な値のドロップダウンリストから目的のカテゴリを選択します。

サービス利用規約

プロバイダーのウェブサイトでホストされているプロバイダーのサービス利用規約へのリンク。コンシューマーは、データにアクセスする前に条件に同意します。サービス利用規約は、標準のリストでは必須であり、パーソナライズされたリストではオプションです。

https://www.acme.com/en/legal

詳細

説明

共有データセットの説明。説明は250から6000文字の間にあり、段落の間に改行を入れます。箇条書きの代わりにダッシュを使用します。説明には次を含める必要があります。 . (a)データのスケールを含む導入段落 . (b)含まれるテーブル/ビューの説明 . (c)主要なデータフィールド . データエンリッチメントとサービスリストの場合、説明には、コンシューマーがサービスやセキュア関数にアクセスするために期待されるワークフローを含める必要があります。説明には、オプションで、他の入力フィールドでカバーされていないソースまたは追加情報を含めることができます。

ACME は、大企業向けに、カスタマイズされた正確な気象警報を提供する最大手サプライヤーであり、世界中の気象予報、データ、気象コンサルティングサービスの重要な情報源です。このデータは、 US 郵便番号別の過去の気象データであり、既存のデータをさらに強化してより詳細な分析を提供するために使用できます。 . 含まれるサンプル/表: . - 2016年から現在までの過去の日次気象データ . - 15日間の日次気象予報データ . - 15年間の日次気候学データ(気象統計、つまり平均、標準、頻度など) . 含まれるフィールド: . - 日付 . - 郵便番号 . - 国 . - 最低、最高、平均気象統計(気温、降水量、風、湿度など)

ドキュメントへのリンク

より詳細なドキュメントが記載されたプロバイダーのウェブサイトページへのリンク。ドキュメントは明確で、共有に存在する適切なスキーマオブジェクトを参照する必要があります。リンクはアクセス可能である必要があり、ログイン画面の背後でロックされていない必要があります。

https://developer.acme.com

データ

データベースオブジェクトまたは安全な共有

共有するデータ。このセクションは、標準のデータリストのみで使用できます。

ビジネスニーズ

ビジネスニーズ

データリストは、簡単に見つけられるよう、ビジネスニーズごとにグループ化されています。 . - 最大6つのビジネスニーズをリストのために選択できます。ドロップダウンリストに関連するビジネスニーズが表示されない場合は、カスタムニーズを作成できます。 . - コンシューマーは、ドロップダウンリストで利用可能なビジネスニーズに基づいてリストを簡単に見つけることができます。ただし、追加するカスタムビジネスニーズは含まれず、リストの詳細にのみ表示されます。 . - 管理者の承認を得るためにリストを再送信しなくても、いつでもビジネスニーズのリストを編集できます。

説明

データまたはデータサービスがビジネスニーズに対応する方法の説明。

サンプル SQL クエリ

タイトル

コンシューマーがデータを理解するのに役立つクエリの説明的なタイトル。複数の例を追加できます。

屋外イベントが雨の影響を受けるかどうかを判断します。

説明(オプション)

スキーマの名前、サンプルテーブル、フィールド、ユースケースなど、追加の手順を含む例の説明。SQL でテーブルとビューを参照するときは<スキーマ>.<テーブル>形式を使用し、クエリにはデータベース名を 含めません

7日以内に屋外イベントを開催する場合は、予測データを利用して、イベントが雨の影響を受ける可能性があるかどうかを判断します。

SQL クエリ

共有の作成に使用するデータベースに対してサンプルクエリをテストします。Snowflakeはクエリを自動検証して、参照されているすべてのオブジェクトが共有に追加され、クエリが正常に実行されるようにします。検証が失敗した場合、理由を含むエラーメッセージが表示されます。失敗した各クエリの横に感嘆符が表示されます。

利用可能なリージョン

利用可能なすべてのリージョン または 特定のリージョン

リストが表示されるリージョン。これらのリージョンにデータを複製する必要があります。利用可能なリージョンのリストは、管理者の承認のためにリストを再提出することなく、いつでも編集できます。以前に利用可能であったリージョンを削除すると、そのリージョンのコンシューマーはリストを表示できなくなります。

既存のデータリストの管理

パーソナライズされたリストのリクエストの表示

パーソナライズされたリストのリクエストを表示するには、

  1. 新しいウェブインターフェイスの左側のメニューで、 Data » Manage » Snowflake Data Marketplace に移動します。

  2. Consumer Requests タブをクリックします。

コンシューマーデータリクエストの承認

注釈

コンシューマーが別のリージョンにいる場合は、共有をアタッチする前に、リモートリージョンにあるアカウントへのデータの複製を設定する必要があります。詳細については、 地域とクラウドプラットフォーム間で安全にデータを共有する をご参照ください。

  • パーソナライズされた リストの場合、データはリモートリージョンで自動的に利用できません。プロバイダーは、これらの各リージョンにデータを複製する責任があります。

  • 標準 リストの場合:

    • 共有をリモートリージョンのリストに事前に関連付けるオプションがあります。これにより、コンシューマーはリクエストを送信せずに即座に共有を取得できます。

    • データを複製したり、リージョンの最初のコンシューマーからリクエストを受け取った後、リストに共有を添付したりすることもできます。リストが共有に添付されると、そのリージョンのすべてのコンシューマーは共有に即座にアクセスできます。

  • 選択されたプロバイダーアカウント、または組織内にある任意のアカウントのどちらでリストを実行できるかを指定できます。

コンシューマーが送信したデータリストのリクエストを承認するには、

  1. 新しいウェブインターフェイスの左側のメニューで、 Data » Manage » Snowflake Data Marketplace に移動します。

  2. Consumer Requests タブをクリックします。

  3. 保留中のリクエストのリスト名をクリックします。

  4. Associate Secure Share セクションで、共有を作成するアカウントを選択します。

  5. 共有および共有データベースオブジェクトを所有するロール、またはデータベースオブジェクトを共有に追加できるようにするために必要な権限を持っているロールを選択します。

  6. Select Data をクリックします。

  7. 安全な共有が存在する場合は、その共有に移動して選択します。共有が存在しない場合は、目的のデータベースに移動して、共有に追加するデータベースオブジェクトを選択します。

    注釈

    共有が表示されない場合は、既に別のリストに添付されているか、以前にコンシューマーと共有されています。

  8. Done をクリックします。

  9. (オプション)安全な共有のデフォルト名を変更します。

  10. Fullfill Request をクリックします。

    ちなみに

    リモートリージョンのリクエストを実行するときにエラーが発生する場合は、次の点を考慮してください。

    • リモートアカウントがプロバイダーとしてMarketplaceに追加されているか。

    • リモートアカウントは、リストを公開したアカウントと同じ組織の一部か。

    • ACCOUNTADMIN のロールを使用して新しい共有を作成したか。

    • 添付しようとしている共有に他のコンシューマーを追加したか。

実行済みリストのリクエストの表示

新しいSnowflakeユーザーインターフェイスを使用して標準またはパーソナライズされたリストのリクエストを実行するプロバイダーは、従来のユーザーインターフェイスの » History タブで、共有に追加されたコンシューマーの記録(ALTER SHARE ステートメント)を表示できます。 Include client-generated statements チェックボックスを選択する必要があります。詳細については、 履歴ページを使用してクエリを監視 をご参照ください。

これらの記録は、 QUERY_HISTORY ビュー でも利用できます。

公開されたデータリストの編集

公開されたデータリストを編集する場合は、

  • データリストを編集するたびに、新しいドラフトが作成されます。コンシューマーが変更内容を利用できるようになる前に、リストを承認のために送信し、再公開する必要があります。

  • 利用可能なリージョンおよびビジネスニーズのフィールドの編集に承認は必要ありません。いつでも変更できます。

  • 以前に利用可能であったリージョンを削除すると、そのリージョンのコンシューマーは共有データセットにアクセスできなくなります。

  • リストが承認されたら、それを公開してコンシューマーが利用できるようにする必要があります。

  • リストの新しいバージョンを公開すると、以前に公開されたリストが上書きされます。

データリストを編集するには、

  1. ACCOUNTADMIN として、Marketplaceの新しいウェブインターフェイスにログインします。

  2. 左側のナビゲーションバーで、 Data » Manage » Snowflake Data Marketplace の順にクリックします。

  3. Listings タブをクリックします。

  4. 更新するリストの名前をクリックします。

  • リストを利用できるリージョンを追加または削除する場合は、 Region Availability セクションの Edit をクリックします。管理者の承認は必要ないため、残りのステップはスキップできます。

  • リストの説明など、他のフィールドを変更するには、該当するセクションの Edit をクリックし、プロンプトが表示されたら Continue を選択します。これにより、送信、承認、公開されるまでコンシューマーに表示されない新しいドラフトが生成されます。

  • 既存の変更が作業中の場合は、リストタイトルの横にある New Draft トグルを選択して、既存のドラフトの作業を続行します。ページの右上にある Delete ボタンを選択すると、このドラフトを破棄できます。

  1. レビューのために新しいドラフトを送信する準備ができたら、 Submit for Approval をクリックします。

データリストの非公開

データリストを非公開にしても、共有から削除しない限り、既存のコンシューマーはデータ共有にアクセスできます。新しいコンシューマーは、削除されたリストを表示できません。

データリストを非公開にするには、

  1. 左側のナビゲーションバーで、 Data » Manage » Snowflake Data Marketplace の順にクリックします。

  2. Listings タブをクリックします。

  3. 非公開にするリストの名前をクリックします。

  4. 右上の Live ドロップダウンリストから Unpublish を選択します。

データリストの再公開

データリストが再公開される場合、リストが変更されていない限り、承認は必要ありません。

データリストを再公開するには、

  1. 左側のナビゲーションバーで、 Data » Manage » Snowflake Data Marketplace の順にクリックします。

  2. Listings タブをクリックします。

  3. 再公開するリストの名前をクリックします。

  4. 右上のドロップダウンリストから Publish Listing を選択します。

データ共有の更新

Snowflakeの従来のウェブインターフェイスを使用して、データ共有を更新できます。データリストを変更するたびに、プロセスを中断しないようにコンシューマーに通知する必要があることに注意してください。

重大な変更の例は次のとおりです。

  • 列の追加と削除

  • オブジェクトの名前の変更

  • オブジェクトの削除