修改已发布的列表

This topic describes how to modify listings after they have been published to the Snowflake Marketplace or shared with consumers as a private listing.

编辑列表所需的权限

To modify listings, you must be the listing owner or have the MODIFY privilege on a listing. See MODIFY privilege on a listing.

Edit a listing published on the Snowflake Marketplace

When editing a listing published on the Snowflake Marketplace, consider the following:

  • When you edit a listing published on the Snowflake Marketplace, a new draft listing is created. To make those changes available to consumers, you must resubmit the draft listing for approval and publishing.
  • 在编辑可用区域和业务需求字段时，无需获得批准。您可以随时进行这些更改。
  • If you remove a region that was previously available, consumers in that region no longer have access to the shared dataset.
  • 当发布新版本的列表时，以前的版本将被替换并且无法恢复。

If you want to update the data product associated with a listing, see 更新数据共享.

To edit a listing published on the Snowflake Marketplace, complete the following steps:

  1. Sign in to Snowsight.

  2. In the navigation menu, select Marketplace » Provider Studio.

  3. Select Listings, then select the listing you want to edit.

    • To add or remove regions where the listing is available, click Edit in the Region Availability section. You can skip the rest of the steps as no administrator approval is required.
    • To change other fields, such as the listing description, click Edit in the applicable section and select Continue when prompted. This creates a new draft listing that is not visible to consumers until submitted, approved, and published.
    • If you have existing changes in progress, select the New Draft toggle next to the listing title to continue working on an existing draft. You can discard this draft by selecting the Delete button at the top right of the page.

  4. Select Submit for Approval when you are ready to submit your new draft listing for review.

编辑私密列表

You can edit draft or published private listings in Provider Studio. If you edit a published private listing, any changes that you make are immediately available to consumers after you save those changes.

If you want to update the data product associated with a listing, see 更新数据共享 for guidance.

要编辑私密列表，请执行以下步骤：

  1. Sign in to Snowsight.
  2. In the navigation menu, select Marketplace » Provider Studio.
  3. Select Listings, then choose the listing you want to edit.
  4. Make the changes that you want, then click Save.

As a Snowflake Marketplace provider, edit an existing Snowflake Marketplace listing to be available in a VPS deployment

Note

This feature isn’t enabled by default. Providers must reach out to Snowflake Support to enable this feature. For more information, see Snowflake Marketplace version 2 listings in VPS deployments.

  1. Sign in to Snowsight.
  2. In the navigation menu, select Marketplace » Provider Studio.
  3. Select Listings, then select the listing to be edited.
  4. Scroll to the Region Availability section and select Set region availability.
  5. Click Select regions, then select the VPS region or region groups where you want your listing to be available. 在 VPS 中已部署区域组的区域会带有信息图标标识。

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

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

For more information about how auto-fulfillment incurs costs, see Auto-fulfillment costs.

  1. Select Save when you’re done.

Note

Changing the region availability or the business needs doesn’t require approval from the Snowflake Marketplace team.

Any other changes that you make will require the listing to be re-reviewed and approved by the Snowflake Marketplace team.

As a VPS provider, edit a VPS listing to be available in Snowflake Marketplace

Note

This feature isn’t enabled by default. Providers must reach out to Snowflake Support to enable this feature. For more information, see Snowflake Marketplace version 2 listings in VPS deployments.

  1. Sign in to Snowsight.
  2. In the navigation menu, select Marketplace » Provider Studio.
  3. Select Listings, then select the listing you want to edit.
  4. Scroll to the Region Availability section and select Set region availability.
  5. Click Select regions, then select the VPS region or region groups where you want your listing to be available. 在 VPS 中已部署区域组的区域会带有信息图标标识。

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

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

For more information about how auto-fulfillment incurs costs, see Auto-fulfillment costs.

  1. Select Save when you’re done.

Note

Changing the region availability or the business needs doesn’t require approval from the Snowflake Marketplace team.

Any other changes that you make will require the listing to be re-reviewed and approved by the Snowflake Marketplace team.

