データリストの管理

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

このトピックの内容:

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

リストの作成に関する考慮事項

注釈

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

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

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

  • Shares that are currently shared with a consumer account (i.e. via a direct share) can be added to a listing, as long as the same consumer account is also a consumer in the Data Exchange.

  • 共有を作成したロールのみが、共有をリストに添付できます。

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

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

    注釈

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

リモート地域でのリストの作成とデータの複製に関する考慮事項

  • リストを公開するときは、リストを表示したい地域を指定します。リストは、選択した各地域に自動的に複製されます。

  • その地域でリスト(パーソナライズ、または標準)を公開するために、その地域のアカウントを持っている必要はありません。ただし、コンシューマからデータリクエストを受信した後、地域でデータを共有するには、データを複製するためにその地域のアカウントが必要です。アカウントが複数ある場合は、すべてのアカウントが同じ組織に属している必要があります。

  • リモート地域でアカウントを作成する場合、アカウントでデータを共有できるようにするには、アカウントをプロバイダーとしてData Exchangeに追加する必要があります。すべてのリモートアカウントを URLs のリストとともにデータエクスチェンジ管理者に連絡し、リモートアカウントをプロバイダーとして追加してください。

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

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

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

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

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

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

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

  1. (パーソナライズされたリストを作成する場合は、このステップを省略)従来のウェブインターフェイスで共有を作成し、1つ以上のアカウントを共有に追加します。手順については、 安全なデータ共有の開始 をご参照ください。

    ちなみに

    標準のリストでは、共有にアカウントが追加されている場合、その共有は Add Listing に表示されません。

  2. 新しいウェブインターフェイスで、 Manage メニュー項目の Listings タブに移動します。

  3. Create Listing ダイアログボックスで、リストの詳細を入力します。

  4. Publish をクリックして、選択した地域にリストを公開します。公開されたリストは、メンバーがプロバイダーとは異なる地域にある場合でも、指定された地域のData Exchangのすべてのメンバーに対してタイルとして表示されます。

  5. (オプション)共有を公開済みの標準リストに事前に関連付けて、リモート地域のコンシューマーが共有を利用できるようにします。リストに共有を事前に関連付けるには、

    注釈

    共有をリモートアカウントのリストに関連付ける前に、データセットをそのアカウントに複製する必要があります。

    1. 新しいウェブインターフェイスで、リモートアカウントに ACCOUNTADMIN としてログインします。

    2. Manage メニュー項目 » My Listings タブ » <リスト名> » Data セクションに移動します。

    3. データ セクションの横にある鉛筆アイコンをクリックします。

    4. 共有をリストに関連付けます。

データリストフィールド

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

フィールド名

説明

プロバイダープロファイル

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

リストのタイトル

データリストのタイトル。タイトルは80文字以下にする必要があります。

郵便番号による過去の天気

サブタイトル

データリストのサブタイトル。サブタイトルは80文字以下にする必要があります。タイトルとサブタイトルは繰り返し使用しないでください。

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

説明

共有データセットの説明。説明には、(a)最良のユースケース、(b)データの大きさ、(c)テーブル/ビューの説明、(d)データセットがサンプルかどうか、(e)データディクショナリの場所が含まれている必要があります。

ACME は、大企業向けに、カスタマイズされた正確な気象警報を提供する最大手サプライヤーであり、世界中の気象予報、データ、気象コンサルティングサービスの重要な情報源です。このデータは、既存のデータをさらに強化してより深い分析を提供するために使用できる、米国の郵便番号に基づく過去の気象データです。

データの更新

データ更新頻度。

利用可能な値:ほぼリアルタイム、日次、週次、月次、四半期、年次、なし(静的データ)。

ドキュメントへのリンク

より詳細なドキュメントが記載されたプロバイダーのウェブサイトページへのリンク。ドキュメントは明確で、Snowflake共有に存在する適切なスキーマオブジェクトを参照する必要があります。標準的なドキュメントだけでは不十分です。

https://developer.acme.com

リストタイプ

データリストの種類 をご参照ください。

利用可能な値:標準、パーソナライズ

共有名

共有の名前。標準リストの場合、これはData Exchangで公開する共有の名前です。データ共有は、リストを作成して共有を添付するロールが所有している必要があります。

ACME_BENCHMARKS_SHARE

タイトルの例

コンシューマーがデータを理解するのに役立つユースケースのタイトル。右側のナビゲーションを使用して、複数の例を追加できます。

説明

スキーマの名前、サンプルテーブル、フィールド、使用例など、追加の手順を含む例の説明。

サンプルクエリ

コンシューマーがデータを理解するために役立つサンプルクエリまたは画像 URLs。サンプルクエリは、データの興味深い側面を強調する必要があります。サンプルクエリの主要なガイドライン:(a)共有の作成に使用するデータベースに対してサンプルクエリをテストします。データベースに対してクエリをテストする必要があります。自分の共有から新しいデータベースを作成しようとしないでください。自分の共有からデータベースを作成すると、エラーメッセージが表示されます。(b) SQL コメントを使用して、使用するスキーマや、共有に複数のスキーマがあるかどうかなどのガイドラインを提供します。

