创建并发布列表

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

本主题内容：

创建列表的先决条件

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

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

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

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

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

You must know a consumer's account identifier to share a listing with them. See 查找账户的组织和账户名称.

备注

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

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

  1. 登录 Snowsight。

  2. In the navigation menu, select Data sharing » Provider Studio.

  3. Select + Create Listing » Specified Consumers.

  4. In the Edit listing title dialog, enter a name for your listing.

  5. Select the Add data product button, then click + Select to select the objects to attach to the listing.

    • 如果您选择了一个或多个数据库对象，Snowflake 将创建一个包含此类对象的安全共享。您可以更改安全共享的名称。

    • 如果选择现有安全共享，则显示该共享的名称。

  6. In the Access type dropdown, select Free.

  7. In the Who can access section, add the organization and account names for the consumers that you want to share the listing with.

    1. If you add a consumer account in a region that isn't your local region, Snowflake enables auto-fulfillment to replicate data to the remote region after a consumer gets your listing. Complete the following additional steps:

      1. In the Auto-fulfillment section, enter a value and select an interval to specify how often to replicate your data product from your region to the remote region.

      2. 如果您没有设置默认仓库，请选择一个仓库以用于自动履行。

  8. 输入列表的描述。

  9. 在 Legal Terms 部分中，选择适用于您的列表的法律条款。

    如果您未看到任何法律条款，则必须先接受 Snowflake 提供商和使用者条款。

  10. （可选）在 Attributes 部分中，向您的列表中添加自定义属性。有关更多信息，请参阅 数据产品 – 属性。

  11. （可选）点击 Data dictionary 部分以添加列表数据字典中的特色对象。有关更多信息，请参阅 为您的列表设置数据字典。

  12. （可选）点击 Business needs 部分，添加描述数据产品满足的业务需求的标签。有关更多信息，请参阅 业务需求。

  13. （可选）点击 Quick Start Examples 部分，添加示例 SQL 查询或演示如何使用数据产品的笔记本。有关更多信息，请参阅 将笔记本附加到 Snowflake Marketplace 列表中。

  14. Select Publish to publish the listing to the selected consumers. Snowflake saves your listing if you don't publish it immediately.

