为列表准备数据¶

准备创建列表¶

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

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

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

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

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

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

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

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

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

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

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

为列表设置角色和权限¶

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

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

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

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

列表所有者角色：

列表的 OWNERSHIP 权限。

全局 CREATE LISTING 权限。

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

ACCOUNTADMIN:

If you use the ACCOUNTADMIN role to create and manage listings, the ORGADMIN role must first 委派自动履行的设置权限.

自定义角色:

If you use a custom role, the ORGADMIN role must first 委派自动履行的设置权限 to the ACCOUNTADMIN role, which can then be used to grant the relevant privileges to the custom role.

For more information about granting sharing privileges, see Granting Privileges to Other Roles:.

确定列表内容¶

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

First, make sure that the data you want to share is in Snowflake, and that you have the legal and contractual rights to share the data. If needed, load the data that you want to share into Snowflake. See 数据加载概述.

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

• 考虑数据可用性。

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

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

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

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

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

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

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

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

为列表准备共享¶

You can create a share before creating a listing, or select the database, tables, and views to comprise your data product when you create the listing. See 创建和配置共享.

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

准备提供受限试用列表¶

受限试用列表允许您提供数据产品样本的免费试用，让使用者深入了解完整数据产品可能提供的内容，或者在限定时间内访问您的完整数据产品。提供商可以将受限试用列表的可用期设置为 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

为在其他区域共享准备列表¶

配置列表时，您可以选择在不同的区域提供列表。要在其他区域提供列表，需要复制数据。

考虑复制数据所需的时间和相关费用。

• For a listing in the Snowflake Marketplace, you can choose which regions to make your listing available in. When you do, you can manually replicate the data or use auto-fulfillment to make your product available to consumers that get your listing. See 手动复制数据以履行列表请求 or 列表的自动履行 for more details.

• For a private listing, you need to share your listing to the regions where your consumer's accounts are. You use auto-fulfillment to replicate the product to the consumers that get your listing. See 列表的自动履行 for more details.

All cross-region data sharing at Snowflake uses Snowflake's data replication functionality. See 跨区域和云平台安全共享数据.