配置列表¶

当您创建列表时，您必须先填写列表的其他字段，然后才能将列表提供给使用者。

根据您提供列表的方式以及使用者访问数据产品的方式，某些部分或字段可能是可选的。

配置列表后，将列表发布给使用者。请参阅发布列表。

本主题内容：

基本信息¶

填写有关列表的基本信息。下表描述了 Basic Information 部分中的字段：

字段名称	描述	示例
Title	列表的标题。当使用者查看您的列表时，标题会显示在您的公司名称下方。标题必须符合以下条件才能获得批准：应介于 40 到 60 个字符之间，最多 110 个字符所有主要单词均大写（使用标题大小写形式）必须是唯一的必须与通过您的提供商简介提供的任何其他列表不同	按邮政编码显示的历史天气。
Subtitle	提供对使用者可见的数据产品的简短、翔实的说明。副标题不能超过 100 个字符。副标题使用句子大小写形式，且不能与标题重复。此选项不适用于私密列表。	按位置显示的历史天气数据。
Category	类别可帮助使用者在 Snowflake Marketplace 中找到您的数据或应用程序。从可用值的下拉列表中选择所需的类别。您只能选择一个类别。此选项不适用于私密列表。	环境
Terms of Service	指定列表条款的链接 – 列表的服务协议。使用者必须先接受这些列表条款，然后才能访问列表。所有列表都必须提供列表条款。选择以下选项之一： Standard Agreement for Marketplace Products：Snowflake 为 Snowflake Marketplace 提供标准列表条款，称为标准 Marketplace 产品协议。该协议可在以下网址获得：https://www.snowflake.cn/marketplace/standard-agreement/。您可以选择使用标准协议作为列表条款。有关标准协议的更多信息，请参阅以下网址中的 FAQs ：https://www.snowflake.cn/standard-agreement-for-marketplace-products/。选择标准 Marketplace 产品协议，即表示您已确认已与法律顾问一起查看该协议和免责声明。 Custom：为列表条款指定 URL。URL 必须可公开访问，并且不需要身份验证即可访问。列表条款可以是 PDF 或可从 URL 访问的其他文档类型。 Listing terms will be provided offline：仅适用于直接提供给特定使用者的私密列表。此选项允许您向使用者提供 URL 中没有的列表条款协议。	Custom、`https://www.example.com/en/legal`

详细信息¶

填写列表的其他详细信息。

备注

对于私密列表，此部分是可选的。

下表描述了 Details 部分中的可用字段：

字段名称	描述	示例
Description	列表中共享的数据产品的说明。该说明可帮助使用者了解您的数据产品中的内容。输入 250 到 6000 个字符之间的描述，段落之间使用换行符。使用破折号而非项目符号。描述必须包含一个介绍性段落，其中包含有关数据产品的信息，例如数据集的范围。对于包含服务或安全功能的列表，描述必须包含使用者访问您的服务或安全功能的预期工作流程。描述还可以包括您的列表的数据源，或其他字段中未涵盖的额外信息。	ACME 是为大型企业提供定制、精确天气预警的头号供应商，也是全球天气预报、数据和气象咨询服务的重要信息来源。此列表提供了各个 US 邮政编码对应的历史天气数据，可用于进一步增强现有数据以提供更深入的分析。预期工作流程：使用者使用私密列表与提供商共享邮政编码列表。提供商扩充邮政编码。提供商使用私密列表与使用者共享扩充的数据。
Link to Documentation	指向您网站上的页面的链接，其中包含有关列表的更详细文档。文档必须清晰，并引用与列表相关的数据共享或 Snowflake Native App 中存在的正确架构对象。该链接必须可通过互联网访问，并且不需要身份验证即可访问。	`https://www.example.com/documentation/`
Link to Video	指向列表的不公开或公开 YouTube 视频的链接。不支持私密视频。视频缩略图会显示在列表详细信息页面上，视频不会自动播放。小技巧制作要在列表详细信息页面上展示的视频时，请记住以下几点：视频最终帧会在视频播放后显示，并应包含号召性用语。视频应该简短，并显示实际的产品使用情况，前 5 秒是最重要的。	https://www.youtube.com/watch?v=MEFlT3dc3uc (link removed)