创建付费私密列表

  1. 登录 Snowsight。

  2. In the navigation menu, select Data sharing » Provider Studio.

  3. Select + Create Listing » Specified Consumers.

  4. In the Edit listing title dialog, enter a name for your listing.

  5. Select the Add data product button, then click + Select to select the objects to attach to the listing.

    • 如果您选择了一个或多个数据库对象，Snowflake 将创建一个包含此类对象的安全共享。您可以更改安全共享的名称。

    • 如果选择现有安全共享，则显示该共享的名称。

  6. In the Access type dropdown, select Free.

  7. In the Who can access section, add the organization and account names for the consumers that you want to share the listing with.

    • If you add a consumer account in a region that isn't your local region, Snowflake enables auto-fulfillment to replicate data to the remote region after a consumer gets your listing. Complete the following additional steps:

      1. In the Auto-fulfillment section, enter a value and select an interval to specify how often to replicate your data product from your region to the remote region.

      2. 如果您没有设置默认仓库，请选择一个仓库以用于自动履行。

  8. 输入列表的描述。

  9. 在 Legal Terms 部分中，选择适用于您的列表的法律条款。

    如果您未看到任何法律条款，则必须先接受 Snowflake 提供商和使用者条款。

  10. （可选）在 Attributes 部分中，向您的列表中添加自定义属性。有关更多信息，请参阅 数据产品 – 属性。

  11. （可选）点击 Data dictionary 部分以添加列表数据字典中的特色对象。有关更多信息，请参阅 为您的列表设置数据字典。

  12. （可选）点击 Business needs 部分，添加描述数据产品满足的业务需求的标签。有关更多信息，请参阅 业务需求。

  13. （可选）点击 Quick Start Examples 部分，添加示例 SQL 查询或演示如何使用数据产品的笔记本。有关更多信息，请参阅 将笔记本附加到 Snowflake Marketplace 列表中。

  14. 点击 Pricing 部分，为您的列表设置定价信息。有关定价方案和报价的更多信息，请参阅 定价方案和要约。

    1. In the Pricing plans tab, select Create pricing plan.

    2. In the Settings dialog, specify a display name for your pricing plan, then click Next.

    3. 在 Pricing details 对话框中，指定定价模式。您可以选择 Usage-based 或 Flat fee。

      • 如果选择 Usage-based，请指定以下详细信息：

        • 基于使用量的访问费（月费）。

        • The cost per query and the number of included queries (optional).

        • 最高月费（可选）。

      • 如果您选择 Flat fee，请指定固定费用金额和计费频率。

    4. Click Next.

    5. 在 Summary 对话框中，查看定价详情，然后点击 Done。

  15. 导航到 Offers 选项卡。

    1. In the Offers tab, select + Create offer.

    2. 在 Offer details 对话框中，指定报价的详细信息。

      1. Select Standard offer

      2. 在 Purchase type 下拉列表中，选择 Self-serve 以允许使用者查看定价并直接购买列表，或选择 Sales-led 以要求使用者联系您购买列表。

      3. 指定报价的名称。

      4. 选择 Next。

    3. 在 Billing and payments 对话框中，选择要附加到此报价中的定价方案。

      1. 在 Select a pricing plan 下拉列表中，选择您之前创建的定价方案。

      2. 选择 Limited-time 或 Recurring (Subscription) 的合同类型。

      3. 指定合同期限。

      4. 在 Payment options 下拉列表中，选择是根据定价方案向客户收费还是允许分期付款。

        • 如果选择 Accept installments，请指定分期付款的期数和分期付款频率。

      5. 指定第一张发票的开具日期或在接受报价时开具发票。

      6. （可选）指定是否要求使用者存档信用卡信息才能购买列表

      7. 选择 Next。

    4. In the Description dialog, enter information about the offer that users will see.

      1. 指定要向使用者显示的报价名称。

      2. 指定要向使用者显示的价格。

      3. （可选）指定要向使用者显示的标语。

      4. 指定使用者点击购买列表的按钮的文本。

      5. （可选）指定报价的任何价值主张。

    5. 选择 Next。

  16. 返回 Listing details 选项卡。您将看到您创建的报价现已附加到列表中。

  17. Select Publish to publish the listing to the selected consumers.

    如果您未发布就退出，则列表将另存为草稿。

创建基于使用情况的试用

在基于使用情况的试用中，您可以提供许多免费查询，使用者可以针对您的数据产品运行这些查询。在使用完所有免费查询后，使用者必须购买数据产品才能运行其他查询。

要向列表中添加试用，列表必须附加数据产品，并且您必须拥有该列表的 ACCOUNTADMIN 角色或 OWNERSHIP 权限。要详细了解有关管理列表所需的权限，请参阅 为列表准备数据。

  1. 创建包含定价方案和报价的列表，如前面的示例所示。

  2. On the Listing details tab, click in the Trial (Optional) area, and select one of the following usage trial types:

    • :ui:`Limited Usage`（仅适用于基于使用量的定价方案）

    • Limited Time

    • Limited Functionality

    • Limited Functionality & Time

  3. 如果您选择了 Limited Usage，请在 Number of Free Queries During Trial 字段中输入值。

  4. 如果您选择了 Limited Time 或 Limited Functionality & Time，请在 Length of Trial 字段中输入值。

  5. 选择 Save。

  6. Select Publish to publish the listing to the selected consumers.

    如果您未发布就退出，则列表将另存为草稿。

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

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

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

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

  • You can use auto-fulfillment to share with consumers in remote regions if you are not already using replication for the objects in your share and if your share only contains objects supported by auto-fulfillment. See 支持自动履行的对象.

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

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

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

  2. After the consumers in remote regions get your listing, auto-fulfillment replicates the data to the remote region. See 支持自动履行的对象.

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

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

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

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

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

备注

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

