リスト機能の構成¶
このトピックでは、リストに対して構成できる機能のフィールドについて説明します。有料リスト、プライベートリスト、Marketplaceリストのいずれを提供するかによって、入力するフィールドは異なります。
リストを構成したら、リストを公開します。 リストの公開 をご参照ください。
このトピックの内容:
基本情報¶
次のテーブルでは、 Basic Information セクションで使用可能なフィールドについて説明します。
フィールド名 |
説明 |
例 |
---|---|---|
Type |
リストのタイプ。リストを作成して共有を追加した後に、リストのタイプを変更することはできません。 |
利用可能な値: Free、 Personalized、または Paid。 |
Publishing as |
リストをコンシューマーに公開するために使用されるプロバイダープロファイル。リストを公開する前に、プロバイダープロファイルを作成する必要があります。 リストのプロバイダーになる をご参照ください。 |
|
Title |
リストのタイトル。リストのタイトルは110文字を超えることはできませんが、タイトルは40~60文字の間にすることをお勧めします。すべての主要な単語は大文字にする必要があります(つまり、タイトルの表記法に従います)。 タイトルは、リストタイルの会社名の下に表示されます。タイトルは一意(つまり、他のリストとは異なる)にする必要があります。 データのサブセットを紹介する Free リストや、コンシューマーが完全なデータセットをリクエストできるようにする Personalized リストなど、同様のリストを提供する場合は、類似してはいても異なるタイトルを使用します。この例では、 - Sample を Free リストのタイトルに追加できます。 Snowflake Marketplace で他のリストを紹介するために無料リストを提供する場合は、 - Demo または - Sample のサフィックスを使用します。 期間限定の無料リストを提供する場合は、 - Trial サフィックスを使用します。 このオプションは、無料(またはプラットフォーム外の有料)のプライベートリストでは利用できません。 |
郵便番号別の過去の天気。 |
Subtitle |
リストのサブタイトル。サブタイトルは110文字以下にする必要があります。サブタイトルは、文頭だけを大文字にし、タイトルとは異なるものにします。 このオプションは、無料(またはプラットフォーム外の有料)のプライベートリストでは利用できません。 |
場所別の過去の気象データ。 |
Category |
リストは、 Snowflake Marketplace で簡単に見つけられるように分類されています。使用可能な値のドロップダウンリストから目的のカテゴリを選択します。 このオプションは、無料(またはプラットフォーム外の有料)のプライベートリストでは利用できません。 |
|
Terms of Service |
リストに対するサービス契約の条項のリンクを指定します。コンシューマーは、リストにアクセスする前に条項に同意する必要があります。サービス契約の条項は、無料リストでは必須であり、パーソナライズされたリストではオプションです。 次のいずれかを選択します。
|
|
詳細¶
次のテーブルでは、 Details セクションで使用可能なフィールドについて説明します。
注釈
プライベートリストの場合、このセクションはオプションです。
フィールド名 |
説明 |
例 |
---|---|---|
Description |
リストで共有されているデータ製品の説明。250~6000文字の間で説明を入力し、段落の間に改行を入れます。箇条書きではなくダッシュを使用します。説明には次を含める必要があります。 . - データセットの範囲など、データ製品に関する情報を含む導入段落 . - 含まれるテーブルまたはビューの説明 . - 主要なデータフィールド . サービスまたはセキュア関数を含むリストの場合、説明には、コンシューマーがサービスまたはセキュア関数にアクセスするために予想されるワークフローを含める必要があります。 . 説明には、リストのデータソースや、他のフィールドではカバーされていない追加情報を含めることもできます。 |
ACME は、大企業向けに、カスタマイズされた正確な気象警報を提供する最大手サプライヤーであり、世界中の気象予報、データ、気象コンサルティングサービスの重要な情報源です。このリストは、 US 郵便番号別の過去の気象データであり、既存データをさらに強化してより詳細な分析を提供するために使用できます。 . 含まれるサンプル/テーブル: . - 2016年から現在までの過去の日次気象データ . - 15日間の日次気象予報データ . - 15年間の日次気候学データ(気象統計、つまり平均、標準、頻度など) . 含まれるフィールド: . - 日付 . - 郵便番号 . - 国 . - 最低、最高、平均気象統計(気温、降水量、風、湿度など) |
Link to Documentation |
リストのより詳細なドキュメンテーションがある会社ウェブサイトのページへのリンク。ドキュメンテーションは明確で、リストに関連付けられた共有に存在する適切なスキーマオブジェクトを参照する必要があります。リンクはインターネット上でアクセスできる必要があり、アクセスするための認証は必要ありません。 |
|
データ製品 - 属性¶
データ製品を指定した後にリストの追加属性を定義できます。
注釈
プライベートリストの場合、このセクションはオプションです。
フィールド名 |
説明 |
---|---|
更新頻度 |
Snowflakeでデータ製品が更新される頻度 |
地理的な範囲 |
データがカバーする地理的領域。 |
時間範囲 |
データがカバーする時間の範囲。 |
追加の属性(オプション) |
コンシューマーに伝える追加情報。たとえば、データの範囲と規模の説明、およびデータが役に立つと思われる理由を含めます。 |
データ製品 - 試用および料金(有料リストのみ)¶
このセクションで、リストの料金プランと試用を追加します。このセクションは、 Snowflake Marketplace で提供する有料リストには必須ですが、試用は有料のプライベートリストではオプションです。
注釈
アカウント管理者(ACCOUNTADMIN ロールを持つユーザー)またはリストの所有者(リストに対する OWNERSHIP 権限を持つロール)のみがこのセクションを完了することができます。
次のテーブルでは、 Trial & Pricing セクションで使用可能なフィールドについて説明します。
フィールド |
説明 |
---|---|
Pricing Plan |
リストの料金プランを選択します。 従量制料金モデル をご参照ください。料金は現在 US ドル表記のみです。 |
Free Trial |
リストの試用タイプを選択します。
|
データ製品 - データディクショナリ¶
データディクショナリは、コンシューマーがアカウントにインストールする前に、無料または有料のマーケットプレイスリストのコンテンツと構造に関する洞察を提供します。プライベートリストのデータディクショナリの追加はオプションです。
データディクショナリについて¶
データディクショナリを使用して、リストのコンテンツをコンシューマーに表示することができます。データディクショナリは、リスト内のテーブルおよびビューに対して生成されます。
データの表示方法には次の2つがあります。
注目のオブジェクト: コンシューマーがオブジェクトのコンテンツをすばやく表示できるようにします。リスト内の最も重要なデータベースオブジェクトを最大5つ選択できます。
すべてのオブジェクト: このリストにより、コンシューマーがリスト内のすべてのオブジェクトを表示できるようにします。リストを公開すると自動生成されます。
リストのデータディクショナリの設定¶
データディクショナリを追加する前に、リストにデータ共有を追加する必要があります。
Snowflake Marketplace で提供される無料および有料リストのデータディクショナリを設定するには、以下を実行します。
Snowsight にサインインします。
左側のナビゲーションバーで、 Data » Provider Studio » Listings を選択します
データディクショナリを追加するリストを検索して選択します。
Save and Create Data Dictionary を選択します。
注釈
この共有を保存することにより、ユーザーは、Snowflakeが共有用のデータディクショナリを作成し、コンシューマーに表示する権限に同意します。
リストを保存すると、データディクショナリが表示され、リスト内のすべてのテーブル、ビュー、および関数がリストされます。
注目のオブジェクトに含めるオブジェクトを検索または選択して、 Add to featured を選択します。
オプションで、このステップを繰り返して、注目のオブジェクトをさらに追加します。1つのリストに最大5つの注目のオブジェクトを設定できます。
Save をクリックします。
Provider Studioでは、テーブルの列の説明を編集できます。さらに、 CREATE <object> と ALTER <object> コマンド、または COMMENT コマンドで COMMENT パラメーターを使用して、オブジェクトや 個別のテーブル列 を説明するコメントを追加できます。
ビジネスニーズ¶
次のテーブルでは、 Business Needs セクションで使用可能なフィールドについて説明します。
注釈
プライベートリストの場合、このセクションはオプションです。
フィールド名 |
説明 |
---|---|
Business Need |
リストはビジネスニーズごとにグループ化されており、コンシューマーが Snowflake Marketplace で簡単に見つけられるようになっています。リストには関連するビジネスニーズを6つまで選択できます。 ドロップダウンリストに関連するビジネスニーズが表示されない場合は、カスタムビジネスニーズを作成できます。ただし、作成したカスタムビジネスニーズは、リストの詳細にのみ表示されます。コンシューマーは、 Snowflake Marketplace でカスタムビジネスニーズによるフィルター処理はできません。 ビジネスニーズのリストは、承認のためにリストを再提出することなく、いつでも編集できます。 |
Description |
選択したビジネスニーズにリストがどのように対応しているかの説明。 |
サンプル SQL クエリ¶
データ製品がSnowflakeアカウントに正常にインストールされたことを確認するために、コンシューマーが使用できる有効なサンプル SQL クエリを指定できます。
注釈
Marketplaceのリストを公開するには、有効な SQL クエリが必要です。プライベートリストを公開する場合は、 SQL クエリはオプションです。
サンプル SQL には次の要件があります。
クエリは少なくとも1行を返す必要がある。
クエリは明示的に共有にあるオブジェクトを参照する必要がある。
オブジェクトは
SCHEMA.OBJECT
を使用して修飾する必要がある。データベース名は含めないでください。たとえば、EXAMPLE_SCHEMA.TABLE_A
です。
次のテーブルでは、 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日間の更新頻度を選択する必要があります。 自動複製の詳細については、 クロスクラウド自動複製の構成 をご参照ください。 自動複製を使用できない場合は、 Manual を選択してデータ製品を手動で複製します。リクエストを満たすには、コンシューマーの需要があるリージョンでアカウントを設定し、製品を各アカウントに手動で複製し、各アカウントで安全な共有を作成し、それらの共有をこのリストに関連付ける必要があります。 リストのリクエストを複製する前に手動でデータを複製 をご参照ください |
コンシューマーアカウント(プライベートリストのみ)¶
プライベートリストを構成する場合は、次のテーブルのフィールドを構成する必要があります。
フィールド名 |
説明 |
例 |
---|---|---|
コンシューマーアカウント |
プライベートリストを共有するSnowflakeアカウントを指定します。Snowflakeアカウント識別子または URLs を使用できます。 |
|
アカウントとは異なるリージョンにあるコンシューマーアカウントと共有している場合は、自動複製も設定する必要があります。
フィールド名 |
説明 |
---|---|
自動複製 |
データ製品の複製間隔と頻度を選択します。たとえば、2時間ごとに複製するように構成できます。 |
詳細については、 クロスクラウド自動複製の構成 をご参照ください。