データリストを管理する¶
リストの作成に関する考慮事項¶
注釈
これらの考慮事項は、リモート地域でのリストの作成にも適用されます。
データは異なるアカウント間で共有されるため、データコンシューマーは二重引用符で囲まれた識別子を使用せずに、共有データオブジェクトを使用できるはずです( 識別子の要件 を参照)。そのため、テーブル、列、共有名のオブジェクト識別子は、 大文字 で、 英数字 のみを使用する必要があります。
共有データベース内の機密データがコンシューマーアカウントのユーザーに公開されないようにするには、 セキュアオブジェクトを使用したデータアクセスの制御を使用する をご参照ください。
現在コンシューマーアカウントと共有されている共有(つまり、直接共有を介して)は、リストに追加できます。コンシューマーは、共有からデータベースを作成する前に、Data Exchangeウェブインターフェイスでリスト条件に同意する必要があります。
共有を作成したロールのみが、共有をリストに添付できます。
共有は1つのリストのみに添付できます。共有が既にリストに添付されている場合は、そのリストが削除されていても、別のリストに添付することはできません。
新規または変更された無料リストを公開する前に、すべてのサンプルクエリが自動検証され、参照されるオブジェクトが共有に追加され、クエリを正常に実行できるようになります。
データは、法的に共有可能である必要があります(つまり、プロバイダーはデータを所有するか、データを共有する権利を持っている必要がある)。
注釈
データリストまたはデータセット内のデータに対する法律上または契約上の義務が適用される限り、そうしたデータを共有する法律上および契約上の権利があることを確認する必要があります。たとえば、保護された医療情報(PHI)は、パーソナライズされたデータ共有を介してのみ共有できます。そのためには、(1)ユーザーとSnowflake、およびユーザーと PHI を受け取るコンシューマーとの間に署名済みのビジネスアソシエイト契約(BAA)があること、(2)コンシューマーはSnowflakeとの BAA に署名していることを確認する必要があります。また、データ共有を介して個人データを共有できますが、公開されていないデータを共有する場合は、該当する法律上および契約上の権利が必要です。
リモートリージョンでのリストの作成とデータの複製に関する考慮事項¶
リストを公開すると、選択したすべてのリージョンでコンシューマーにリストが表示されます。
リストは自動的に複製されますが、データは複製されません。
無料リストの場合は、リストを公開する前に、選択した各リージョンにデータを複製する必要があります。
パーソナライズされたリストの場合は、コンシューマーのリクエストに応じてデータを複製できます。
複製を設定するための時間を割り当て、関連するコストを理解してください。
リージョンでデータを共有するには、データを複製するためにそのリージョンのアカウントが必要です。アカウントが複数ある場合は、すべてのアカウントが同じ組織に属している必要があります。
リモート地域でリストを公開する場合、組織内のすべてのアカウントがリストのリクエストを実行できるようにするか、個々のアカウントをプロバイダーとして明示的に追加することができます。リストの所有者のみが、リストのリクエストを実行できるユーザーを指定できます。
リージョン間でのデータ共有には、Snowflakeデータ複製関数を利用します。詳細については、 リージョンとクラウドプラットフォーム間で安全にデータを共有する をご参照ください。
コンシューマーがリクエストするまで、データを各地域に複製する必要はありません。
無料リストの場合は、事前に共有をリモートリージョンのリストに関連付けるオプションがあります。これにより、コンシューマーはリクエストを送信せずに即座に共有を取得できます。
リモート地域のリストに添付された共有のリストを表示するには、リストに共有を添付したリモートアカウントからのログインが必要です。
データリストフィールド¶
次の表は、Data Exchangでデータリストを作成および構成するために必要なパラメーターを示しています。
セクション |
フィールド名 |
説明 |
例 |
|---|---|---|---|
基本情報 |
リストタイプ |
リストのタイプ をご参照ください。 |
利用可能な値: 無料、パーソナライズ |
プロファイル |
共有を所有するプロバイダープロファイルの名前。リストを公開する前に、プロバイダープロファイルを作成する必要があります。 |
||
タイトル |
データリストのタイトル。タイトルは110文字以下にする必要があります。 |
郵便番号別の過去の天気。 |
|
サブタイトル |
データリストのサブタイトル。サブタイトルは110文字以下にする必要があります。タイトルとサブタイトルは重複させられません。 |
場所別の過去の気象データ。 |
|
データ更新頻度 |
データが更新される頻度。 |
利用可能な値:ほぼリアルタイム、日次、週次、月次、四半期、年次、なし(静的データ)。 |
|
カテゴリ |
データリストは、簡単に探索できるように分類されています。 |
||
サービス利用規約 |
プロバイダーのウェブサイトに掲載されている掲載条件へのリンク。コンシューマーは、データにアクセスする前に条件に同意します。掲載条件は、無料リストでは必須であり、パーソナライズされたリストではオプションです。 |
|
|
詳細 |
説明 |
共有データセットの説明。説明には次のものを含める必要があります。. (a)データのスケール . (b)テーブル/ビューの説明 . (c)データセットがサンプルかどうか . (d)データディクショナリの場所。 |
ACME は、大企業向けに、カスタマイズされた正確な気象警報を提供する最大手サプライヤーであり、世界中の気象予報、データ、気象コンサルティングサービスの重要な情報源です。このデータは、既存のデータをさらに強化してより深い分析を提供するために使用できる、 US の郵便番号に基づく過去の気象データです。 |
ドキュメントへのリンク |
より詳細なドキュメントが記載されたプロバイダーのウェブサイトページへのリンク。ドキュメントは明確で、Snowflake共有に存在する適切なスキーマオブジェクトを参照する必要があります。標準的なドキュメントだけでは不十分です。 |
|
|
データ |
データベースオブジェクトまたは安全な共有 |
共有したいデータを選択します。このセクションは、無料データリストのみで使用できます。 |
|
ビジネスニーズ |
ビジネスニーズ |
データリストは、簡単に見つけられるよう、ビジネスニーズごとにグループ化されています。. - 最大6つのビジネスニーズをリストのために選択できます。ドロップダウンリストに関連するビジネスニーズが表示されない場合は、カスタムニーズを作成できます。. - 消費者は、ドロップダウンリストで利用可能なビジネスニーズに基づいてリストを簡単に見つけることができます。ただし、追加するカスタムビジネスニーズは含まれず、リストの詳細にのみ表示されます。 |
|
説明 |
データまたはデータサービスがビジネスニーズに対応する方法の説明。 |
||
サンプル SQL クエリ |
タイトル |
コンシューマーがデータを理解するのに役立つクエリの説明的なタイトル。複数の例を追加できます。 |
|
説明(オプション) |
スキーマの名前、サンプルテーブル、フィールド、ユースケースなど、追加の手順を含む例の説明。 |
||
SQL クエリ |
共有の作成に使用するデータベースに対してサンプルクエリをテストします。Snowflakeはクエリを自動検証して、参照されているすべてのオブジェクトが共有に追加され、クエリが正常に実行されるようにします。検証が失敗した場合、理由を含むエラーメッセージが表示されます。失敗した各クエリの横に感嘆符が表示されます。 |
||
利用可能なリージョン |
利用可能なすべてのリージョン または 特定のリージョン |
リストが表示されるリージョン。これらのリージョンにデータを複製する必要があります。利用可能なリージョンのリストは、管理者の再承認なしに、いつでも編集できます。以前に利用可能であったリージョンを削除すると、そのリージョンのコンシューマーはリストを表示できなくなります。 |
データリストの作成と公開¶
Snowsight にサインインします。
In the navigation menu, select Data sharing » External sharing.
Share Data ドロップダウンリストを選択して、データ交換を選択します。
New Listing ダイアログボックスで、コンシューマーに表示されるリストのタイトルを入力し、リスト型を選択します。リストタイプの詳細については、 リストのタイプ をご参照ください。
新しいリストの各セクションを完了します。ドラフトはいつでも保存して、後で完成させることができます。各セクションと関連フィールドの説明については、 リストの構成 をご参照ください。
無料リストの場合、 Data セクションを編集するときに、共有をリストに関連付けるには、
注釈
リストが公開されるまで、ローカル/プライマリアカウントの共有のみに関連付けることができます。リストが公開された後、選択した追加のリージョンの共有に関連付けることができます。
Select Data を選択します。
安全な共有が存在する場合は、共有に移動して選択します。共有が存在しない場合は、目的のデータベースに移動して、共有に追加するデータベースオブジェクトを選択します。
注釈
共有が表示されない場合は、既に別のリストに添付されているか、以前にコンシューマーと共有されています。
Done を選択します。
(オプション)安全な共有のデフォルト名を変更できます。
Save を選択します。
すべてのセクションを完了後、 Publish を選択して、選択したリージョンにリストを公開します。
次の場合、 Publish ボタンはアクティブになりません。
提供されているいずれかのサンプル SQL クエリが検証に失敗する。詳細については、 データリストフィールド をご参照ください。
共有所有者ではありません。
パーソナライズされたリストのリクエストを表示¶
注釈
プロバイダーには、データリクエストを知らせるメール通知が送信されます。Settings タブで、特定のリストのリクエスト通知メールを変更できます。
In the navigation menu, select Data sharing » External sharing.
Requests タブを選択します。フィルタリングのドロップダウンリストを使用して、リクエストをステータス別に表示します。
リモートリージョンでのデータリストに対するコンシューマーのリクエストの承認¶
注釈
パーソナライズされた リストの場合、データはリモートリージョンで自動的に利用できません。プロバイダーは、これらの各リージョンにデータを複製する責任があります。
無料 のリストの場合は、共有をリモートリージョンのリストに事前に関連付けるオプションがあります。これにより、コンシューマーはリクエストを送信せずに即座に共有を取得できます。地域の最初のコンシューマーからリクエストを受け取った後、データを複製してリストに共有を添付することもできます。リストが共有に添付されると、その地域のすべてのコンシューマーは共有に即座にアクセスできます。
選択したプロバイダーアカウントまたは組織内の任意のアカウントのどちらでリストを実行できるかを指定できます。
コンシューマーが別のリージョンにいる場合は、共有をアタッチする前に、各リモートリージョンにあるアカウントへのデータの複製を設定する必要があります。詳細については、 リージョンとクラウドプラットフォーム間で安全にデータを共有する をご参照ください。
In the navigation menu, select Data sharing » External sharing.
Requests タブを選択します。
リスト名の横にある Review を選択します。
Associate Secure Share セクションで、共有を作成するアカウントを選択します。
共有および共有データベースオブジェクトを所有する(またはデータベースオブジェクトを共有に追加できるようにするために必要な権限を持っている)ロールを選択します。
Select Data を選択します。
安全な共有が存在する場合は、共有に移動して選択します。共有が存在しない場合は、目的のデータベースに移動して、共有に追加するデータベースオブジェクトを選択します。
注釈
共有が表示されない場合は、既に別のリストに添付されているか、以前にコンシューマーと共有されています。
Done を選択します。
(オプション)安全な共有のデフォルト名を変更します。
Fulfill Request を選択します。
Tip
リモートリージョンのリクエストを実行するときにエラーが発生する場合は、次の点を考慮してください。
リモートアカウントがプロバイダーとしてMarketplaceに追加されているか。
リモートアカウントは、リストを公開したアカウントと同じ組織の一部か。
ACCOUNTADMIN のロールを使用して新しい共有を作成したか。
添付しようとしている共有に他のコンシューマーを追加したか。
実行済みリストのリクエストの表示¶
Providers who fulfill free or personalized listing requests using Snowsight can view records of consumers added to the share. To view the records, in the navigation menu, select Data sharing » Internal sharing, and select the Shared by your account tab.
これらの記録は、 QUERY_HISTORY ビュー でも利用できます。
データリストを編集する¶
リストの新しいバージョンを公開すると、以前に公開されたリストが上書きされます。以前に利用可能であったリージョンを削除すると、そのリージョンのコンシューマーは共有データセットにアクセスできなくなります。
ACCOUNTADMIN として Snowsight にサインインします。
In the navigation menu, select Data sharing » External sharing » Shared by your account.
更新するリストの名前をクリックします。
リストタイトルの横にある New Draft をクリックします。
更新するセクションの Edit をクリックします。
Publish をクリックします。
データリストの非公開¶
データリストを非公開にしても、共有から削除しない限り、既存のコンシューマーはデータ共有にアクセスできます。新しいコンシューマーはそれを見ることができません。
ACCOUNTADMIN として Snowsight にサインインします。
In the navigation menu, select Data sharing » External sharing » Shared by your account.
非公開にするリストの名前を選択します。
右上の Live ドロップダウンリストから Unpublish を選択します。
データリストの再公開¶
ACCOUNTADMIN として Snowsight にサインインします。
In the navigation menu, select Data sharing » External sharing » Shared by your account.
再公開するリストの名前を選択します。
右上のドロップダウンリストから Re-publish を選択します。
リストを再公開するには Re-publish を選択します。
データリストの削除¶
プロバイダーとしてリストを削除 をご覧ください。