To share data or apps on the Snowflake Marketplace, your role must have the required privileges to create a listing. See 处理列表所需的权限.

  1. 登录 Snowsight。

  2. In the navigation menu, select Data sharing » Provider Studio.

  3. Select + Create Listing » Snowflake Marketplace.

  4. 在 Create Listing 窗口中，输入列表的名称。

  5. Enter a subtitle and select a profile for your listing.

  6. Select the Add data product button, then click + Select to select the share data or apps to attach to the listing.

  7. In the Access type dropdown, select one of the following options:

    • Free，向使用者免费提供数据产品。

    • Limited trial，提供数据产品试用版，并可根据请求无限制地访问数据产品。

    • Paid on Snowflake，为您基于 Snowflake 的数据产品收费。

  8. Configure the remaining listing fields to prepare it for publishing.

  9. 提交列表以供审批和发布。

作为 Snowflake Marketplace 提供商，在 Virtual Private Snowflake (VPS) 部署中创建列表

如果您是 Snowflake Marketplace 提供商，请按照以下步骤在 VPS 部署中创建 V2 列表：

  1. 登录 Snowsight。

  2. In the navigation menu, select Data sharing » Provider Studio.

  3. 选择 + Create Listing » Snowflake Marketplace。

  4. 在 Create Listing 窗口中，输入列表的名称。

  5. Select Add data product.

  6. In the Data product, click + Select to select the objects to attach to the listing.

  7. In the Access type dropdown, select one of the following options:

    • Free，向使用者免费提供数据产品。

    • Limited trial，提供数据产品试用版，并可根据请求无限制地访问数据产品。

    • Paid on Snowflake，为您基于 Snowflake 的数据产品收费。

  8. 滚动到 Region Availability 部分并选择 Set region availability。

    1. 默认情况下，区域可用性设置为 All Regions。要更改此设置，请选择 All regions 编辑按钮，然后选择 Custom regions。

    2. 点击 Select regions，然后选择您希望在其中发布列表的 区域组。

      查看区域组和区域。在 VPS 中已部署区域组的区域会带有信息图标标识。

      将鼠标悬停在该图标上可查看有关部署的信息。

      在已部署 VPS 的区域中提供的列表可能会产生额外的履约费用。

      有关自动履行如何产生成本的更多信息，请参阅 自动履行如何产生成本。

      备注

      如果提供商不想定位 VPS 区域，他们可以打开工作表，并在列表清单中替换各个区域名称中的区域分组名称。

    3. Select Done.

  9. 配置列表，为发布做好准备。

  10. 提交列表以供审批和发布。

作为 VPS 提供商，请在 Snowflake Marketplace 中创建列表

如果您是 VPS 提供商，请按照以下步骤创建可在 Snowflake Marketplace 中发布的 V2 列表：

备注

VPS 提供商无法创建付费列表。

  1. 登录 Snowsight。

  2. In the navigation menu, select Data sharing » Provider Studio.

  3. Select + Create Listing » Snowflake Marketplace.

  4. 在 Create Listing 窗口中，输入列表的名称。

  5. Select Add data product.

  6. In the Data product, click + Select to select the objects to attach to the listing.

  7. In the Access type dropdown, select one of the following options:

    • Free，向使用者免费提供数据产品。

    • Limited trial，提供数据产品试用版，并可根据请求无限制地访问数据产品。

  8. 滚动到 Region Availability 部分并选择 Set region availability。

    1. 默认情况下，区域可用性设置为 All Regions。要更改此设置，请选择 All regions 编辑按钮，然后选择 Custom regions。

    2. 点击 Select regions，然后选择您希望在其中发布列表的 区域组。

      查看区域组和区域。在 VPS 中已部署区域组的区域会带有信息图标标识。

      将鼠标悬停在该图标上可查看有关部署的信息。

      在已部署 VPS 的区域中提供的列表可能会产生额外的履约费用。

      有关自动履行如何产生成本的更多信息，请参阅 自动履行如何产生成本。

      备注

      如果提供商不想定位 VPS 区域，他们可以打开工作表，并在列表清单中替换各个区域名称中的区域分组名称。

    3. 配置履行方式。默认情况下，履行方式设置为 Automatic。

    4. Select Done.

  9. 配置列表，为发布做好准备。

  10. 提交列表以供审批和发布。