字段名称

描述

示例

Description

列表中共享的数据产品的说明。该说明可帮助使用者了解您的数据产品中的内容。

输入 250 到 6000 个字符之间的描述，段落之间使用换行符。

使用破折号而非项目符号。描述必须包含一个介绍性段落，其中包含有关数据产品的信息，例如数据集的范围。

对于包含服务或安全功能的列表，描述必须包含使用者访问您的服务或安全功能的预期工作流程。

描述还可以包括您的列表的数据源，或其他字段中未涵盖的额外信息。

ACME 是为大型企业提供定制、精确天气预警的头号供应商，也是全球天气预报、数据和气象咨询服务的重要信息来源。此列表提供了各个 US 邮政编码对应的历史天气数据，可用于进一步增强现有数据以提供更深入的分析。

预期工作流程：

使用者使用私密列表与提供商共享邮政编码列表。
提供商扩充邮政编码。
提供商使用私密列表与使用者共享扩充的数据。

Link to Documentation

指向您网站上的页面的链接，其中包含有关列表的更详细文档。文档必须清晰，并引用与列表相关的数据共享或 Snowflake Native App 中存在的正确架构对象。该链接必须可通过互联网访问，并且不需要身份验证即可访问。

https://www.example.com/documentation/

Link to Video

指向列表的不公开或公开 YouTube 视频的链接。不支持私密视频。视频缩略图会显示在列表详细信息页面上，视频不会自动播放。

小技巧

制作要在列表详细信息页面上展示的视频时，请记住以下几点：

视频最终帧会在视频播放后显示，并应包含号召性用语。
视频应该简短，并显示实际的产品使用情况，前 5 秒是最重要的。

https://www.youtube.com/watch?v=MEFlT3dc3uc (link removed)

数据产品¶

为列表配置数据产品，可以是安全共享，也可以是 Snowflake Native App。

您可以选择对象并让 Snowflake 创建安全共享，或添加已创建的共享。有关为付费列表创建共享的指南，请参阅为列表准备共享。

将数据产品添加到您的列表时，请考虑以下事项：

安全共享只能附加到一个列表。
发布列表后，您不能附加其他共享。
您只能查看当前角色拥有的共享。
数据产品必须是可合法共享的（即您必须拥有数据或有权共享数据）。
在发布列表之前，它只能与本地/主账户中的共享相关联。发布列表后，它可以与您选择的其他区域中的共享相关联。

下表描述了 Data Product 部分中的可用字段：

字段名称	描述
数据库对象或安全共享	您要在列表中共享的数据。

数据产品 – 数据字典¶

将数据产品添加到列表后，您可以添加数据字典。数据字典可让使用者在将数据产品安装到他们的账户中之前，深入了解 Snowflake Marketplace 上提供的免费或付费列表的内容和结构。

备注

对于私密列表，此部分是可选的。

关于数据字典¶

您可以使用数据字典，让使用者可以看到您的列表内容。为列表中的表和视图生成数据字典。列表还可以包含数据预览，称为数据字典数据预览版。

您的数据有两种显示方式：

精选对象：允许使用者快速查看对象的内容。您最多可以在列表中选择五个最重要的数据库对象。
所有对象：允许使用者查看列表中的所有对象。此类对象在您发布列表时自动生成。

数据字典数据预览版可让提供商和使用者预览与列表关联的表和视图的数据。

预览版提供具有代表性的数据样本，允许：

提供商可以准确地看到预览版中可用的数据。
使用者确定列表是否包含他们正在寻找的数据。

备注

列表中的数据会自动提供预览功能。提供商无需执行任何特殊操作即可启用预览。

为您的列表设置数据字典¶

必须先将数据产品添加到列表中，然后再添加数据字典。Snowflake Marketplace 上提供的所有列表都必须包含数据字典。

要设置数据字典，请执行以下操作：

登录 Snowsight。
在导航菜单中，选择 Data Products » Provider Studio » Listings。
查找并选择要添加数据字典的列表。
选择 Save and Create Data Dictionary。

备注

