リストの作成および公開

このトピックには、プライベートで、または Snowflake Marketplace でリストを作成して公開するための手順が含まれています。

このトピックの内容:

リストを作成するための前提条件

プロバイダーになるための条件については、 プロバイダーとしてのリストを使用する をご参照ください。

US 政府リージョンにあるアカウントへのリストの共有に関する考慮事項

US 政府リージョンのコンシューマーアカウントとリストを共有する非政府プロバイダーは、以下を考慮する必要があります。

プライベートリストを使用して、特定のコンシューマーとデータまたはアプリを共有します。

無料または有料のリストを作成して、特定のコンシューマーと直接共有できます。限定トライアルリストからのリクエストに応えるため、あるいはすでにビジネス関係にあるコンシューマーとデータまたはアプリを共有するために、プライベートリストを作成する場合があります。

リストを共有するには、コンシューマーのアカウント識別子を知っている必要があります。アカウントの組織名とアカウント名の検索 をご参照ください。

注釈

ロールには、リストを作成するために必要な権限が必要です。リストを操作するために必要な権限 をご参照ください。

無料(または有料のプラットフォーム外)プライベートリストの作成

  1. 次のいずれかを実行します。

  2. + Create Listing » Specified Customers を選択します。

  3. Create Listing ダイアログで、リストの名前を入力します。

  4. Who can discover the listing? セクションで、 Only specified consumers を選択します。

  5. What type of listing would you like to publish? セクションで、 Free (or paid off-platform) を選択します。

  6. Next を選択します。

  7. リストに添付するオブジェクトを選択するには、 + Select を選択します。

    • 1 つ以上のデータベースオブジェクトを選択すると、Snowflake はそれらのオブジェクトで安全な共有を作成します。安全な共有の名前は変更できます。

    • 既存のセキュア共有を選択すると、その共有の名前が表示されます。

  8. リストの説明を入力します。

  9. オプション: 複数のプロバイダープロファイルがある場合は、このリストを公開するプロバイダープロファイルを選択します。プロバイダープロファイルを選択しない場合、Snowflakeはデフォルトで組織とアカウントを使用します。

  10. Consumer Data Sharing Account ID セクションで、リストを共有するコンシューマーの 組織とアカウント名 を追加します。

  11. ローカルリージョンではないリージョンにコンシューマーアカウントを追加した場合、Snowflakeは、コンシューマーがあなたのリストを取得した後にリモートリージョンにデータを複製する自動フルフィルメントを可能にします。次の追加手順を完了します。

    1. Auto-fulfillment セクションで値を入力し、間隔を選択して、ローカルリージョンからリモートリージョンにデータ製品を複製する頻度を指定します。

    2. デフォルトのウェアハウスが設定されていない場合は、自動複製に使用するウェアハウスを選択します。

    詳しくは、 リスト用自動フルフィルメント を参照してください。

  12. Publish を選択してリストを選択したコンシューマーに公開するか、 Save Draft を選択し、ドラフトとして保存します。

有料プライベートリストの作成

  1. リストを作成。

  2. リストを構成して 公開の準備をします。

  3. 承認と公開のためにリストを送信します

  4. Snowsight にサインインします。

  5. + Create Listing » Specified Customers を選択します。

  6. Create Listing ウィンドウで、リストの名前を入力します。

  7. Who can discover the listing? セクションで、 Only specified consumers を選択します。

  8. リスト掲載料を請求するには、 What type of listing would you like to publish? セクションで、 Paid on Snowflake を選択します。

  9. Next を選択します。リストのドラフトが作成されます。

  10. 必須およびオプションの追加機能を設定します。リストの構成 をご参照ください。

従量制トライアルの作成

従量制トライアルでは、コンシューマーがデータ製品に対して実行できるクエリをいくつか無料で提供することができます。無料のクエリがすべて使用された後、コンシューマーは追加のクエリを実行するためにデータ製品を購入する必要があります。

