リストの構成¶
リスト を作成する場合、コンシューマーが使用できるようにする前に、リストの追加フィールドを完了する必要があります。
リストを使用する方法や、コンシューマーがデータ製品にアクセスする方法によっては、一部のセクションやフィールドがオプションになる場合があります。
リストを構成したら、コンシューマーに公開します。 リストの公開 をご参照ください。
このトピックの内容:
基本情報¶
リストに関する基本情報を完了します。次のテーブルでは、 Basic Information セクションのフィールドについて説明します。
フィールド名 |
説明 |
例 |
|---|---|---|
Title |
リストのタイトル。コンシューマーがリストを表示すると、プロバイダーの社名の下にタイトルが表示されます。 タイトルが承認されるには、次の特性を備えている必要があります。
|
郵便番号別の過去の天気。 |
Subtitle |
コンシューマーの目に留まるように、データ製品に関する簡潔で有益な説明を提供します。 サブタイトルは100文字以下にする必要があります。サブタイトルは、文頭だけを大文字にし、タイトルとは異なるものにします。 このオプションは、プライベートリストでは利用できません。 |
場所別の過去の気象データ。 |
Category |
カテゴリは、コンシューマーが Snowflake Marketplace でデータまたはアプリを見つけるのに役立ちます。使用可能な値のドロップダウンリストから目的のカテゴリを選択します。選択できるカテゴリは1つだけです。 このオプションは、プライベートリストでは利用できません。 |
環境 |
Terms of Service |
リスト利用規約 - リストのサービス契約へのリンクを指定します。コンシューマーは、リストにアクセスする前にリスト規約に同意する必要があります。すべてのリストにはリスト規約が必要です。 次のいずれかを選択します。
|
Custom、 |
詳細¶
リストの詳細を完了します。
注釈
プライベートリストの場合、このセクションはオプションです。
次のテーブルでは、 Details セクションで使用可能なフィールドについて説明します。
フィールド名 |
説明 |
例 |
|---|---|---|
Description |
リストで共有されているデータ製品の説明。説明文は、コンシューマーがデータ製品の内容を理解するのに役立ちます。 250～6000文字の間で説明を入力し、段落の間に改行を入れます。 箇条書きではなくダッシュを使用します。説明には、データセットの範囲など、データ製品に関する情報を含む導入段落を含める必要があります。 サービスまたはセキュア関数を含むリストについては、コンシューマーがサービスまたはセキュア関数にアクセスするために想定されるワークフローを説明に含める必要があります。 説明には、リストのデータソースや、他のフィールドに含まれていない追加情報を含めることもできます。 |
ACME は、大企業向けに、カスタマイズされた正確な気象警報を提供する最大手サプライヤーであり、世界中の気象予報、データ、気象コンサルティングサービスの重要な情報源です。このリストには、 US の郵便番号の過去の気象データが含まれており、既存のデータをさらに強化してより詳細な分析を提供するために使用できます。 期待されるワークフロー:
|
Link to Documentation |
リストのより詳細なドキュメンテーションがある会社ウェブサイトのページへのリンク。ドキュメントは明確で、リストに関連付けられたデータ共有または Snowflake Native App に存在する適切なスキーマオブジェクトを参照する必要があります。リンクはインターネット上でアクセスできる必要があり、アクセスするための認証は必要ありません。 |
|
Link to Video |
リストの非公開または公開 YouTube 動画へのリンク。プライベート動画はサポートされていません。動画のサムネイルはリストの詳細ページに表示され、動画は自動再生されません。 Tip リストの詳細ページに表示する動画を作成する際は、次の点に注意してください。
|
データ製品¶
リスト用のデータ製品（安全な共有または Snowflake Native App）を構成します。
オブジェクトを選択し、Snowflakeに安全な共有を作成させることも、すでに作成した共有を追加することもできます。有料リストのシェアを作成するガイダンスについては、 リスト用の共有の準備 をご参照ください。
リストにデータ製品を追加する場合は、次を考慮してください。
安全な共有は1つのリストのみに添付できます。
リストが公開された後に別の共有を添付することはできません。
現在のロールが所有する共有のみを表示できます。
データ製品は、法的に共有可能である必要があります（つまり、データを所有するか、データを共有する権利を持っている必要あり）。
リストが公開されるまで、ローカル/プライマリアカウントの共有のみに関連付けることができます。リストが公開された後、選択した追加のリージョンの共有に関連付けることができます。
次のテーブルでは、 Data Product セクションで使用可能なフィールドについて説明します。
フィールド名 |
説明 |
|---|---|
データベースオブジェクトまたは安全な共有 |
リストの一部として共有するデータ。 |
データ製品 - データディクショナリ¶
データ製品をリストに追加した後、データディクショナリを追加できます。データディクショナリは、データ製品をアカウントにインストールする前に、 Snowflake Marketplace で提供される無料または有料のリストのコンテンツと構造に関する洞察をコンシューマーに提供します。
注釈
プライベートリストの場合、このセクションはオプションです。
データディクショナリについて¶
データディクショナリを使用して、リストのコンテンツをコンシューマーに表示することができます。データディクショナリは、リスト内のテーブルおよびビューに対して生成されます。リストには、データディクショナリデータプレビューと呼ばれるデータのプレビューを含めることもできます。
データの表示方法には次の2つがあります。
注目のオブジェクト: コンシューマーがオブジェクトのコンテンツをすばやく表示できるようにします。リスト内の最も重要なデータベースオブジェクトを最大5つ選択できます。
すべてのオブジェクト: コンシューマーがリスト内のすべてのオブジェクトを表示できるようにします。リストを公開すると自動生成されます。
データディクショナリデータプレビューでは、プロバイダーとコンシューマーの両方が、リストに関連するテーブルやビューのデータをプレビューできます。
プレビューはデータの代表的なサンプルを提供し、次を可能にします。
プロバイダーはプレビューで利用できるデータを正確に確認できます。
コンシューマーはリストに探しているデータが含まれているかどうかを判断することができます。
注釈
リストのデータは自動的にプレビューできるようになります。プロバイダーはプレビューを有効にするために特別なことをする必要はありません。
リストのデータディクショナリのセットアップ¶
データディクショナリを追加する前に、リストにデータ製品を追加する必要があります。 Snowflake Marketplace で提供されるすべてのリストには、データディクショナリを含める必要があります。
データディクショナリを設定するには、次を実行します。
Snowsight にサインインします。
ナビゲーションメニューで Data Products » Provider Studio » Listings を選択します。
データディクショナリを追加するリストを検索して選択します。
Save and Create Data Dictionary を選択します。
注釈
この共有を保存することにより、ユーザーはSnowflakeが共有用のデータディクショナリと関連するプレビューを作成し、リストが公開されるとコンシューマーに表示することを許可することに同意することになります。
データディクショナリデータのプレビューは、基になるデータが変更されると自動的に更新されることに注意してください。
データ製品に PII またはその他の個人データが含まれている場合は、それらの列を個人データとしてマスクしてください。PII およびその他の個人データをマスクする方法などの詳細については、 データプレビューでの PII とその他のデータのマスク をご参照ください。
リストを保存すると、データディクショナリが表示され、リスト内のすべてのテーブル、ビュー、および関数がリストされます。
注目のオブジェクトに含めるオブジェクトを検索または選択して、 Add to featured を選択します。
オプションで、このステップを繰り返して、注目のオブジェクトをさらに追加します。1つのリストに最大5つの注目のオブジェクトを設定できます。
Save を選択します。
Provider Studioでは、テーブルの列の説明を編集するか、 SQL を使用できます。 CREATE <object> と ALTER <object> コマンド、または COMMENT コマンドで COMMENT パラメーターを使用して、オブジェクトや 個別のテーブル列 を説明するコメントを追加できます。
データプレビューでの PII とその他のデータのマスク¶
SnowflakeはData Previewに対して データ分類 を定期的に実行し、 PII (個人識別用情報)やその他の個人データを含む可能性が高い列を特定してマスクします。個人データには以下のような、特定または識別可能な個人に関する情報が含まれます：
氏名、年齢、メールアドレスまたは住所
学歴または職歴
位置データやデバイスのアクティビティ
顧客記録やアカウント情報
Snowflakeが PII 列を識別してマスクすると、詳細を確認するためにプロバイダープロファイルに記載されているテクニカル関連連先にメールが送信されます。いつでも、Data Previewの PII 列を手動で選択したり選択解除したりできます。
PII の分類結果を表示または修正するには、以下を行います:
Snowsight にサインインします。
ナビゲーションメニューで Data Products » Provider Studio を選択します。
上部のナビゲーションから Listings を選択します。まだリストを作成していない場合は、 リストの作成および公開 の説明に従って作成します。
レビューするリストを選択します。
Data Dictionaryで、 Edit を選択します。
レビューするテーブルまたはビューを選択します。
分類結果を確認します。PII またはその他の個人データを含む列は、 "PIIを含む"に分類されます。
Data Preview タブを選択すると、マスクされたデータを含むオブジェクトのコンテンツをプレビューできます。
列が正しく識別されない場合:
列が PII を含むと誤って認識された場合は、 Name 列の左側にあるチェックボックスの選択を解除して、その列のデータがData Previewでマスクされないようにします。
列に PII が含まれているが、そのように識別されない場合は、 Name 列の左にあるチェックボックスを選択し、その列のデータがData Previewでマスクされるようにします。
Save を選択します。
データ分類に同意する場合は、 Save を選択します。
注釈
データプレビューのコンテンツは、データディクショナリがリストで有効になっている場合に生成されます。データが生成されている間、個々のテーブルやビューのプレビューデータはすぐに利用できない場合があります。
注釈
Provider Studioで PII として選択された列が、コンシューマー向けリストにマスクされて表示されるまでに、最大3～4時間かかることがあります。
データプレビューのリフレッシュ¶
リスト内のオブジェクトを追加または削除する場合、またはオブジェクトのスキーマを変更する場合、有効になっていれば、関連するデータプレビューがリフレッシュされます。オブジェクトデータをリフレッシュしても、データプレビューはリフレッシュされません。
注釈
データプレビューはおよそ数時間ごとに自動的にリフレッシュされます。オブジェクトの追加や削除、スキーマのリフレッシュの直後には、リフレッシュされたプレビューが表示されないことがあります。既存のオブジェクト内のデータ(例えば、テーブルの行)が更新されても、スキーマの変更や新しいオブジェクトが追加されていない場合は、データプレビューがすぐには更新されません。この場合、データプレビューは次回の週ごとの更新時にはじめて更新されます。
データ製品 - 属性¶
データ製品を指定した後にリストの追加属性を定義できます。
注釈
プライベートリストの場合、このセクションはオプションです。
次のテーブルでは、データ製品の Attributes セクションで使用可能なフィールドについて説明します。
フィールド名 |
説明 |
|---|---|
Update Frequency |
Snowflakeでデータ製品が更新される頻度データ製品の更新頻度が異なる場合は、データ製品に最も高い更新頻度を選択します。 |
Geographic Coverage |
データ製品の対象となる1つまたは複数の地理的なリージョンを選択します。該当する場合は、特定の国または米国の州を選択します。 |
Geographic Granularity |
データセットの地理的範囲としてグローバルまたは複数の州または国を指定する場合は、データ製品の粒度を選択します。 オプションは1つしか選択できないため、データ製品で使用可能な最も詳細なオプションを選択します。 |
Time Range |
データ製品の対象期間を指定します。カスタム日付は、固定時間範囲（2020-01-01 - 2021-01-01）または動的時間範囲（次の/過去のX日、週、月、年）として指定できます。 |
Timestamp Granularity |
時間範囲を指定する場合は、データ製品のタイムスタンプの粒度を選択します。 オプションは1つしか選択できないため、データ製品で最も詳細なタイムスタンプタイプを選択します。 |
Additional attributes （オプション） |
コンシューマーに伝える追加情報。データの追加属性は 4 つまで含めることができます。読みやすさを最大限に高めるために、各属性に2～5語を使用します。各属性は80文字未満である必要があります。 |
アクセスと料金 - リストへのアクセス¶
Snowflake Marketplace で提供されているリストについては、リストの Listing Access を表示し、リストがまだドラフトの場合は修正できます。
リストへのアクセスは、コンシューマーがデータ製品にアクセスする方法を制御します。詳細については、 リストのアクセスオプション をご参照ください。
アクセスと料金 - トライアル¶
Snowflake Marketplace で提供される限定トライアルリストのトライアルを追加します。有料リストにトライアルを追加するには、 アクセスと料金 - 料金とトライアル をご参照ください。
注釈
このオプションは、限定トライアルリストに必要です。
次のテーブルでは、 Trial セクションで使用可能なフィールドについて説明します。
フィールド |
説明 |
|---|---|
Trial Type |
提供するトライアルの種類を選択します。
リストにデータ製品としてアプリケーションパッケージが含まれている場合、他の2つのトライアルタイプから選択することもできます。
注意 SYSTEM$IS_LISTING_TRIAL システム関数を使用して、アプリの機能を制限する必要があります。 機能制限トライアルを選択し、アプリケーションパッケージが共有データコンテンツまたはアプリケーションロジックで機能を制限するように設定されていない場合、アプリはトライアルの顧客にフル機能を提供します。 機能限定トライアルを完全に設定する方法については、 トライアルコンシューマー向けにSnowflakeネイティブアプリ機能を制限 をご参照ください。 |
アクセスと料金 - 料金とトライアル¶
このセクションで、有料リストの料金プランとトライアルを追加します。
このセクションは、 Snowflake Marketplace で提供する有料リストには必須ですが、試用は有料のプライベートリストではオプションです。
注釈
アカウント管理者（ACCOUNTADMIN ロールを持つユーザー）またはリストの所有者（リストに対する OWNERSHIP 権限を持つロール）のみがこのセクションを完了することができます。
次のテーブルでは、 Trial & Pricing セクションで使用可能なフィールドについて説明します。
フィールド |
説明 |
|---|---|
Pricing Plan |
リストの料金プランを選択します。 有料リストの料金モデル をご参照ください。料金は US ドル表記のみです。 |
Free Trial |
リストの試用タイプを選択します。
|
ビジネスニーズ¶
コンシューマーに役立つデータ製品のビジネスニーズを追加します。
注釈
プライベートリストの場合、このセクションはオプションです。
次のテーブルでは、 Business Needs セクションで使用可能なフィールドについて説明します。
フィールド名 |
説明 |
例 |
|---|---|---|
Business Need |
データ製品が対応する関連ビジネスニーズを特定することで、コンシューマーがリストを Snowflake Marketplace で見つけられるようにします。関連するビジネスニーズは6個まで選択できます。 ドロップダウンリストに関連するビジネスニーズが表示されない場合は、2～4 個の単語を使用してカスタムビジネスニーズを作成できます。ただし、コンシューマーは、 Snowflake Marketplace でカスタムビジネスニーズによるフィルター処理はできません。 ビジネスニーズのリストは、承認のためにリストを再提出することなく、いつでも編集できます。 |
位置データの強化 |
Description |
顧客のユースケースまたはビジネスニーズに固有の例を使用して、選択したビジネスニーズにリストがどのように対応しているかの説明。 各ビジネスニーズに一意の説明を追加します。 |
位置データの強化: 特定の郡、国勢調査区、または中核統計地域に関連する郵便番号をすべて特定します。 |
サンプル SQL クエリ¶
データ製品から価値を引き出すため、または少なくともデータ製品がSnowflakeアカウントに正常にインストールされたことを確認するために、コンシューマーが使用できる有効なサンプル SQL クエリを指定できます。
注釈
Snowflake Marketplace にリストを公開するには、1つ以上の有効な SQL クエリが必要です。3～4個のサンプルクエリを含めることをお勧めします。
プライベートリストを公開する場合は、 SQL クエリはオプションです。
サンプル SQL には次の要件があります。
クエリは少なくとも1行を返す必要がある。
クエリは明示的に共有にあるオブジェクトを参照する必要がある。
オブジェクトは
SCHEMA.OBJECTを使用して修飾する必要がある。データベース名は含めないでください。たとえば、EXAMPLE_SCHEMA.TABLE_Aです。
Add を選択して SQL クエリを1つ追加します。次のテーブルでは、 Sample SQL Queries セクションで使用可能なフィールドについて説明します。
フィールド名 |
説明 |
例 |
|---|---|---|
Title |
コンシューマーがデータ製品の使用方法を理解できるようにする、クエリの説明的なタイトル。 |
屋外イベントが雨の影響を受ける可能性があるかどうかを判断します。 |
Description (Optional) |
タイトルとデータ製品の具体的なユースケースを結びつける例の説明。データ製品をインストールした後にコンシューマーがサンプルクエリを実行すると、説明がコメントとして自動的に読み込まれます。スキーマ、サンプルテーブル、フィールドの名前など、追加の指示を含めることもできます。 SQL でテーブルとビューを参照する場合は、<スキーマ>.<テーブル> 形式を使用します。 コンシューマーはリストを取得するときにカスタムデータベースを取得できるため、クエリにはデータベース名を含めないでください。 |
今後7日以内に屋外イベントを開催する場合は、予報データを使用して、イベントが雨の影響を受けるかどうかを判断します。 |
SQL Query |
サンプルの SQL クエリのコード。クエリはタイトルと説明に直接答える必要があります。 Snowflakeは、サンプルクエリを自動的に検証します。有効にするためには、サンプルクエリが少なくとも1つの行を返す必要があります。 クエリが検証に失敗した場合はリストを保存できますが、すべてのサンプルクエリが正常に検証されるまで、リストを公開することはできません。SQL クエリの検証に使用するウェアハウスを選択する必要があります。 |
利用可能なリージョン（Marketplaceリストのみ）¶
次のテーブルでは、 Region Availability セクションで使用可能なフィールドについて説明します。
フィールド名 |
説明 |
|---|---|
Region Availability |
デフォルトでは、リストは All regions で利用できます。すべてのリージョンを選択すると、Snowflakeによって今後追加されるリージョンのリストを利用できます。有料リストの場合、このオプションを選択すると、 サポートされているリージョン と、Snowflakeによって追加される今後サポートされるリージョンでリストを利用できるようになります。 リストに特定のリージョン制限がある場合は、 All regions を選択して利用可能なリージョンを Custom regions に変更し、データ製品を提供するリージョンを選択します。カスタムリージョンを選択すると、リストはすべての Snowflake Marketplace リージョンに表示されますが、コンシューマーは指定したリージョンでのみデータ製品を取得できます。 |
Fulfillment method |
Automatic 複製はデフォルトで選択されています。クロスクラウドの自動複製を使用すると、データ製品は自動的にリージョンに複製され、そのリージョンでコンシューマーの需要がある場合にのみコストが発生します。 自動複製を使用する場合は、コンシューマーと共有されるデータ製品を更新する更新頻度も選択する必要があります。8日間以下の更新頻度を選択する必要があります。データ製品が Snowflake Native App の場合、アカウントレベルでのみ更新頻度を設定できます。 自動複製の詳細については、 クロスクラウド自動複製の構成 をご参照ください。 自動複製を使用できない場合は、 Manual を選択してデータ製品を手動で複製します。リクエストを満たすには、コンシューマーの需要があるリージョンでアカウントを設定し、製品を各アカウントに手動で複製し、各アカウントで安全な共有を作成し、それらの共有をこのリストに関連付ける必要があります。 リストのリクエストに対応するために手動でデータを複製します をご参照ください。 |
コンシューマーアカウント（プライベートリストのみ）¶
特定のコンシューマにリストを公開するには、共有するアカウントのアカウント識別子を指定する必要があります。
フィールド名 |
説明 |
例 |
|---|---|---|
Consumer Accounts |
プライベートリストを共有するSnowflakeアカウントを指定します。Snowflakeアカウント識別子または URLs を使用できます。詳細については、 アカウントの組織名とアカウント名の検索 をご参照ください。 |
|
アカウントとは異なるリージョンにあるコンシューマーアカウントと共有している場合は、自動複製も設定する必要があります。
フィールド名 |
説明 |
|---|---|
Auto-fulfillment |
データ製品の複製間隔と頻度を選択します。たとえば、2時間ごとに複製するように構成できます。データ製品がアプリケーションパッケージの場合、アカウントレベルでのみ更新頻度と間隔を設定できます。 |
詳細については、 クロスクラウド自動複製の構成 をご参照ください。