向列表添加合规徽章

You can add compliance certifications to listings by using Snowsight or SQL.

Add compliance certifications by using Snowsight

To add compliance certifications to an existing listing by using Snowsight, follow these steps:

  1. Sign in to Snowsight.
  2. In the navigation menu, select Marketplace –> Provider Studio.
  3. Select the Listings tab, then select the listing you want to update.
  4. In the optional Certifications section, add the compliance certifications for your listing. You can upload the supporting compliance documentation and set the expiration date for each certification.
  5. Select Save to save your changes.
  6. Submit your listing for approval.

Add compliance certifications by using SQL

Snowflake provides two SQL-based methods for adding certification badges to listings:

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

使用暂存更新列表

To update a listing that includes compliance certifications by using a stage, complete the following steps:

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

    SHOW LISTINGS IN DATA EXCHANGE snowflake_data_marketplace;

  2. To review the listing’s manifest.yml file, use DESCRIBE LISTING on a listing; for example:

    DESCRIBE LISTING <listing_name>;

  3. 在 DESCRIBE LISTING 命令的输出中，将 manifest.yml 列的内容复制到新的清单文件中。

  4. In the new manifest file, add the compliance_badges field and include a line for each certification type; for example:

    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

  5. 要将您的新列表清单文件上传到 Snowflake 暂存区，请运行以下命令：

    PUT file:///<path_to_new_manifest_file> @<stage_name>
  SOURCE_COMPRESSION=None
  AUTO_COMPRESSION=False
  OVERWRITE=True;

  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;

  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>;

  8. 要提交列表以供审查，请运行以下命令：

    ALTER LISTING <listing_name> REVIEW;

  9. 要在更新版列表获得批准后将其发布，请运行以下命令：

    ALTER LISTING <listing_name> PUBLISH;

使用本地文件更新列表

To update a listing that includes compliance certifications by using local files, complete the following steps:

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

    SHOW LISTINGS IN DATA EXCHANGE snowflake_data_marketplace;

  2. To review the listing’s manifest.yml file, use DESCRIBE LISTING on a listing; for example:

    DESCRIBE LISTING <listing_name>;

  3. 在 DESCRIBE LISTING 的输出中，将 manifest.yml 列的内容复制到新的清单文件中。

  4. In the new manifest file, add a compliance_badges section and include a line for each certification type; for example:

    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

  5. To add an editable, live version of the listing, use ALTER LISTING ; for example:

    ALTER LISTING <listing_name> ADD LIVE VERSION FROM LAST;

  6. 要将徽章文件和更新版清单文件添加到列表的实时版本中，请运行以下命令：

    PUT file:///<path_to_soc2_compliance_report> snow://listing/<name>/versions/live
  AUTO_COMPRESS=False
  OVERWRITE=True;

PUT file:///<path_to_new_manifest_file> snow://listing/<name>/versions/live
  SOURCE_COMPRESSION=None
 AUTO_COMPRESS=False
  OVERWRITE=True;

  7. 要提交列表的实时版本，请使用 ALTER LISTING。

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

ALTER LISTING <listing_name> COMMIT;

  1. 要提交列表以供审查，请运行以下命令：

    ALTER LISTING <listing_name> REVIEW;

  2. 要在更新版列表获得批准后将其发布，请运行以下命令：

    ALTER LISTING <listing_name> PUBLISH;

Confirm that the compliance badge was added to the listing (SQL)

After you add a compliance badge to a listing by using SQL, you can confirm that the badge was added correctly.

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

  1. 运行以下命令：

    DESCRIBE LISTING <listing_name> REVISION = DRAFT;

  2. In the output, verify that the manifest.yml column includes a compliance_badges section.

取消发布列表

To hide a listing from the Snowflake Marketplace without deleting it, you can unpublish the listing.

Note

When you unpublish a listing, existing consumers can still access the data product associated with the listing unless you also remove them from the share. See 更新数据共享. To remove a listing and access to the listing for all consumers using the listing, delete the listing. See Remove listings as a provider.