在 Snowflake Marketplace 上创建包含合规徽章的列表

备注

目前，创建包含合规徽章的列表只能通过列表 APIs 来完成。

要创建包含 合规徽章 的清单，请按照以下步骤操作：

  1. Using an approved profile, create your listing 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. Install and configure 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

    备注

    To use Snowsight to upload files to a stage, follow the steps in Staging files using Snowsight.

  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. To create a listing by using the manifest file you uploaded to the stage, use CREATE LISTING; for example:

    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. In the navigation menu, select Data sharing » Provider Studio.

  3. 选择 Listings 选项卡，然后选择要配置的列表草稿。

  4. 选择页面上显示的每个部分旁边的 Add，并提供所需信息。

    为每个部分提供信息时，请参阅 配置列表，以了解每个字段的信息。可编辑的具体属性取决于您创建的列表类型。

发布列表

创建和配置列表后，即可发布列表。

发布列表的具体过程取决于您要发布免费（或平台外付费）专用列表、提供付费私密列表，还是在 Snowflake Marketplace 上提供任何列表：

要发布列表，必须使用 ACCOUNTADMIN 角色或其他具有待发布列表的 OWNERSHIP 权限的角色。

发布列表时，所有当前和未来 Marketplace 区域的使用者都能看到该列表，但使用者只能在您选定区域中获取、购买或请求产品。

向特定使用者发布列表

要与特定使用者账户共享私密列表，您必须向这些账户发布列表。私密列表不会出现在 Snowflake Marketplace 上。

  1. 登录 Snowsight。

  2. In the navigation menu, select Data sharing » 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. In the navigation menu, select Data sharing » Provider Studio.

  3. 选择 Listings 选项卡，然后选择要提交审批的列表草稿。

  4. 选择 Submit for Approval。

  5. 列表经过 Snowflake 审查后，状态将变为 Approved 或 Denied。

    如果列表被拒绝，请根据评论中提供的反馈意见更新列表，然后重新提交审批。

    当列表被批准或拒绝时，系统会向与列表相关的提供商简介中的 Business Contact 和 Technical Contact 电子邮件地址发送电子邮件通知。

发布列表

  1. 登录 Snowsight。

  2. In the navigation menu, select Data sharing » Provider Studio.

  3. 选择 Listings 选项卡，然后选择要发布的已批准列表。

  4. 选择 Publish。

首次发布 Snowflake Marketplace 列表后，需要 Snowflake 审批的列表后续变更将在获批后自动发布。要禁止自动发布列表，请参阅 停用自动发布。

When you publish a listing, it is visible to consumers in all current and future Snowflake Marketplace regions. Consumers can only get, purchase, or request your product in regions you select. See 列表的自动履行 for more about region availability.

发布 Snowflake Marketplace 列表后，您可以为列表定义 推荐链接。通过推荐链接，使用者可直接链接到相应列表。

停用自动发布

发布列表后，您可以停用自动发布功能，以便日后更改列表。

  1. 登录 Snowsight。

  2. In the navigation menu, select Data sharing » 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. In the navigation menu, select Projects » Notebooks.

  3. Create a notebook.

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

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

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

  7. In the navigation menu, select Data sharing » Provider Studio. You can attach a notebook to all listing types.

  8. 创建新列表 或选择现有列表。

  9. 选择 + Add data product。

  10. 选择 + Select。

  11. 在 Quick Start Examples 部分中，选择 Add Notebook。

  12. 选择要附加的笔记本。您可以使用搜索功能来查找特定的笔记本。

  13. 选择 Save。

  14. 要将列表发布给选定的使用者，请选择 Publish。

备注

要在将笔记本附加到列表后更新其内容，必须将该笔记本从列表中移除并重新附上。

从列表中移除笔记本

  1. In the navigation menu, select Data sharing » Provider Studio.

  2. 在 Quick Start Examples 部分中，选择要移除的笔记本。

  3. 选择 Remove Notebook。

备注

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

将笔记本附加到列表中的限制

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

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

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

语言: 中文