保存此共享即表示，您同意允许 Snowflake 为共享创建数据字典和相关预览版，并在发布列表时向使用者显示数据字典。

请注意，当基础数据发生变化时，数据字典数据预览版会自动更新。

如果数据产品包含 PII 或其他个人数据，请屏蔽这些列。有关更多信息，包括有关如何对 PII 进行掩码处理的说明和其他个人数据，请参阅在数据预览版中掩码 PII 和其他数据。

保存列表后，将显示数据字典，列出列表中的所有表、视图和函数。
搜索或选择要作为精选对象包括的对象，然后选择 Add to featured。

（可选）重复此步骤以添加其他精选对象。一个列表中最多可以有五个精选对象。
选择 Save。

您可以在 Provider Studio 中编辑表的列说明，也可以使用 SQL。在 CREATE <object> 和 ALTER <object> 命令中使用 COMMENT 参数，或在 COMMENT 命令中添加描述对象或 `单个表列`_的注释。

在数据预览版中掩码 PII 和其他数据¶

要掩码 PII 和其他使用字典预览版的数据时，请执行以下操作：

按照创建和发布列表中所述创建列表。

请务必先选择 This data product contains private data，然后保存列表。
在 Data Production 部分中，选择数据字典旁边的 Add。
导航到包含 PII 的数据对象，然后选择 Columns 选项卡。
对于包含 PII 的每一列，选中 Name 列左侧的私有数据复选框。
如果数据对象应该是数据预览版的一部分，请选择 Add to Featured。
完成后选择 Save。
（可选）选择 Preview 以检查生成的数据字典预览版。
对于给定的数据对象，请选择 Data Preview 选项卡以查看现在包括掩码数据的预览内容。

备注

为列表启用数据字典时，会生成数据预览内容。

生成数据时，单个表和视图的预览数据可能无法立即可用。

请注意，当基础数据发生变化时，数据字典数据预览版会自动更新。

数据预览刷新¶

如果您在列表中添加或移除对象，或更改对象的架构，则关联的数据预览将刷新（如果启用）。

更新对象数据不会导致数据预览刷新。

备注

数据预览大约每隔几小时自动刷新一次。在添加或移除对象或更新架构后，您可能无法立即看到刷新的预览。

数据产品 – 属性¶

指定数据产品后，您可以为列表定义其他属性。

备注

对于私密列表，此部分是可选的。

下表描述了数据产品的 Attributes 部分中的可用字段：

字段名称	描述
Update Frequency	数据产品在 Snowflake 中的更新频率。如果数据产品以不同的频率更新，请为数据产品选择最高更新频率。
Geographic Coverage	选择数据产品覆盖的一个或多个地理区域。如果适用，请选择特定国家/地区或美国某州。
Geographic Granularity	如果指定全球或多个州或国家/地区作为数据集的地理覆盖范围，请为数据产品选择精细度。只能选择一个选项，因此请选择数据产品中可用的最精细的选项。
Time Range	指定您的数据产品涵盖的时间段。您可以将自定义日期指定为固定时间范围 (2020-01-01 – 2021-01-01) 或动态时间范围（未来/过去 X 天、周、月或年）。
Timestamp Granularity	如果指定时间范围，请为数据产品选择时间戳精细度。只能选择一个选项，因此请在数据产品中选择最精细的时间戳类型。
Additional attributes （可选）	您希望传达给使用者的任何其他信息。您最多可以包含 4 个其他数据属性。每个属性使用 2-5 个单词，以最大限度地提高可读性。每个属性必须少于 80 个字符。

访问和定价 – 列表访问¶

对于 Snowflake Marketplace 上提供的列表，您可以查看列表的 Listing Access，如果列表仍处于草稿状态，则可以对其进行修改。

列表访问权限控制使用者如何访问您的数据产品。有关更多详细信息，请参阅列表访问选项。

访问和定价 – 试用¶

为在 Snowflake Marketplace 上提供的受限试用列表添加试用版。要为付费列表添加试用版，请参阅访问和定价 – 定价和试用。

备注

对于受限试用列表，此选项是必需的。

下表描述了 Trial 部分中的可用字段：