リストにトライアルを追加するには、リストにデータ製品が添付されており、 ACCOUNTADMIN ロールまたは OWNERSHIP 権限を持っている必要があります。リストの管理に必要な権限の詳細については、 リスト用データを準備する をご参照ください。

  1. Snowsight にサインインします。

  2. ナビゲーションメニューで、 Data Products > Provider Studio を選択します。

  3. Listings を選択し、既存のリストを選択するか、新しいリストを作成します。

  4. Access & Pricing セクションで、 Pricing & Trial の隣にある Edit または Add を選択します。

  5. Usage-based を選択します。

  6. Monthly Fee フィールドに月額料金を入力します。

  7. オプション。Queries エリアに、クエリあたりのコストと含まれるクエリの数を入力します。

  8. クエリあたりのコストを入力した場合は、 Maximum Monthly Charge フィールドに最大月額料金を入力します。

  9. Free Trial エリアでは、以下の従量制トライアルのタイプから1つを選択します。

    • Limited Usage

    • Limited Time

    • Limited Functionality

    • Limited Functionality & Time

  10. Limited Usage を選択した場合は、 Number of Free Queries During Trial フィールドに値を入力します。

  11. Limited Time または Limited Functionality & Time を選択した場合は、 Length of Trial フィールドに値を入力します。

  12. Save を選択します。

ダイレクトシェアを無料(または有料のプラットフォーム外)のプライベートリストに変換します。

ダイレクト・シェアは、無料(または有料のプラットフォーム外)のプライベート・リストや、 Snowflake Marketplace で公開されるリストに変換することができます。そうすると:

  • 既存のコンシューマーは共有へのアクセスを維持します。

  • リストが公開された日から、使用状況分析にアクセスできます。使用状況の履歴データは入手できません。

  • 共有内のオブジェクトにまだ複製を使用しておらず、共有に自動フルフィルメントによりサポートされているオブジェクトのみが含まれている場合、自動フルフィルメントを使用してリモートリージョンのコンシューマーと共有することができます。自動フルフィルメントでサポートされるオブジェクト を参照してください。

  • 共有にアクティブなコンシューマーがいる場合、共有を有料リストに変更することはできません。

共有のリモートコンシューマーをサポートするために自動フルフィルメントを使用することを決定した場合、データのリモートコンシューマーと次のワークフローについて調整します。

  • リストを公開したら、リモートリージョンのコンシューマーにリストへのアクセス方法を知らせます。プライベートリストにアクセスする をご参照ください。

  • リモートリージョンのコンシューマーがあなたのリストを取得すると、自動フルフィルメントはリモートリージョンにデータを複製します。自動フルフィルメントがサポートされているオブジェクト をご参照ください。

  • 自動フルフィルメントが完了すると、コンシューマーはデータが利用可能になった旨のメールを受け取ります。その時点で、コンシューマーは次を実行する必要があります。

    • 直接共有から作成された既存のインポート済みデータベースを削除します。

    • リストを取得し、直接共有からインポートしたデータベースと同じ名前を使用してデータベースを作成します。

直接共有をリストとして設定した後、 Provider Studio を使用してリストを管理および変更できます。公開リストの変更、および リスト利用の監視 をご参照ください。

Snowflake Marketplace でデータまたはアプリを共有する

注釈

Snowflake Marketplace に有料リストを作成して公開する前に、Snowflakeのビジネス開発パートナーに連絡してください。ビジネス開発パートナーがいない場合は、 Marketplaceオペレーションにケースを提出してください。このステップはリストの承認に必要です。

注釈

