リスト用データを準備する¶

リスト作成の準備¶

リストを作成する前に、次を実行します。

1. データ製品を提供する方法を決定します。リスト候補オプション、および リストのアクセスオプション をご参照ください。

2. ロールと権限を設定して、リストの作成を簡素化します。リストのロールと権限を設定する をご参照ください。

3. 共有するオブジェクトを特定します。リストに何を入れるかを決める をご参照ください。

4. 他のユーザーと共有するオブジェクトを準備します。リスト用の共有の準備 をご参照ください。

5. データ製品へのアクセスを管理する方法を決定します。

   • 制限なく、無料でアクセスを提供します。

   • 有料リストを作成して、リストの料金を請求します。有料リストの提供の準備 をご参照ください。

   • 無料トライアルとしてデータ製品への限定的なアクセスを提供し、その後リクエストに応じてデータ製品への無制限のアクセスを提供します。限定トライアルリストの提供の準備 をご参照ください。

6. リストを提供するクラウドリージョンを選択します。他のリージョンで共有するためにリストを準備する をご参照ください。

リストとデータ共有は、Snowflake プロバイダーポリシー に準拠している必要があります。

リストのロールと権限を設定する¶

リストを作成するときは、データまたはアプリケーションパッケージが含まれているアカウントから作成します。データ製品をリストに添付し、リストを公開するロールは、アプリケーションパッケージまたは共有を作成したロールと同じロールである必要があり、したがってアプリケーションパッケージまたは共有を所有しています。共有の OWNERSHIP 権限を譲渡することはできません。

別のロールを使用してリストを作成および管理する場合は、アプリケーションパッケージまたは共有を所有するロールにリストの MODIFY 権限を付与します。例:

共有またはアプリケーションパッケージの所有者ロール:

共有またはアプリケーションパッケージに対する OWNERSHIP 権限。リストに対する MODIFY 権限。

リストの所有者ロール:

リストに対する OWNERSHIP 権限。

CREATE LISTING グローバル権限。

プロバイダーアカウント内で、次のいずれかを使用してリストを作成および管理できます。

ACCOUNTADMIN:

ACCOUNTADMINロールを使用してリストを作成および管理する場合、ORGADMINロールは最初に:ref:`label-delegate_laf_privileges`する必要があります。

カスタムロール:

カスタムロールを使用する場合、ORGADMINロールは最初にACCOUNTADMINロールに:ref:`label-delegate_laf_privileges`する必要があり、その後関連する権限をカスタムロールに付与できます。

共有権限の付与の詳細については、:doc:`他のロールへの権限付与</user-guide/data-exchange-marketplace-privileges>`をご参照ください。

リストに何を入れるかを決める¶

アカウントのデータをリストと共有する準備をする際に、リストに何を入れるかを決定します。

まず、共有するデータがSnowflakeにあり、データを共有する法的および契約上の権利があることを確認します。必要に応じて、共有するデータをSnowflakeにロードします。データのロードの概要 をご参照ください。

次に、リストとして持っているデータをどのように提供するかを決定します。Snowflake Marketplace にリストを提供する予定がある場合や、特定の顧客に直接プライベートリストとしてのみ提供する予定の場合は、リスト内に何を入れるかについて異なる決定がなされる可能性があります。

• データの可用性を検討します。

• リストにアクセスすると予想されるコンシューマーを検討します。

• テーブル、ビュー、セキュアビュー、その他のデータベースオブジェクトなど、共有に選択するデータの形式を検討します。

たとえば、犬のグルーミングに関するリストを提供する場合は、次のような決定を下すことができます。

• Snowflake Marketplace で、犬種と毛の長さに関する情報を公開する無料リストを提供します。

• スタンダードプードルのグルーミングにかかる時間に関するデータのサンプルデータ製品を含む、限定トライアルリストを Snowflake Marketplace に提供します。コンシューマーは、必要に応じてより多くの犬種のグルーミングの洞察に関する完全なデータ製品をリクエストできます。

• あらゆる犬種のグルーミングにかかる時間に関するデータのデータ製品を含む、限定トライアルリストを Snowflake Marketplace に提供します。コンシューマーは、必要に応じてデータ製品への無制限のアクセスをリクエストできます。

• さまざまな犬のグルーミングにかかる時間の長さと、さまざまな犬種のグルーミング予約の一般的な頻度に関する洞察について、パートナー組織にプライベートリストを提供します。

この例では、 Snowflake Marketplace で貴重なデータが提供されていますが、すでに信頼できる取引関係を築いている組織にはさらに具体的な洞察を提供します。

リスト用の共有の準備¶

リスト作成前に共有を作成するか、リスト作成時にデータ製品を構成するデータベース、テーブル、ビューを選択することができます。共有の作成と設定 をご参照ください。

多数のリストを提供する予定がある場合は、データ製品をより簡単に管理できるように、リストとは別に共有を作成します。同じ共有から複数のリストを提供することはできません。

