修改已发布的列表

本主题介绍如何在列表发布到 Snowflake Marketplace 或作为私密列表与使用者共享后对其进行修改。

本主题内容:

编辑列表所需的权限

To modify listings, you must be the listing owner or have the MODIFY privilege on a listing. See 列表的 MODIFY 权限.

编辑在 Snowflake Marketplace 上发布的列表

编辑在 Snowflake Marketplace 上发布的列表时,请考虑以下事项:

  • 在您编辑 Snowflake Marketplace 上发布的列表时,系统会创建一个新的草稿列表。要使这些更改可供使用者使用,您必须重新提交草稿列表以供批准和发布。

  • 在编辑可用区域和业务需求字段时,无需获得批准。您可以随时进行这些更改。

  • 如果移除以前可用的区域,则该区域中的使用者将无法再访问共享数据集。

  • 当发布新版本的列表时,以前的版本将被替换并且无法恢复。

如果您想更新与列表关联的数据产品,请参阅 更新数据共享

要编辑在 Snowflake Marketplace 上发布的列表,请完成以下步骤:

  1. 登录 Snowsight

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

  3. 选择 Listings,然后选择您要编辑的列表。

    • 要添加或移除列表可用的区域,请点击 Region Availability 部分中的 Edit。您可以跳过其余步骤,因为不需要获得管理员批准。

    • 要更改其他字段,例如列表描述,请点击适用部分中的 Edit,然后在出现提示时选择 Continue。这将创建一个新的草稿列表,在提交、批准和发布之前,使用者无法看到该草稿。

    • 如果您有正在进行的现有更改,请选择列表标题旁边的 New Draft 切换键,以继续处理现有草稿。您可以选择页面右上角的 Delete 按钮,放弃此草稿。

  4. 当您准备好提交新的草稿列表以供审核时,请选择 Submit for Approval

编辑私密列表

您可以在 Provider Studio 中编辑草稿或已发布的私密列表。如果您编辑已发布的私密列表,则您所做的任何更改在保存后将立即可供使用者使用。

如果您想更新与列表关联的数据产品,请参阅 更新数据共享 以获得指导。

要编辑私密列表,请执行以下步骤:

  1. 登录 Snowsight

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

  3. 选择 Listings,然后选择您要编辑的列表。

  4. 进行所需的更改,然后点击 Save

作为 Snowflake Marketplace 提供商,编辑现有 Snowflake Marketplace 列表以使其在 VPS 部署中可用

备注

此功能默认禁用。提供商必须联系 Snowflake 支持部门才能启用此功能。有关更多信息,请参阅 VPS 部署中的 Snowflake Marketplace 版本 2 列表

  1. 登录 Snowsight

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

  3. Select Listings, then select the listing to be edited.

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

  5. 单击 Select regions,然后选择您希望在其中发布列表的 VPS 地区或地区组。

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

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

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

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

  6. 完成后请选择 Save

备注

更改区域可用性或业务需求不需要 Snowflake Marketplace 团队的批准。

您所做的任何其他更改都将需要该列表重新经过 Snowflake Marketplace 团队的审核与批准。

作为 VPS 提供商,编辑 VPS 列表以使其在 Snowflake Marketplace 区域中可用

备注

此功能默认禁用。提供商必须联系 Snowflake 支持部门才能启用此功能。有关更多信息,请参阅 VPS 部署中的 Snowflake Marketplace 版本 2 列表

  1. 登录 Snowsight

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

  3. 选择 Listings,然后选择您要编辑的列表。

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

  5. 单击 Select regions,然后选择您希望在其中发布列表的 VPS 地区或地区组。

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

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

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

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

  6. 完成后请选择 Save

备注

更改区域可用性或业务需求不需要 Snowflake Marketplace 团队的批准。

您所做的任何其他更改都将需要该列表重新经过 Snowflake Marketplace 团队的审核与批准。

向列表添加合规徽章

Snowflake 提供了两种向列表添加 认证徽章 的方法:

  • 使用暂存更新列表。

  • 使用本地文件更新列表。

备注

目前,只能通过列表 APIs 向列表添加合规徽章。

使用暂存更新列表

