为列表准备数据¶

准备创建列表¶

在创建列表之前，请执行以下操作：

1. 确定如何提供数据产品。请参阅 列表可用性选项 和 列表访问选项。

2. 设置角色和权限以简化列表的创建。请参阅 为列表设置角色和权限。

3. 确定要共享的对象。请参阅 确定列表内容。

4. 准备要与他人共享的对象。请参阅 为列表准备共享。

5. 确定要如何管理对数据产品的访问：

   • 免费提供访问权限，并且无限制。

   • 创建付费列表，为您的列表收取费用。请参阅 准备提供付费列表。

   • 免费试用提供对数据产品的受限访问权限，然后可按请求提供对数据产品的无限制访问权限。请参阅 准备提供受限试用列表。

6. 选择您要在哪个云区域提供列表。请参阅 为在其他区域共享准备列表。

列表和数据共享必须符合 Snowflake 提供商政策。

为列表设置角色和权限¶

创建列表时，应使用包含列表中数据或应用程序包的账户。以下角色必须相同：将数据产品附加到列表并发布列表的角色，以及创建（并因此而拥有）应用程序包或共享的角色。您不能转让共享的 OWNERSHIP 权限。

如果使用其他角色创建和管理列表，请将列表的 MODIFY 权限授予拥有应用程序包或共享的角色。例如：

共享或应用程序包所有者角色：

共享或应用程序包的 OWNERSHIP 权限。列表的 MODIFY 权限。

列表所有者角色：

列表的 OWNERSHIP 权限。

全局 CREATE DATA EXCHANGE LISTING 权限。

在提供商账户中，您可以使用以下任一方式来创建和管理列表：

ACCOUNTADMIN:

如果您使用 ACCOUNTADMIN 角色创建和管理列表，则 ORGADMIN 角色必须首先 委派权限以设置自动履行。

自定义角色:

如果使用自定义角色，ORGADMIN 角色必须首先 委派权限以将自动履行 设置给 ACCOUNTADMIN 角色，然后可以使用该角色将相关权限授予自定义角色。

某些权限只能使用 Snowsight 授予，其他权限可使用 SQL 或 Snowsight 授予。

有关授予共享权限的更多信息，请参阅 向其他角色授予权限。

确定列表内容¶

准备使用列表共享您账户中的数据时，应确定要在列表中存放哪些内容。

首先，确保您要共享的数据在 Snowflake 中，并确保您拥有共享这些数据的法定和合同权利。如有需要，将要共享的数据加载到 Snowflake 中。请参阅 数据加载概述。

随后，确定如何以列表形式提供您拥有的数据。如果您计划在 Snowflake Marketplace 上提供列表，或者仅以私密列表形式直接向特定客户提供，那么对于要在列表中存放的内容，您可能会做出不同的决定。

• 考虑数据可用性。

• 考虑预计访问您的列表的使用者。

• 考虑为共享选择的数据格式，例如表、视图、安全视图或其他数据库对象。

例如，如果想提供有关狗狗美容的列表，可以做出如下决定：

• 在 Snowflake Marketplace 上提供公开的免费列表，包含有关犬种和毛发长度的信息。

• 在 Snowflake Marketplace 上提供受限试用列表，其中包含样本数据产品，内有关于标准贵宾犬美容所需时间的数据，使用者可以选择请求有关美容深入信息的完整数据产品，以获取更多犬种的数据。

• 在 Snowflake Marketplace 上提供受限试用列表，其中的数据产品包含为任何犬种美容所需时间的数据，使用者可以选择请求无限制地访问您的数据产品。

• 向合作伙伴组织提供一份私密列表，提供有关为各类犬种美容所需的时长、不同犬种的典型美容预约频率的见解。

在此示例中，您在 Snowflake Marketplace 上提供了重要数据，但向已经拥有可信业务关系的组织提供了更具体的见解。

为列表准备共享¶

您可以在创建列表之前创建共享，也可以在创建列表时选择构成数据产品的数据库、表和视图。请参阅 使用共享。

如果您计划提供许多列表，请分别创建共享和列表，以便更轻松地管理数据产品。您不能从同一共享中提供多个列表。

准备提供受限试用列表¶

受限试用列表允许您提供数据产品样本的免费试用，让使用者深入了解完整数据产品可能提供的内容，或者在限定时间内访问您的完整数据产品。随后，使用者可以申请无限制访问完整数据产品。有关更多详细信息，请参阅 受限试用列表。

如您选择提供完整数据产品的样本，则样本数据产品最好提供完整数据产品中所含真实数据的子集，并通过以下方式代表完整数据产品：

• 包含相同的列。

• 包含数据中相同或相似的值范围和值分布。

受限试用列表包含一个数据词典，因此应能从您提供的样本数据产品中清晰地了解完整数据产品中数据的整体情况。

例如，如果贵公司是训犬和犬类美容公司，则可以考虑提供以下样本数据产品之一，并提供受限试用列表：

将完整数据产品的相关完整子集作为受限试用列表的样本数据产品提供，可帮助使用者了解您的完整数据产品的价值，也让他们更有可能申请完整数据产品。

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 中的列表，您可以选择在哪些区域提供列表。此时，您可以手动复制数据，也可使用自动履行，将产品提供给获得列表的使用者。有关更多详细信息，请参阅 手动复制数据以履行列表请求 或 配置 Cross-Cloud Auto-Fulfillment。

• 对于私密列表，您需要将列表共享到使用者账户所在的区域。可以使用自动履行，将产品复制到获得列表的使用者。有关更多详细信息，请参阅 配置 Cross-Cloud Auto-Fulfillment。

Snowflake 的所有跨区域数据共享均使用 Snowflake 的数据复制功能。请参阅 跨区域和云平台安全共享数据。