ロールには、リストを作成するために必要な権限が必要です。リストを操作するために必要な権限 をご参照ください。

  1. Snowsight にサインインします。

  2. ナビゲーションメニューで Data Products » Provider Studio を選択します。

  3. + Create Listing » Snowflake Marketplace を選択します。

  4. Create Listing ウィンドウで、リストの名前を入力します。

  5. Snowflake Marketplace にリストを掲載するには、 Who can discover the listing? のセクションで、 Anyone on the Marketplace を選択します。

  6. What type of listing would you like to publish? セクションで、次のいずれかのオプションを選択します。

    • Free は、コンシューマーが自由に利用できるデータ製品を提供します。

    • Limited trial は、データ製品のトライアルを提供し、要望に応じてデータ製品に無制限にアクセスできるようにします。

    • Paid on Snowflake は、Snowflakeのデータ製品に課金します。

  7. Next を選択します。リストのドラフトが作成されます。

  8. リストを構成して 公開の準備をします。

  9. 承認と公開のためにリストを送信します

コンプライアンスバッジを含む Snowflake Marketplace リストの作成

注釈

現在、コンプライアンスバッジを含むリストの作成は、リスト APIs からのみ可能です。

コンプライアンスバッジ を含むリストを作成するには、次のステップに従います。

  1. 承認された プロファイル を使用して、 `リストのmanifest.yml<https://docs.snowflake.com/en/progaccess/listing-manifest-reference>`_ を作成します。

  2. マニフェストファイルに、 compliance_badges フィールドを追加し、各認証タイプごとに1行を含めます。例:

    title: "My listing title"
    subtitle: "My listing subtitle"
    description: "My listing description"
    profile: "MyProfile"
    
    compliance_badges:
    - type: SOC2
      expiry: 12-25-2026
      files:
        - soc2_compliance_verification.pdf
    - type: HIPAA
      expiry: 06-07-2026
      files:
        - hipaa_compliance_verification.pdf
    
    Copy
  3. SnowSQL をインストールして構成します。

  4. SnowSQL に接続するには、次のコマンドを実行します。

    snowsql -c my_example_connection
    
    Copy
  5. データベース、スキーマ、ステージを作成するには、次のコマンドを実行します。

    CREATE DATABASE <db name>;
    CREATE SCHEMA <schema name>;
    CREATE STAGE <stage_name>;
    
    Copy
  6. リストマニフェストファイルをローカルからステージにアップロードするには、次のコマンドを実行します。

    PUT file:///<local_path>/manifest.yml @<stage_name>/<prefix>
      SOURCE_COMPRESSION=None
      AUTO_COMPRESSION=False
      OVERWRITE=True;
    
    Copy

    注釈

    Snowsightを使用してステージにファイルをアップロードするには、 `Snowsightを使用したファイルのステージング<https://docs.snowflake.com/en/user-guide/data-load-local-file-system-stage-ui>`_ のステップに従います。

  7. マニフェストにリストされているコンプライアンスドキュメントをステージにアップロードするには、次のコマンドを実行します。

    PUT file:///<local_path>/soc2_compliance_verification.pdf @<stage_name>/<prefix>
    PUT file:///<local_path>/hipaa_compliance_verification.pdf @<stage_name>/<prefix>
    PUT file:///<local_path>/sample.pdf @<stage_name>/<prefix>
      SOURCE_COMPRESSION=None
      AUTO_COMPRESSION=False
      OVERWRITE=True;
    
    Copy
  8. ファイルが正しい名前で正常にアップロードされたことを確認するには、次のコマンドを実行します。

    LIST @<stage_name>/<prefix>;
    
    Copy
  9. ステージにアップロードしたマニフェストファイルを使用してリストを作成するには、 CREATELISTING を使用します。例:

    CREATE EXTERNAL LISTING <listing_name>
      APPLICATION PACKAGE <app package name>
      FROM @<staging_name>/<prefix>
      REVIEW = True
      PUBLISH = True;
    
    Copy

リストにコンプライアンスバッジを追加した後、 SQL を使用して、バッジが正しく追加されたことを確認できます。

コンプライアンスバッジがリストに追加されたことを確認するには、次のステップを実行します。

  1. 次のコマンドを実行します。

    DESCRIBE LISTING <listing_name> REVISION = DRAFT;
    
    Copy
  2. 出力で、 compliance_badges セクションのmanifest.yml列を確認します。