要使用暂存更新包含合规徽章的列表,请完成以下步骤:

  1. To find the listing name, use SHOW LISTINGS; for example:

    SHOW LISTINGS IN DATA EXCHANGE snowflake_data_marketplace;
    
    Copy
  2. To review the listing's manifest.yml file, use DESCRIBE LISTING on a listing; for example:

    DESCRIBE LISTING <listing_name>;
    
    Copy
  3. 在 DESCRIBE LISTING 命令的输出中,将 manifest.yml 列的内容复制到新的清单文件中。

  4. 在新清单文件中,添加 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
  5. 要将您的新列表清单文件上传到 Snowflake 暂存区,请运行以下命令:

    PUT file:///<path_to_new_manifest_file> @<stage_name>
      SOURCE_COMPRESSION=None
      AUTO_COMPRESSION=False
      OVERWRITE=True;
    
    Copy
  6. 要将您的支持文档上传到同一 Snowflake 暂存区,请运行以下命令:

    PUT file:///<path_to_soc2_compliance_report> @<stage_name>
    PUT file:///<path_to_hipaa_compliance_report> @<stage_name>
      SOURCE_COMPRESSION=None
      AUTO_COMPRESSION=False
      OVERWRITE=True;
    
    Copy
  7. To upload a new version of the listing from stage, use ALTER LISTING ; for example:

    ALTER LISTING <listing_name>
      ADD VERSION FROM @<stage_name>;
    
    Copy
  8. 要提交列表以供审查,请运行以下命令:

    ALTER LISTING <listing_name> REVIEW;
    
    Copy
  9. 要在更新版列表获得批准后将其发布,请运行以下命令:

    ALTER LISTING <listing_name> PUBLISH;
    
    Copy

使用本地文件更新列表

要使用本地文件更新包含合规徽章的列表,请完成以下步骤:

  1. To find the listing name, use SHOW LISTINGS; for example:

    SHOW LISTINGS IN DATA EXCHANGE snowflake_data_marketplace;
    
    Copy
  2. To review the listing's manifest.yml file, use DESCRIBE LISTING on a listing; for example:

    DESCRIBE LISTING <listing_name>;
    
    Copy
  3. 在 DESCRIBE LISTING 的输出中,将 manifest.yml 列的内容复制到新的清单文件中。

  4. 在新清单文件中,添加 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
    
    Copy
  5. To add an editable, live version of the listing, use ALTER LISTING ; for example:

    ALTER LISTING <listing_name> ADD LIVE VERSION FROM LAST;
    
    Copy
  6. 要将徽章文件和更新版清单文件添加到列表的实时版本中,请运行以下命令:

    PUT file:///<path_to_soc2_compliance_report> snow://listing/<name>/versions/live
      SOURCE_COMPRESSION=None
      AUTO_COMPRESSION=False
      OVERWRITE=True;
    
    PUT file:///<path_to_new_manifest_file> snow://listing/<name>/versions/live
      SOURCE_COMPRESSION=None
      AUTO_COMPRESSION=False
      OVERWRITE=True;
    
    Copy
  7. 要提交列表的实时版本,请使用 ALTER LISTING。

    这会将最近的更改添加到批准请求中。

    ALTER LISTING <listing_name> COMMIT;
    
    Copy
  8. 要提交列表以供审查,请运行以下命令:

    ALTER LISTING <listing_name> REVIEW;
    
    Copy
  9. 要在更新版列表获得批准后将其发布,请运行以下命令:

    ALTER LISTING <listing_name> PUBLISH;
    
    Copy

确认合规徽章已添加到列表中

将合规徽章添加到列表后,您可以使用 SQL 确认该徽章是否已正确添加。

要确认合规徽章已添加到列表中,请完成以下步骤:

  1. 运行以下命令:

    DESCRIBE LISTING <listing_name> REVISION = DRAFT;
    
    Copy
  2. 在输出中,验证 manifest.yml 列是否包含一个 compliance_badges 部分。

取消发布列表

要从 Snowflake Marketplace 中隐藏列表而不删除,您可以取消发布该列表。

备注

当您取消发布列表时,现有使用者仍然可以访问与该列表关联的数据产品,除非您也将其从共享中移除。请参阅 更新数据共享。要移除列表以及该列表的所有使用者的访问权限,请删除该列表。请参阅 以提供商身份移除列表

要取消发布列表,请执行以下步骤:

  1. 登录 Snowsight

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

  3. 选择 Listings

  4. 选择您想要取消发布的列表的名称。

  5. 在右上角的 Live 下拉列表中,选择 Unpublish

备注

如果使用自动履行功能将列表自动复制到其他区域,则列表仍会复制到远程区域。要从其他区域移除复制的数据产品,请更改列表的区域可用性。请参阅 区域可用性(仅限 Marketplace 列表)