利用可能な地域

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

利用可能な値:Data Exchangeが利用可能な場所のどこでも、特定のSnowflake地域。

カテゴリ

データリストは、簡単に探索できるように分類されています。

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

注釈

現時点では、プロバイダーにデータリクエストを知らせるメール通知は送信されません。ウェブインターフェイスで定期的にデータリクエストを確認する必要があります。

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

  1. 新しいウェブインターフェイスの左側のメニューで、 Manage リンクをクリックします。

  2. Inbound Requests タブをクリックします。フィルタリングドロップダウンリストを使用して、ステータス別にリクエストを表示します。

リモート地域でのパーソナライズされたリスティングまたは標準リスティングのリクエストの承認

注釈

標準 リストの場合、データはリモート地域で自動的に利用できません。プロバイダーは、これらの各地域にデータを複製する責任があります。 標準 リストの場合は、共有をリモート地域のリストに事前に関連付けるオプションがあります。これにより、コンシューマーはリクエストを送信せずに即座に共有を取得できます。地域の最初のコンシューマーからリクエストを受け取った後、データを複製してリストに共有を添付することもできます。リストが共有に添付されると、その地域のすべてのコンシューマーは共有に即座にアクセスできます。

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

  1. 新しいウェブインターフェイスで、 Data » Manage » Data Exchange » Inbound Requests に移動します。

  2. リクエストの横にある Review ボタンをクリックします。

  3. コンシューマーが別の地域にいる場合、共有をアタッチする前に、

    1. コンシューマーと同じ地域にあるアカウントにログインします。

    2. その地域にアカウントがない場合は、 ORGADMIN のロールを持つユーザーがアカウントを作成します。

    注釈

    • 組織オブジェクトが有効になっていない場合は、Snowflakeに連絡して新しいアカウントを作成するか、独自のアカウントを作成できる組織のプライベートプレビューへの参加をリクエストします。詳細については、 /LIMITEDACCESS/organizations をご参照ください。

    • 組織オブジェクトが有効になっているのに別の地域にアカウントを作成できない場合は、複製のためにアカウントをリンクしてもらうよう、Snowflakeのアカウント担当者にリクエストしてください。

    1. リモート地域でアカウントを作成する場合、アカウントでデータを共有できるようにするには、アカウントをプロバイダーとしてData Exchangeに追加する必要があります。リモートアカウントをプロバイダーとしてData Exchangeに追加するには、すべてのリモートアカウントの URLs のリストをData Exchangeの管理者にお問い合わせください。

    2. プライマリアカウントからこのアカウントへのデータの複製を設定します。詳細については、 地域とクラウドプラットフォーム間で安全にデータを共有する をご参照ください。

    ちなみに

    ORGADMIN のロールを持つユーザーは、次のコマンドを実行して、アカウントの複製を有効にする必要があります。

    -- Assume the ORGADMIN role
    use role orgadmin;
    
    -- View the list of the accounts
    show organization accounts;
    
    -- Enable replication for an account
    SELECT SYSTEM$GLOBAL_ACCOUNT_SET_PARAMETER('<account1_name>',
    'ENABLE_ACCOUNT_DATABASE_REPLICATION', 'true');
    
  4. 共有を作成するには、従来のコンソールリンクの Create a share をクリックします。

  5. 必要に応じて、従来のウェブインターフェイスで新しい共有を作成し、共有にオブジェクトを追加します。手順については、 安全なデータ共有の開始 をご参照ください。

  6. 新しいウェブインターフェイスで、 Review Request ダイアログボックスの Secure Share ドロップダウンリストから、既存の共有または新しく作成した共有を選択します。

    注釈

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

  7. Save をクリックします。共有がリストに関連付けられ、コンシューマーにより利用できるようになります。

ちなみに

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

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

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

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

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

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

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

これらのレコードは QUERY_HISTORY ビュー でも利用できます。

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

データリストの編集

リストの新しいバージョンを公開すると、以前に公開されたリストが上書きされます。以前に利用可能であった地域を削除すると、その地域のユーザーは共有データセットにアクセスできなくなります。

データリストを更新するには、

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

  2. 左側のナビゲーションバーで Manage をクリックします。

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

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

  5. 右上にある 編集と公開 ボタンをクリックします。

データリストの非公開

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

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

  1. 新しいウェブインターフェイスを使用して、アカウント管理者としてData Exchangにログインします。

  2. 左側のメニューで Manage をクリックし、

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

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

  5. リストの公開を取り消すには、 Unpublish をクリックしてください。

データリストの再公開

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

  1. 新しいウェブインターフェイスを使用して、アカウント管理者としてData Exchangにログインします。

  2. 左側のメニューで Manage をクリックします。

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

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

  5. リストを再公開するには、 Re-publish をクリックします。

データ共有の更新

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

  • 列の追加と削除。

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

  • オブジェクトの削除。