限定トライアルリストの提供の準備¶

限定トライアルリストでは、データ製品のサンプルを無料トライアルとして提供し、コンシューマーに完全なデータ製品で使用できる内容の洞察を提供することや、完全なデータ製品への期間限定アクセスを提供することができます。プロバイダーは、限定トライアルリストの可用性期間を1日から90日の間で設定することができます。限定トライアルリストについては、 限定トライアルリスト をご参照ください。

完全なデータ製品の製品のサンプルを提供することを選択した場合、サンプルデータ製品では、完全なデータ製品に含まれる実際のデータのサブセットが提供され、次の点で完全なデータ製品を表するものであることが理想的です。

• 同じ列を含む。

• データに含まれる値の範囲や分布が同じか類似している。

限定トライアルリストにはデータディクショナリが含まれているため、提供するサンプルデータ製品から完全なデータ製品のデータの一般的な形状がわかるはずです。

たとえば、犬のトレーニングやグルーミングの会社であれば、次のようなサンプルデータを限定トライアルリストで提供することを検討してみてください。

完全なデータ製品に関連性のある完全なサブセットを限定トライアルリストのサンプルデータとして提供することで、コンシューマーは完全なデータ製品の価値を理解し、完全なデータ製品をリクエストする可能性が高くなります。

CREATE OR REPLACE SECURE VIEW limited_functionality_view
  AS
  SELECT *
    FROM db_name.schema_name.table_name
    WHERE SYSTEM$IS_LISTING_TRIAL() = false;

CREATE OR REPLACE SECURE FUNCTION schema_name.shared_function()
  RETURNS VARCHAR
  AS
  $$
    CASE
      WHEN SYSTEM$IS_LISTING_TRIAL() = FALSE
        THEN 'full product'
      ELSE 'trial'
    END
  $$;

# Import python packages
import streamlit as st
from snowflake.snowpark.context import get_active_session

session = get_active_session()
# Here we assign result of our function to a variable
result = session.sql("SELECT SYSTEM$IS_LISTING__TRIAL()")

# Write directly to the app
if result:
  st.title("Enjoy your limited trial of this application!")
else:
  st.title("Welcome to the full version of this application!")

有料リストの提供の準備¶

リストの料金を請求する場合は、次を実行する必要があります。

1. 有料リストを提供できるかどうかを判断します。有料リストを提供できる人 をご参照ください。

2. データの試用を提供するためのデータを準備します。有料リスト用の共有の準備 をご参照ください。

3. リストに最適な料金プランを決定します。利用可能な料金プランを確認するには、 有料リストの料金モデル をご参照ください。

CREATE SECURE VIEW paid_v
  AS
  SELECT
    *
  FROM
    paid_t
  WHERE
    SYSTEM$IS_LISTING_PURCHASED() = TRUE;

CREATE SECURE VIEW paid_v
  AS
  SELECT
    *
  FROM
    paid_t
  WHERE
    is_free
    OR
    SYSTEM$IS_LISTING_PURCHASED() = TRUE;

CREATE SECURE VIEW paid_v
  AS
  SELECT *
  FROM
    paid_t
  WHERE
    (timestamp > current_timestamp() - interval '7 days')
    OR
    SYSTEM$IS_LISTING_PURCHASED() = TRUE;

EXECUTE USING SHARE_CONTEXT(SYSTEM$IS_LISTING_PURCHASED=>{ 'TRUE' | 'FALSE' })
  AS <query>

EXECUTE USING share_context(system$is_listing_purchased=>'FALSE')
  AS
    SELECT
      *
    FROM
      example_database.example_schema.PURCHASED_VIEW

Query produced no results

EXECUTE USING share_context(system$is_listing_purchased=>'TRUE')
  AS
    SELECT
      *
    FROM
      example_database.example_schema.PURCHASED_VIEW

他のリージョンで共有するためにリストを準備する¶

リストを構成する際は、さまざまなリージョンで提供する選択ができます。他のリージョンでリストを提供するには、データを複製する必要があります。

データの複製にかかる時間と複製にかかるコストを検討します。

• Snowflake Marketplace のリストについては、リストを利用可能にするリージョンを選択できます。その場合は、データを手動で複製するか、自動複製を使用して、リストを入手したコンシューマーに対して製品を利用可能にすることができます。詳細については、label-manually_replicate_listing`または:doc:/collaboration/provider-listings-auto-fulfillment`をご参照ください。

• プライベートリストの場合は、コンシューマーのアカウントがあるリージョンに対してリストを共有する必要があります。自動複製を使用して、リストを入手したコンシューマーに製品を複製します。詳細については、 リストの自動複製 をご参照ください。

Snowflakeでのクロスリージョンデータ共有すべては、Snowflakeのデータ複製機能を使用します。リージョンとクラウドプラットフォーム間で安全にデータを共有する をご参照ください。