重新发布列表

当您在 Snowflake Marketplace 上重新发布列表时,除非您对列表进行了更改,否则您无需提交列表以供批准。

要重新发布列表,请执行以下步骤:

  1. 登录 Snowsight

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

  3. 选择 Listings

  4. 选择您要重新发布的列表的名称。

  5. 在右上角的下拉列表中,选择 Publish Listing

更新数据共享

除了修改列表之外,您还可以修改作为特定列表附加的数据产品的数据共享。您无法移除或替换已发布列表的数据产品。

For example, you might want to add a data column to a secure view, or rename objects to follow the 标识符要求.

重要

每次修改与列表相关的共享时,您必须通知使用者以确保您不会破坏他们的进程。对数据共享进行重大更改的示例如下:

  • 添加/删除列

  • 重命名对象

  • 移除对象

To update the objects in a data share, see Working with Shares.

修改付费列表

您可以修改付费列表的价格和定价方案,但有一些限制。

更改付费列表的价格

如果您想更改 Snowflake Marketplace 中付费列表的价格,您必须重新提交列表以供批准。审批是在重新发布修改后的列表过程中的技术部分。Snowflake 不提供有关价格变化的反馈。

您不能将列表价格更改为零美元。要将付费列表设为免费,您必须创建一个新列表。

After the newly priced listing is approved and published, Snowflake automatically notifies current consumers of the listing about the price change using the billing contact email address associated with each consumer's account.

更改定价方案的价格后:

  • 新使用者会立即看到新的定价方案,并根据新的定价方案付费。

  • 现有使用者将按照之前的费率计费,直到当前计费周期结束。

    • 如果您在下一个计费周期开始前 30 天以内更改价格,则使用者将在下一个计费周期中按之前的费率计费,并在下一个计费周期中按新费率计费。

    • 如果您在下一个计费周期开始前超过 30 天更改价格,则客户将按照下一个计费周期的新费率计费。

例如,对于按月计费的基于使用情况的定价方案,如果您在 10 月 15 日更改价格,则现有使用者 10 月和 11 月的发票将按先前费率计费,但 12 月的发票将按新费率计费。

具体场景可参考此示例表:

定价方案

计费周期

方案开始日期

价格更改日期

反映新价格的发票

基于使用情况

1 个月

2023 年 1 月 1 日

2023 年 6 月 15 日

2023 年 8 月 1 日

基于使用情况

1 个月

2023 年 1 月 1 日

2023 年 6 月 2 日

2023 年 8 月 1 日

基于使用情况

1 个月

2023 年 1 月 1 日

2023 年 5 月 30 日

2023 年 7 月 1 日

基于订阅

3 个月为一周期

2023 年 1 月 1 日

2023 年 2 月 15 日

2023 年 4 月 1 日

基于订阅

3 个月为一周期

2023 年 1 月 1 日

2023 年 3 月 15 日

2023 年 7 月 1 日

更改付费列表的定价方案

您可以在编辑列表时更改付费列表的定价方案。如果您想更改定价方案,请注意以下事项:

  • 您无法从付费列表中移除定价方案,以使其成为免费列表。请参阅 将现有列表更改为付费列表

  • 您无法更改定价方案的类型。如果您的列表当前有 基于使用情况的定价方案,您不能将方案更改为 基于订阅的定价方案,反之亦然。

  • If your paid listing is published in the Snowflake Marketplace, you must resubmit the listing for approval after changing the pricing plan. After the updated pricing plan is approved and the updated listing is published, Snowflake automatically notifies current consumers of the listing about the pricing plan change using the billing contact email address associated with each consumer's account.

当您更改定价方案时,现有使用者将在 下一个 计费周期结束后根据新的定价方案付费。新的使用者会立即看到新的定价方案。

将现有列表更改为付费列表

您无法将免费列表转换为付费列表。如果您发布的列表没有定价方案,以后也无法添加。

如果您想提供付费列表,则必须在首次发布之前将定价方案附加到列表中。

同样,您不能将付费列表转换为免费列表。如果您发布了包含定价方案的列表,则无法将定价方案更改为空,或将价格更改为零。要将价格更改为其他金额,请参阅 更改付费列表的价格

如果您想要更改所提供的列表类型,请创建要提供的新列表并取消发布现有列表。例如,如果您想用付费列表替换免费列表,请取消发布免费列表,并创建具有相同内容的付费列表。请参阅 取消发布列表

语言: 中文