要取消发布列表，请执行以下步骤：

  1. Sign in to Snowsight.

  2. In the navigation menu, select Marketplace » Provider Studio.

  3. Select Listings.

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

  5. In the top-right corner of the listing page, select the vertical ellipsis (More actions for worksheet), and then select Unpublish to begin unpublishing the listing.

    A confirmation message displays, reminding you that unpublishing a listing removes the listing from Snowflake Marketplace, but existing consumers will continue to have access to the listing.

  6. Select Unpublish to complete the unpublish process.

    The status at the top of the page changes from Live to Unpublished. You can select that status to view the listing status summary.

Note

If the listing was automatically replicated to other regions using auto-fulfillment, the listing remains replicated to the remote regions. To remove the replicated data product from other regions, change the region availability of the listing. For more information, see Region availability (Marketplace listings only).

重新发布列表

When you republish a listing on the Snowflake Marketplace, you do not need to submit the listing for approval unless you made changes to the listing.

要重新发布列表，请执行以下步骤：

  1. Sign in to Snowsight.
  2. In the navigation menu, select Marketplace » Provider Studio.
  3. Select Listings.
  4. 选择您要重新发布的列表的名称。
  5. In the top-right corner, select Publish to republish the listing.
    • A message displays, confirming that the listing is available on Snowflake Marketplace. From this message, you can select to view the listing on Snowflake Marketplace, or you can select Done to return to the listing page.
    • The status at the top of the listing page changes from Unpublished to Live.

更新数据共享

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

For example, you might want to add a data column to a secure view, or rename objects to follow the Identifier requirements.

Important

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

  • 添加/删除列
  • 重命名对象
  • 移除对象

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

修改付费列表

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

更改付费列表的价格

If you want to change the price of a paid listing in the Snowflake Marketplace, you must resubmit the listing for approval. The approval is a technical part of the process of republishing a modified listing. Snowflake does not provide feedback about the price change.

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

新定价的列表通过审核并发布后，Snowflake 会通过每个使用者账户关联的账单联系邮箱，自动通知当前使用者有关价格变更的信息。

更改定价方案的价格后：

  • 新使用者会立即看到新的定价方案，并根据新的定价方案付费。
  • 现有使用者将按照之前的费率计费，直到当前计费周期结束。
    • If you change the price less than 30 days before the next billing cycle begins, customers are billed the previous rate for the next billing cycle and the new rate for the following billing cycle.
    • If you change the price more than 30 days before the next billing cycle begins, customers are billed the new rate for the next billing cycle.

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

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

Pricing planBilling cyclePlan start datePrice change dateInvoice where new price is reflected
Usage-based1 monthJan 1, 2023Jun 15, 2023Aug 1, 2023
Usage-based1 monthJan 1, 2023Jun 2, 2023Aug 1, 2023
Usage-based1 monthJan 1, 2023May 30, 2023Jul 1, 2023
Subscription-based3 months, recurringJan 1, 2023Feb 15, 2023Apr 1, 2023
Subscription-based3 months, recurringJan 1, 2023Mar 15, 2023Jul 1, 2023

更改付费列表的定价方案

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

  • You cannot remove a pricing plan from a paid listing to make it a free listing. See Change Existing Listings to Paid Listings.
  • You cannot change the type of pricing plan. If your listing currently has a usage-based pricing plan, you cannot change the plan to a subscription-based pricing plan, and vice versa.
  • 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.

When you change the pricing plan, existing consumers are charged based on the new pricing plan after the end of their next billing cycle. New consumers see the new pricing plan immediately.

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

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

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

Similarly, you cannot convert a paid listing into a free listing. If you published a listing with a pricing plan, you cannot change the pricing plan to null, or change the price to zero. To change the price to some other amount, see 更改付费列表的价格.

If you want to change the type of listing that you offer, create the new listing that you want to offer and unpublish the existing listing. For example, if you want to replace a free listing with a paid listing, unpublish the free listing and create a paid listing with the same contents. See 取消发布列表.