リストの構成

有料のプライベートリストおよび Snowflake Marketplace で提供されるリストについては、承認のためにリストを送信したり、特定のコンシューマーに公開したりする前に、追加の詳細を提供する必要があります。

  1. Snowsight にサインインします。

  2. ナビゲーションメニューで Data Products » Provider Studio を選択します。

  3. Listings タブを選択してから、構成するドラフトリストを選択します。

  4. ページに表示される各セクションの横にある Add を選択し、必要な情報を入力します。

    各セクションに情報を入力するときは、各フィールドに対する情報の リストの構成 をご参照ください。編集できる具体的なプロパティは、作成するリストのタイプによって異なります。

リストの公開

リストの作成と設定の後に、リストを公開できます。

リスト公開の具体的なプロシージャは、無料(または有料のプラットフォーム外)のプライベートリストを公開するのか、有料のリストを非公開で提供するのか、 Snowflake Marketplace のあらゆるリストを提供するのかによって異なります。

リストを公開するには、ACCOUNTADMIN ロール、または公開するリストに対する OWNERSHIP 権限を持つ別のロールを使用する必要があります。

リストを公開すると、現在および将来のすべての Marketplace リージョンのコンシューマーに表示されますが、コンシューマーは選択したリージョンでのみ製品の入手、購入、リクエストができます。

特定のコンシューマーにリストを公開する

プライベートリストを特定のコンシューマーアカウントと共有するには、それらのアカウントにリストを公開する必要があります。プライベートリストは Snowflake Marketplace では表示されません。

  1. Snowsight にサインインします。

  2. ナビゲーションメニューで Data Products » Provider Studio を選択します。

  3. Listings タブを選択してから、公開するドラフトリストを選択します。

  4. Publish を選択します。

リストを公開すると、特定のコンシューマーが Private Sharing からリストにアクセスできるようになります。リストへのコンシューマーとしてのアクセスおよびインストール をご参照ください。

注釈

プライベートリストを公開したら、そのリストに関連付けられている共有を変更することはできません。

Snowflake Marketplaceにリストを公開する

Snowflake Marketplace のすべてのリストは、審査と承認のプロセスを経る必要があります。リストが承認された後、 Snowflake Marketplace で公開できます。リストが拒否された場合は、フィードバックのコメントを確認し、リストを更新して、承認のために再送信します。

承認のためのリストの送信

リストを Snowflake Marketplace に公開する前に、承認のためにリストを Snowflake に送信する必要があります。

承認のためにリストを送信したいが、 Submit for Approval のオプションが無効になっている場合は、次を確認します。

  • リストを構成する手順が完了している。リストの構成 をご参照ください。

  • ACCOUNTADMIN であるか、リストに添付されたデータ製品に対する OWNERSHIP 権限を持っている。

  • リストに添付されたすべてのサンプル SQL クエリが検証に合格した。

  1. Snowsight にサインインします。

  2. ナビゲーションメニューで Data Products » Provider Studio を選択します。

  3. Listings タブを選択してから、承認のために送信するドラフトリストを選択します。

  4. Submit for Approval を選択します。

  5. リストがSnowflakeによって確認された後、状態は Approved または Denied に変わります。

    リストが拒否された場合は、コメントで提供されたフィードバックに基づいてリストを更新し、承認のために再送信します。

    電子メール通知は、リストに関連付けられたプロバイダープロファイルの Business ContactTechnical Contact の両方の電子メールアドレスに送信されます。

リストを公開する

  1. Snowsight にサインインします。

  2. ナビゲーションメニューで Data Products » Provider Studio を選択します。

  3. Listings タブを選択し、公開する承認済みリストを選択します。

  4. Publish を選択します。

Snowflake Marketplace リストを初めて公開したら、Snowflake からの承認を必要とする後続のリストへの変更は、承認後に自動的に公開されます。リストが自動的に公開されないようにするには、 自動公開を無効にする をご参照ください。