字段	描述
Trial Type	选择要提供的试用类型： Limited time。使用者可以在有限的时间内试用您的数据产品。如果在短时间内向使用者提供整个数据产品，请选择此选项。 Unlimited time。使用者可以无限期地试用您的数据产品。如果您提供完整数据产品的样本，请选择此选项。例如，仅一个城市的天气数据，而您的完整数据产品包括整个国家/地区的天气数据。如果您的列表将应用程序包作为数据产品，您还可以从其他两种试用类型中进行选择： Limited functionality。使用者可以访问应用程序包的有限功能。 Limited functionality and time。使用者可以在有限的时间内访问应用程序包的有限功能。小心您必须使用 SYSTEM$IS_LISTING_TRIAL 系统功能来限制应用程序的功能。如果您选择了有限的功能试用，并且您的应用程序包未设置为限制共享数据内容或应用程序逻辑中的功能，则您的应用程序将向试用使用者提供全部功能。请参阅限制试用使用者使用 Snowflake Native App 的功能了解有关完全配置有限功能试用版的详细信息。

字段

描述

Trial Type

选择要提供的试用类型：

Limited time。使用者可以在有限的时间内试用您的数据产品。如果在短时间内向使用者提供整个数据产品，请选择此选项。
Unlimited time。使用者可以无限期地试用您的数据产品。如果您提供完整数据产品的样本，请选择此选项。例如，仅一个城市的天气数据，而您的完整数据产品包括整个国家/地区的天气数据。

如果您的列表将应用程序包作为数据产品，您还可以从其他两种试用类型中进行选择：

Limited functionality。使用者可以访问应用程序包的有限功能。
Limited functionality and time。使用者可以在有限的时间内访问应用程序包的有限功能。

小心

您必须使用 SYSTEM$IS_LISTING_TRIAL 系统功能来限制应用程序的功能。

如果您选择了有限的功能试用，并且您的应用程序包未设置为限制共享数据内容或应用程序逻辑中的功能，则您的应用程序将向试用使用者提供全部功能。

请参阅限制试用使用者使用 Snowflake Native App 的功能了解有关完全配置有限功能试用版的详细信息。

访问和定价 – 定价和试用¶

在此部分中添加付费列表的定价方案和试用版。

此部分是 Snowflake Marketplace 上提供的付费列表的必填项，但付费私密列表没有强制性试用要求。

备注

只有账户管理员（具有 ACCOUNTADMIN 角色的用户）或列表所有者（对列表具有 OWNERSHIP 权限的角色）才能完成此部分。

下表描述了 Trial & Pricing 部分中的可用字段：

字段	描述
Pricing Plan	选择列表的定价方案。请参阅付费列表定价模式。价格仅以 US 美元为单位。
Free Trial	选择列表的试用类型：时间受限：此选项允许使用者在指定的时间段（1、7、30、60 或 90 天）内参与免费试用。最长试用期为 90 天。试用期结束后，使用者账户将失去对数据产品的访问权限。同一组织中的其他账户可以对您的列表进行新的试用。功能受限：此选项允许使用者参与免费试用，但付费数据产品的功能有限。在使用者升级到付费列表之前，此试用模式不会过期。功能和时间受限：此选项允许使用者在指定的期限（1、7、30、60 或 90 天）内参与免费试用。试用版提供的数据产品功能有限，试用期结束时，执行试用的账户将失去对数据产品的访问权限。

字段

描述

Pricing Plan

选择列表的定价方案。请参阅付费列表定价模式。价格仅以 US 美元为单位。

Free Trial

选择列表的试用类型：

时间受限：此选项允许使用者在指定的时间段（1、7、30、60 或 90 天）内参与免费试用。最长试用期为 90 天。试用期结束后，使用者账户将失去对数据产品的访问权限。同一组织中的其他账户可以对您的列表进行新的试用。
功能受限：此选项允许使用者参与免费试用，但付费数据产品的功能有限。在使用者升级到付费列表之前，此试用模式不会过期。
功能和时间受限：此选项允许使用者在指定的期限（1、7、30、60 或 90 天）内参与免费试用。试用版提供的数据产品功能有限，试用期结束时，执行试用的账户将失去对数据产品的访问权限。

