创建并发布列表

本主题包含创建列表和私密发布列表或在 Snowflake Marketplace 上发布列表的过程。

本主题内容：

创建列表的先决条件

要详细了解关于成为提供商的要求，请参阅 以提供商身份使用列表。

将列表共享给 US 政府区域内的账户的注意事项

希望与 US 政府区域内的使用者账户共享列表的非政府提供商必须注意以下详细信息：

  • US 政府区域内的账户必须启用数据共享和协作。请参阅 准备访问美国政府区域账户中的列表。

  • 您必须使用 Cross-Cloud Auto-Fulfillment，并且数据产品只能包含或引用 `自动履行支持的对象 `_。

  • 如果您在 Snowflake Marketplace 上向 US 政府区域提供列表，或直接向 US 政府区域 内的使用者账户提供列表，则为自动履行向该区域提供的列表而创建的安全共享区 (SSA) 会按照该区域的特定费率产生费用。请参阅 Snowflake Legal 提供的消耗表、定价指南 和 自动履行成本。

使用私密列表与特定使用者共享数据或应用程序

您可以创建免费或付费列表，以直接与特定使用者共享。您可以创建私密列表，以满足对受限试用列表的要求，或与已建立业务关系的使用者共享数据或应用程序。

您必须知道使用者的账户标识符，才能与其共享列表。请参阅 查找账户的组织和账户名称。

备注

您的角色必须具有创建列表所需的权限。请参阅 处理列表所需的权限。

创建免费（或平台外付费）专用列表

  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，以选择要附加到列表的对象。

    • 如果您选择了一个或多个数据库对象，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 区域中，选择以下使用情况试用类型之一：

    • 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。

将 Direct Share 转换为免费（或平台外付费）专用列表

您可以将 Direct Share 转为免费（或平台外付费）专用列表，或转为在 Snowflake Marketplace 上发布的列表。在执行此操作时：

  • 现有使用者仍可使用该共享。

  • 从发布列表之日起，您就可以访问使用情况分析数据。没有历史使用情况数据。

  • 如果尚未为共享中的对象使用复制，并且共享只包含自动履行支持的对象，则可以使用自动履行与远程区域的使用者共享。请参阅 支持自动履行的对象。

  • 如果您的共享有活跃的使用者，则不能将共享转换为付费列表。

如果决定使用自动履行来支持共享的远程使用者，请与数据的远程使用者协调以下工作流程：

  • 发布列表后，让远程区域的使用者知道如何访问列表。请参阅 访问私密列表。

  • 远程区域的使用者收到您的列表后，自动履行功能会将数据复制到远程区域。请参阅 支持自动履行的对象。

  • 自动履行完成后，使用者会收到一封电子邮件，指明数据可用。此时，使用者必须采取以下措施：

    • 删除从 Direct Share 创建的现有导入数据库。

    • 获取列表并创建数据库，使用与从 Direct Share 导入的数据库相同的名称。

将您的直接共享设置为列表后，您可以使用 Provider Studio 来管理和修改您的列表。请参阅 修改已发布的列表 和 监控列表使用。

在 Snowflake Marketplace 上共享数据或应用程序

备注

创建付费列表并在 Snowflake Marketplace 上发布之前，请联系您的 Snowflake 业务发展合作伙伴。如果您没有业务发展合作伙伴，请 向 Marketplace Operations 提交工单 (https://snowflakecommunity.force.com/s/provider-onboarding-case)。这一步骤是列表审批的必要条件。

备注

您的角色必须具有创建列表所需的权限。请参阅 处理列表所需的权限。

  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. 使用经批准的:ref:简介 <label-set_up_access_listings>，创建您的 列表 manifest.yml。

  2. 在清单文件中，添加 compliance_badges 字段并为每种认证类型添加一行；例如：

    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 将文件上传到暂存区，请按照 使用 Snowsigh 的暂存文件 中的步骤进行操作。

  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. 要使用您上传到暂存区的清单文件创建列表，请使用 CREATE LISTING；例如：

    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 Contact 和 Technical 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 Settings 的 Publishing 部分中，选择 Edit Publishing。

  6. 在 Publish Setting 窗口中，选择 Manual。

  7. 选择 Save。

列表将不再自动发布。现在，对列表进行更改后，必须手动发布列表。请参阅 `发布列表`_。

将笔记本附加到 Snowflake Marketplace 列表中

提供商可以在列表中添加笔记本，向潜在使用者展示他们如何利用数据产品并从中受益。这些列表可以在 Snowflake Public Marketplace、Internal Marketplace 上提供，也可以作为专用列表提供给特定使用者。

提供商可以将已完全运行并附有结果的笔记本附加到列表中。结果可以包括表格输出或可视化，以描述列表中数据产品的值。提供商可以在笔记本中包含基于 Python 和基于 SQL 的示例，并添加清晰的 Markdown 解释以指导使用者。

备注

附在列表上的笔记本仅供查看，使用者无法克隆、下载这些笔记本或与之互动。

要将笔记本附加到列表，请执行以下步骤：

  1. 登录 Snowsight。

  2. 在左侧导航菜单中，选择 Projects » Notebooks。

  3. 创建笔记本。

  4. 在笔记本的每个单元格中，选择 Run all 或 Run 以生成结果。确保在每个单元格中运行。

  5. 要验证笔记本是否成功运行，请找到绿色的运行状态指示灯。

  6. 要结束笔记本会话，请选择 Active 下拉列表并选择 End session。

  7. 选择 Data Products » 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。

备注

如果您失去了笔记本的所有权，或者将其删除或从共享资源中移除，则列表中仍会保留一份副本。

限制

  • 提供商只能将一个笔记本附加到列表中，并且提供商必须对该笔记本具有 OWNERSHIP 权限。

  • 消费者只能在列表中查看笔记本及其结果。

  • 笔记本中的更改不会在列表中自动更新。要反映最新的更改，必须移除笔记本并重新添加。

语言: 中文