プロバイダーがリストを公開すると、現在および将来のすべての Snowflake Marketplace リージョンのコンシューマーに表示されます。プロバイダーが選択したリージョンでのみ、コンシューマーは製品の入手、購入、リクエストができます。リージョンの可用性については、 リスト用自動フルフィルメント を参照してください。

Snowflake Marketplace のリストを公開したら、リストの 紹介リンク を定義できます。紹介リンクは、コンシューマーにリストへのリンクを直接提供できます。

自動公開を無効にする

リストが公開された後、リストに行われる将来の変更について自動公開を無効にすることができます。

  1. Snowsight にサインインします。

  2. ナビゲーションメニューで Data Products » Provider Studio を選択します。

  3. Listings タブを選択し、自動公開を無効にする承認済みリストを選択します。

  4. リストの詳細ページで、 Settings を選択します。

  5. Listing SettingsPublishing セクションで、 Edit Publishing を選択します。

  6. Publish Setting ウィンドウで、 Manual を選択します。

  7. Save を選択します。

リストは自動的に公開されなくなります。これにより、リストに変更を加える場合は、リストを手動で公開することが必要になります。リストを公開する をご参照ください。

Snowflake Marketplaceリストへのノートブックの添付

プロバイダーは、リストにノートブックを追加して、潜在的なコンシューマーがデータ製品からどのように活用し、メリットを受けることができるかを示すことができます。リストは、SnowflakeパブリックMarketplace、社内Marketplace、または一部のコンシューマーへのプライベートリストとして利用できます。

プロバイダーは、結果で完全に実行されたノートブックをリストに添付することができます。結果には、リスト内のデータ製品の値を説明するための表形式の出力や視覚化を含めることができます。プロバイダーは、ノートブックにPythonベースと SQL ベースの両方の例を含めることができ、明確なMarkdownの説明を追加してコンシューマーを誘導できます。

注釈

リストに添付されたノートブックは表示のみであり、コンシューマーがクローンしたり、ダウンロードしたり、操作したりすることはできません。

リストにノートブックを添付するには、次のステップに従います。

  1. Snowsight にサインインします。

  2. 左側のナビゲーションメニューで Projects » Notebooks を選択します。

  3. `ノートブックを作成する<https://docs.snowflake.com/user-guide/ui-snowsight/notebooks-create>`_

  4. ノートブックの各セルで、 Run all または Run を選択して結果を生成します。各セルで実行していることを確認してください。

  5. ノートブックが正常に実行されたことを確認するには、緑の実行ステータスインジケータを見つけます。

  6. Notebooksセッションを終了するには、 Active ドロップダウンを選択して End session を選択します。

  7. Data Products`|ra|:ui:`Provider Studio を選択します。すべてのリストタイプにノートブックを添付できます。

  8. 新しいリストを作成 または既存のリストを選択します。

  9. + Add data product を選択します。

  10. + Select を選択します。

  11. Quick Start Examples セクションで、 Add Notebook を選択します。

  12. 添付するノートブックを選択します。検索機能を使って、特定のノートブックを見つけることができます。

  13. Save を選択します。

  14. 選択したコンシューマーにリストを公開するには、 Publish を選択します。

注釈

リストにノートブックを添付した後にノートブックの内容を更新するには、リストからノートブックを削除して再度添付する必要があります。

リストからノートブックを削除する

  1. Data Products » Provider Studio を選択します。

  2. Quick Start Examples セクションで、削除するノートブックを選択します。

  3. Remove Notebook を選択します。

注釈

ノートブックの所有権を紛失した場合、または共有リソースから削除した場合でも、コピーはリストに残ります。

制限事項

  • プロバイダーはリストに1つのノートブックのみを添付でき、プロバイダーは OWNERSHIP そのノートブックに対する権限が必要です。

  • コンシューマーは、リストでノートブックとその結果のみを表示することができます。

  • ノートブックの変更はリストで自動的に更新されません。最新の変更を反映するには、ノートブックを削除して再度追加する必要があります。