业务需求¶

添加您的数据产品可以帮助使用者满足的业务需求。

备注

对于私密列表，此部分是可选的。

下表描述了 Business Needs 部分中的可用字段：

字段名称	描述	示例
Business Need	通过指定数据产品所满足的相关业务需求，帮助使用者在 Snowflake Marketplace 上找到您的列表。您最多可以选择六个相关的业务需求。如果您在下拉列表中没有看到相关的业务需求，则可以使用 2-4 个单词创建自定义需求。但是，使用者无法按 Snowflake Marketplace 上的自定义业务需求进行筛选。您可以随时编辑业务需求列表，而无需重新提交列表以供审批。	位置数据扩充
Description	使用特定于客户用例或业务需求的示例，说明您的列表如何满足所选业务需求。为每个业务需求添加唯一的描述。	位置数据扩充：识别与给定县、人口普查区或核心统计区域相关联的所有邮政编码。

字段名称

描述

示例

Business Need

通过指定数据产品所满足的相关业务需求，帮助使用者在 Snowflake Marketplace 上找到您的列表。您最多可以选择六个相关的业务需求。

如果您在下拉列表中没有看到相关的业务需求，则可以使用 2-4 个单词创建自定义需求。但是，使用者无法按 Snowflake Marketplace 上的自定义业务需求进行筛选。

您可以随时编辑业务需求列表，而无需重新提交列表以供审批。

位置数据扩充

Description

使用特定于客户用例或业务需求的示例，说明您的列表如何满足所选业务需求。

为每个业务需求添加唯一的描述。

位置数据扩充：识别与给定县、人口普查区或核心统计区域相关联的所有邮政编码。

示例 SQL 查询¶

您可以指定有效的示例 SQL 查询，使用者可以使用这些查询从数据产品中获得价值，或者至少验证数据产品是否已成功安装在其 Snowflake 账户中。

备注

至少需要一个有效的 SQL 查询才能在 Snowflake Marketplace 上发布列表。建议包含 3 到 4 个示例查询。

发布私密列表时，SQL 查询是可选选项。

示例 SQL 具有以下要求：

查询必须至少返回一行。
查询必须引用共享中显式存在的对象。
必须使用 SCHEMA.OBJECT 限定对象。请勿包含数据库名称。例如 EXAMPLE_SCHEMA.TABLE_A。

选择 Add 可添加一个 SQL 查询。下表描述了 Sample SQL Queries 部分中的可用字段：

字段名称	描述	示例
Title	查询的描述性标题，可帮助使用者了解如何使用数据产品。	确定户外活动是否会受到雨水的影响。
Description (Optional)	将标题与数据产品的特定用例相关联的示例的说明。当使用者在安装数据产品后运行示例查询时，描述会自动加载为注释。您还可以包含其他说明，例如架构的名称、示例表或字段。在引用 SQL 中的表和视图时，请使用 <schema>.<table> 格式。请勿在查询中包含数据库名称，因为使用者在获取列表时会创建自定义数据库名称。	如果您将在未来 7 天内举办户外活动，请使用我们的预报数据来确定该活动是否可能受到降雨的影响。
SQL Query	示例 SQL 查询的代码。查询应直接回答标题和描述。 Snowflake 会自动验证您的示例查询。若要有效，示例查询必须至少返回一行。如果查询验证失败，您可以保存列表，但在成功验证所有示例查询之前，无法发布列表。您必须选择用于验证 SQL 查询的仓库。

字段名称

描述

示例

Title

查询的描述性标题，可帮助使用者了解如何使用数据产品。

确定户外活动是否会受到雨水的影响。

Description (Optional)

将标题与数据产品的特定用例相关联的示例的说明。当使用者在安装数据产品后运行示例查询时，描述会自动加载为注释。您还可以包含其他说明，例如架构的名称、示例表或字段。

在引用 SQL 中的表和视图时，请使用 <schema>.<table> 格式。

请勿在查询中包含数据库名称，因为使用者在获取列表时会创建自定义数据库名称。

如果您将在未来 7 天内举办户外活动，请使用我们的预报数据来确定该活动是否可能受到降雨的影响。

