リストの構成¶
リスト を作成する場合、コンシューマーが使用できるようにする前に、リストの追加フィールドを完了する必要があります。
リストを使用する方法や、コンシューマーがデータ製品にアクセスする方法によっては、一部のセクションやフィールドがオプションになる場合があります。
リストを構成したら、コンシューマーに公開します。 リストの公開 をご参照ください。
このトピックの内容:
基本情報¶
リストに関する基本情報を完了します。次のテーブルでは、 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が共有用のデータディクショナリを作成し、コンシューマーに表示する権限に同意します。
リストを保存すると、データディクショナリが表示され、リスト内のすべてのテーブル、ビュー、および関数がリストされます。
注目のオブジェクトに含めるオブジェクトを検索または選択して、 Add to featured を選択します。
オプションで、このステップを繰り返して、注目のオブジェクトをさらに追加します。1つのリストに最大5つの注目のオブジェクトを設定できます。
Save を選択します。
Provider Studioでは、テーブルの列の説明を編集するか、 SQL を使用できます。 CREATE <object> と ALTER <object> コマンド、または COMMENT コマンドで COMMENT パラメーターを使用して、オブジェクトや 個別のテーブル列 を説明するコメントを追加できます。
データ製品 - 属性¶
データ製品を指定した後にリストの追加属性を定義できます。
注釈
プライベートリストの場合、このセクションはオプションです。
次のテーブルでは、データ製品の 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 |
提供するトライアルの種類を選択します。
|
アクセスと価格 - 価格とトライアル¶
このセクションで、有料リストの料金プランとトライアルを追加します。
このセクションは、 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時間ごとに複製するように構成できます。データ製品がアプリケーションパッケージの場合、アカウントレベルでのみ更新頻度と間隔を設定できます。 |
詳細については、 クロスクラウド自動複製の構成 をご参照ください。