本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
更新产品
以下各部分介绍了如何更新您的 AWS Data Exchange 产品。这些说明假定您是熟悉 数据输入 AWS Data Exchange 的提供商。发布产品后,您可以编辑该产品的详细信息及其公开优惠。您还可以通过向订阅者发布新的修订来更新基础数据集。有关更多信息,请参阅修订。
更新产品和优惠详细信息
发布产品后,您可以使用 AWS Data Exchange 控制台来编辑产品详细信息。您还可以编辑产品的公开或自定义优惠,并更改优惠条款。在更新产品的优惠条款时,拥有有效订阅的订阅者只要其订阅处于有效状态,就仍遵循其现有的优惠条款。选择自动续订的订阅者则遵循新的优惠条款。
更新产品时,请记住以下几点:
-
您无法删除或编辑优惠中的订阅持续时间。这可以确保现有订阅者保留续订能力。如果您不想再提供特定的订阅持续时间,则可以取消发布现有产品,然后发布新产品。有关更多信息,请参阅取消发布产品。
-
无论有多少订阅者订阅了您的产品,您都无法在产品发布后从中删除数据集。
-
如果您要更新包含 API 的产品的计量成本:
-
新订阅者的产品详细信息页面上会立即显示计量成本降价。
警告
如果您撤消计量成本降价,则表示您在上调计量成本的价格。有关计量成本价格上调的更多信息,请参阅以下内容。
-
计量成本价格上调将在当月的第一天、向现有订阅者提交提价后的 90 天或续订时生效(以较早者为准)。提交价格变动后,系统会向现有订阅者发送一封电子邮件。对于新订阅者,价格上调会立即显示在产品详细信息页面上。
例 示例
您在 5 月 10 日提交了计量成本价格上调。现有订阅者会收到一封关于价格变动的电子邮件。价格上调将于 9 月 1 日生效。
警告
在价格上调对现有订阅者生效之前,您无法撤消价格上调(因为该操作会降低价格)。
-
要更新产品、数据集或优惠详细信息,请按以下步骤操作:
-
打开您的 Web 浏览器,登录到 AWS Data Exchange 控制台
。 -
在左侧导航窗格中的发布数据下,选择产品。
-
从产品中,选择您要更新的产品。确保其状态为已发布。
-
从产品详细信息中:
-
如果您正在编辑公开优惠,请依次选择公开优惠选项卡和编辑,然后按照说明编辑产品。
-
如果您正在编辑专属优惠,请依次选择自定义优惠选项卡和您要编辑的专属优惠旁边的选项按钮,再选择编辑,然后按照说明编辑产品。
-
对于包含按计量成本计费的 API 的产品,在计量成本 - 可选中,选择您要编辑的计量成本类型旁边的选项按钮,然后选择编辑。
-
在编辑计量成本对话框中,更新价格/单位或描述。
-
选择更新。
更新后的计量成本会显示在计量成本 - 可选下。
-
-
在数据集中的敏感信息下,选择编辑,然后按照说明编辑该信息。
-
在数据评估中,选择数据字典或样本名称旁边的选项按钮,然后选择操作,以更新该数据字典或样本。有关更多信息,请参阅更新数据字典和更新样本。
-
根据优惠类型,配置您的优惠:
-
如果您的产品是公开优惠,请从公开优惠中选择编辑,然后按照说明编辑公开优惠。
-
如果您的产品是自定义优惠,请从自定义优惠中选择编辑,然后按照说明编辑自定义优惠。
-
如果您的产品是专属优惠,请从专属优惠中选择编辑,然后按照说明编辑专属优惠。
-
-
选择更新。
更新数据字典
您可以先删除现有的数据字典,然后上传新的数据字典,从而更新数据字典。
要更新数据字典,请按以下步骤操作:
-
打开您的 Web 浏览器,登录到 AWS Data Exchange 控制台
。 -
在左侧导航窗格中的发布数据下,选择产品。
-
从产品中,选择您要更新的产品,并确认其状态为已发布。
-
选择数据评估选项卡。
-
在数据字典和样本下,选择加号图标展开数据集,然后通过选择数据字典名称旁边的选项按钮来选择该数据字典。
-
选择操作,然后选择移除数据字典。
该数据字典即会被删除。
-
选择数据集旁边的选项按钮,然后依次选择操作和上传数据字典。
-
选择添加文件。
-
选择一个新的数据字典,然后单击打开。
-
选择上传。
-
-
(可选)通过选择数据字典名称旁边的选项按钮来选择该数据字典,选择操作,然后选择下载数据字典 (CSV),将该数据字典下载到您的计算机。
更新样本
要更新样本,请按以下步骤操作:
-
打开您的 Web 浏览器,登录到 AWS Data Exchange 控制台
。 -
在左侧导航窗格中的发布数据下,选择产品。
-
从产品中,选择您要更新的产品,并确认其状态为已发布。
-
选择数据评估选项卡。
-
在数据字典和样本下,选择数据集旁边的选项按钮。
-
选择操作,然后选择添加样本。
-
选择上传样本。
-
从计算机中选择一个新样本,然后选择打开。
-
输入可选描述,然后选择添加。
-
-
(可选)选择样本名称旁边的选项按钮,选择操作,然后选择以下操作之一:
-
下载选定的样本
-
预览样本(仅限 CSV)
-
移除所选样本
-
更新自定义元数据
发布产品后,您可以使用 AWS Data Exchange 控制台编辑该产品的自定义元数据。
要更新自定义元数据,请按以下步骤操作:
-
打开您的 Web 浏览器,登录到 AWS Data Exchange 控制台。
-
在左侧导航窗格中的发布数据下,选择产品。
-
从产品中,选择您要更新的产品。确保其状态为已发布。
-
(可选)在订阅中,选择查看自定义元数据,查看该元数据,然后选择关闭。
-
在订阅中,选择编辑自定义元数据,然后按照说明编辑该元数据或添加新的元数据。
-
选择保存。
发布新的数据集修订
AWS Data Exchange 支持动态更新的产品。订阅者在订阅产品的特定持续时间内,只要他们的订阅仍然有效,就可以访问所有已发布的数据集。例如,提供商可能想提供一种包含美国股票每日收盘价的产品,该价格每天都会根据当天的收盘价进行更新。您可以创建将在产品数据集中提供的新修订并进行定版,也可以向您的产品添加新的数据集。
您的产品在订阅中包含部分或全部历史修订和未来修订。有关更多信息,请参阅修订访问规则。
在以下步骤中,您将使用 AWS Data Exchange 控制台为已发布的数据集创建并定版新的修订。然后,该数据集修订将自动发布到该数据集所属的所有产品。有关更多信息,请参阅修订。
重要
提供商可以撤消订阅者对修订的访问权限,然后使用该控制台或 AWS Data Exchange API 删除修订的资产。有关更多信息,请参阅撤销修订。
要发布产品的新数据集修订,请按以下步骤操作:
-
打开您的 Web 浏览器,登录到 AWS Data Exchange 控制台
。 -
在左侧导航窗格的发布数据下,选择拥有的数据集。
-
在拥有的数据集中,选择您要更新的数据集。
-
导航至产品选项卡,确保该数据集与已发布的产品相关联。
-
从修订选项卡中,选择创建修订,以打开创建修订页面。
-
(可选)在修订设置下,为您的修订提供介绍修订目的的可选注释。
-
(可选)在添加标签 - 可选下,添加与该资源关联的标签。
-
选择创建修订。
您的新修订即会创建。
-
-
在作业部分下,选择从 Amazon S3 导入或上传(从您的计算机上传),具体取决于您要包含的资产是存储在您拥有的 Amazon S3 存储桶中还是存储在本地计算机上。
-
根据您的选择,按照相应提示进行操作。此时,将您的资产导入数据集的作业已启动。
-
作业完成后,作业部分的状态字段将更新为已完成。
-
-
在修订概览下,查看修订及其资产,然后选择定版。
修订已发布到产品中,现在可供订阅者使用。
使用文件交付类型发布历史数据的建议方法
一些动态产品包含订阅者可以访问的历史内容。例如,如果您的产品包含 30 年的美国股票每日收盘价历史记录,那么除了每天的动态更新外,订阅者还可以访问该数据。
对于此类包含历史数据记录的产品,最佳实践是在数据集的单个修订中发布所有历史数据。您可以在该修订的可选注释中,注明此修订一次性上传了从特定日期开始的所有数据历史记录。
如果单个历史修订包含多个对象的时间序列,则可以考虑标记对象名称,以描述基础数据周期。例如,如果您的单个历史修订包含 200 个文件,每个文件包含一周的历史数据,则可以将每个文件命名为数据历史记录开始当周的日期。
建议的更新方法
您可以通过以下多种方式动态更新您的数据集。以下是三种示例方法,所有这些方法都会针对每次更新创建一个新修订,但是新修订的内容有所不同。
-
每次更新都使用一个新修订,仅包含自上次修订以来更改过的项目 – 修订的大小会变小,因为只有那些更改过的项目才会被更新。这种方法适用于更新仅影响一小部分数据且订阅者仅关注已更改项目的数据集。
-
每次更新都使用一个新修订,包含更新后的数据 – 新修订包含更新后的完整文件。所有项目都包含在新修订中,包括自上次修订以来未发生更改的项目。对于想要保留最新数据文件的订阅者来说,这种方法非常方便。订阅者将最新修订的一个或多个资产导出到相同的目标位置,并覆盖先前的一个或多个文件。
-
每次更新都使用一个新修订,包含完整历史记录和更新后的数据 – 新修订包含数据的完整历史记录,包括数据的最新状态和先前修订的历史记录。这种方法会占用更多存储空间。它适用于订阅者有兴趣了解最新且全面的数据历史记录(包括过去的任何潜在修正或调整)的数据集。在这种方法中,每个修订都是独立的,并且可以提供完整的数据集历史记录视图,而不依赖于以前的修订。
取消发布产品
产品发布后,所有人都可以查找和订阅该产品,具体取决于该产品的可见性设置。如果您想获得以下任一结果,则可以取消发布产品:
-
删除您为 发布新产品 练习创建的产品。
-
清除您的资源。
-
从 AWS Data Exchange 上公开发布的产品中删除产品。
-
阻止订阅者自动续订您的产品。
取消发布产品时,请记住以下几点:
-
您可以根据需要随时取消发布产品。
-
如果您取消发布产品,则该产品在 AWS Data Exchange 目录中或 AWS Marketplace 上将不再可见。
-
拥有有效订阅的订阅者在订阅期限到期之前,可以继续访问该数据产品。
-
即使订阅者已启用自动续订,在您取消发布产品后到期的有效订阅也不会续订。
-
在订阅到期之前,现有订阅者仍然可以查看产品详细信息。
要取消发布产品,请按以下步骤操作:
-
打开您的 Web 浏览器,登录到 AWS Data Exchange 控制台
。 -
在左侧导航窗格中的发布数据下,选择产品。
-
从产品中,选择您要删除的产品。确保其状态为已发布。
-
在产品概览中,选择取消发布,然后按照说明取消发布产品。
重要
此操作无法撤消。
完成这些步骤后,您的产品状态将变为已取消发布。已取消发布的产品无法再次发布,但您可以创建具有相同数据集、产品详细信息和优惠详细信息的新产品(拥有新的产品 ID)。
删除修订
提供商可以撤消订阅者对修订的访问权限,然后使用该控制台或 AWS Data Exchange API 删除修订的资产。有关更多信息,请参阅撤销修订。
您可以在修订定版后但在将其添加到产品之前,编辑或删除该修订。有关更多信息,请参阅以下主题:
撤销修订
作为提供商,您可以随时撤消订阅者对特定修订的访问权限。出于合规原因,此操作通常由提供商执行。撤销修订不会删除底层资产。在您撤销修订后,所有订阅者都会收到一则 Amazon EventBridge(以前称为 CloudWatch Events)通知,说明该修订已被撤销。然后,订阅者可以在 AWS Data Exchange 控制台上查看修订被撤销的原因。订阅者无法导出或查询已撤销修订中的数据。
为撤销修订,自行管理 IAM 策略的提供商必须将 dataexchange:RevokeRevision
添加为新操作。使用 AWS Data Exchange 托管策略的提供商无需进行任何更改。
撤销修订后,您可以使用控制台或 AWS Data Exchange DeleteAsset
API 操作删除修订的资产。
撤销修订 (AWS CLI)
要撤销修订 (AWS CLI),请按以下步骤操作:
-
使用
revoke-revision
命令撤消修订。$ aws dataexchange revoke-revision \ --data-set-id $DATA_SET_ID \ --revision-id $REVISION_ID \ --comment 'Revoking Revision Example' { "Id": "ab7859881EXAMPLEdd3e8a4b88fc6a8d", "Arn": "arn:aws:dataexchange:us-east-1:427362365172:data-sets/$DATA_SET_ID/revisions/$REVISION_ID", "Comment": "Revoking Revision Example", "CreatedAt": "2022-03-08T18:54:20.746Z", "UpdatedAt": "2022-03-09T20:28:53.105Z", "DataSetId": "24d30f8446a878237c35d011e7b22d0b", "Finalized": true, "Revoked": true, "RevokedAt": "2022-03-09T20:28:53.105Z", "RevocationComment": "revoking revision example" }
-
撤销修订后,您可以使用 AWS Data Exchange
DeleteAsset
API 操作删除修订的资产。
以提供商身份撤消单个修订(控制台)
要以提供商身份撤销修订(控制台),请按以下步骤操作:
-
打开您的 Web 浏览器,登录到 AWS Data Exchange 控制台
。 -
在左侧的导航窗格中,为发布数据选择拥有的数据集。
-
在拥有的数据集中,选择包含您要撤消的修订的数据集。
-
在修订选项卡的修订下,选择该修订。
-
在修订页面的修订概览下,为操作选择撤销。
-
在撤消修订对话框中,简短描述撤消修订的原因。订阅者将看到此描述。
-
选择撤销。
该修订的状态即会设置为已撤销。
警告
此操作将撤销修订及其所有资产。订阅者可以查看撤销的原因,但无法访问或导出相应资产。此操作无法撤消。
-
撤消修订后,您可以通过导航到修订页面,在导入的资产表中选择您要删除的资产,然后选择删除来删除该修订的资产。
要编辑已撤销修订的原因,请参阅以提供商身份编辑撤销原因(控制台)。
以提供商身份撤销多个修订(控制台)
要以提供商身份撤销多个修订(控制台),请按以下步骤操作:
-
打开您的 Web 浏览器,登录到 AWS Data Exchange 控制台
。 -
在左侧的导航窗格中,为发布数据选择拥有的数据集。
-
在拥有的数据集中,选择包含您要撤消的修订的数据集。
-
在修订选项卡上,最多选择 10 个修订。
-
选择撤销。
-
在撤销 {x} 修订对话框中,简短描述撤消修订的原因。订阅者将看到此描述。然后选择撤销。
该修订的状态即会设置为已撤销。
警告
此操作将撤销修订及其所有资产。订阅者可以查看撤销的原因,但无法访问或导出相应资产。此操作无法撤消。
-
撤消修订后,您可以通过导航到修订页面,在导入的资产表中选择您要删除的资产,然后选择删除来删除该修订的资产。
要编辑已撤销修订的原因,请参阅以提供商身份编辑撤销原因(控制台)。
以提供商身份编辑撤销原因(控制台)
作为提供商,您可以在撤销修订后编辑撤销原因。
要以提供商身份编辑撤销修订(控制台),请按以下步骤操作:
-
打开您的 Web 浏览器,登录到 AWS Data Exchange 控制台
。 -
在左侧的导航窗格中,为发布数据产品选择拥有的数据集。
-
在拥有的数据集中,选择包含您撤消的修订的数据集。
-
在修订选项卡上,选择已撤消的修订。
-
在修订页面上,选择编辑撤销原因。
-
在编辑撤销修订对话框中,简短描述撤消修订的原因。
-
选择保存。
该修订的状态即会设置为已撤销。
更新后的撤销原因会显示在修订页面上。
以订阅者身份查看已撤销的修订(控制台)
要以订阅者身份查看已撤销的修订(控制台),请按以下步骤操作:
-
打开您的 Web 浏览器,登录到 AWS Data Exchange 控制台
。 -
在左侧导航窗格中的我的订阅下,选择授权数据。
-
在产品下,选择一个产品,然后展开该产品下的数据集,以查看修订列表。
-
在数据集页面的修订选项卡下,查看该修订的状态(已发布或已撤销)。
-
选择一个修订。
-
在修订详细信息页面的顶部,查看修订原因。