SQL Query

示例 SQL 查询的代码。查询应直接回答标题和描述。

Snowflake 会自动验证您的示例查询。若要有效，示例查询必须至少返回一行。

如果查询验证失败，您可以保存列表，但在成功验证所有示例查询之前，无法发布列表。您必须选择用于验证 SQL 查询的仓库。

区域可用性（仅限 Marketplace 列表）¶

下表描述了 Region Availability 部分中的可用字段。

字段名称	描述
Region Availability	默认情况下，您的列表在 All regions 中可用。选择所有区域可确保您的列表在 Snowflake 未来添加的任何区域中的可用性。对于付费列表，选择此选项将使列表在支持的区域以及 Snowflake 未来添加的任何支持区域中可用。如果您的列表有特定的区域限制，请选择 All regions 将区域可用性更改为 Custom regions，并选择您想要提供数据产品的区域。当您选择自定义区域时，您的列表在所有当前 Snowflake Marketplace 区域中仍都可见，但使用者只能在您指定的区域获取您的数据产品。
Fulfillment method	默认情况下选择 Automatic 履行。通过 Cross-Cloud Auto-Fulfillment，您的数据产品会自动履行到某个区域，并且仅当该区域有使用者需求时才会产生成本。使用自动履行时，还必须选择更新与使用者共享的数据产品的刷新频率。您必须选择最多 8 天的刷新频率。如果您的数据产品是 Snowflake Native App，则只能在账户级别设置刷新频率。有关自动履行的更多信息，请参阅配置 Cross-Cloud Auto-Fulfillment。如果您无法使用自动履行，请选择 Manual 手动复制您的数据产品。要满足请求，您必须在具有使用者需求的区域设置账户，手动将产品复制到每个账户，在每个账户中创建安全共享，并将这些共享附加到此列表。请参阅手动复制数据以履行列表请求。

字段名称

描述

Region Availability

默认情况下，您的列表在 All regions 中可用。选择所有区域可确保您的列表在 Snowflake 未来添加的任何区域中的可用性。对于付费列表，选择此选项将使列表在支持的区域以及 Snowflake 未来添加的任何支持区域中可用。

如果您的列表有特定的区域限制，请选择 All regions 将区域可用性更改为 Custom regions，并选择您想要提供数据产品的区域。当您选择自定义区域时，您的列表在所有当前 Snowflake Marketplace 区域中仍都可见，但使用者只能在您指定的区域获取您的数据产品。

Fulfillment method

默认情况下选择 Automatic 履行。通过 Cross-Cloud Auto-Fulfillment，您的数据产品会自动履行到某个区域，并且仅当该区域有使用者需求时才会产生成本。

使用自动履行时，还必须选择更新与使用者共享的数据产品的刷新频率。您必须选择最多 8 天的刷新频率。如果您的数据产品是 Snowflake Native App，则只能在账户级别设置刷新频率。

有关自动履行的更多信息，请参阅配置 Cross-Cloud Auto-Fulfillment。

如果您无法使用自动履行，请选择 Manual 手动复制您的数据产品。要满足请求，您必须在具有使用者需求的区域设置账户，手动将产品复制到每个账户，在每个账户中创建安全共享，并将这些共享附加到此列表。请参阅手动复制数据以履行列表请求。

使用者账户（仅限私密列表）¶

要向特定使用者发布列表，您必须为要与之共享的账户指定账户标识符：

字段名称	描述	示例
Consumer Accounts	指定要与之共享私密列表的 Snowflake 账户。您可以使用 Snowflake 账户标识符或 URLs。有关详细信息，请参阅查找账户的组织和账户名称。	`ORGABC.ACCOUNT123` `https://<organization_name>-<account_name>.snowflakecomputing.cn`

如果您要与和您的账户位于不同区域的使用者账户共享，则还必须设置自动履行：

字段名称	描述
Auto-fulfillment	选择数据产品的复制间隔和频率。例如，可以将复制配置为每两小时进行一次。如果数据产品是应用程序包，则只能在账户级别设置刷新频率和间隔。

有关更多信息，请参阅配置 Cross-Cloud Auto-Fulfillment。