管理数据列表¶
在数据交换中成为获准数据提供商后，即可开始添加数据列表。
本主题内容：
新建数据列表¶
创建列表的注意事项¶
备注
这些注意事项同样适用于在远程区域中创建列表。
由于数据在不同账户之间共享，数据使用者应能直接使用共享数据对象，而无需使用双引号括起标识符（请参阅 标识符要求）。因此，表、列和共享名称的对象标识符必须采用 大写 形式，并且只能使用 字母数字字符。
要确保共享数据库中的敏感数据不会公开给使用者账户中的用户，请参阅 使用安全对象控制数据访问。
当前与使用者账户进行共享的共享（即通过 Direct Share 的方式共享）可添加到列表中。使用者必须先在数据交换 Web 界面中接受列表条款，然后才能从共享创建数据库。
只有创建共享的角色才能将共享附加到列表。
一个共享只能附加到一个列表。如果某个共享已附加到某个列表，即便在删除此列表后，您仍无法将其附加到其他列表。
在发布新的或修改的免费列表之前，系统会自动验证所有示例查询，以确保将引用的对象添加到共享中，并确保查询可以成功运行。
数据必须是可合法共享的（即提供商必须拥有数据或有权共享数据）。
备注
如果您的数据列表或数据集中的任何数据受任何法定或合同义务约束，则必须确保拥有共享此类数据的法定和合同权利。例如，您只能通过个性化数据共享来共享受保护的健康信息 (PHI)，为此，您必须符合以下条件：(1) 与 Snowflake 和接收 PHI 的使用者签署了商业伙伴协议 (BAA)；并且 (2) 确保使用者也与 Snowflake 签署了 BAA。此外，虽然您可以通过数据共享来共享个人数据，但如果数据并非公开可用的数据，您必须拥有适用的法定和合同权利。
在远程区域中创建列表和复制数据的注意事项¶
在您发布列表时，使用者将在所有选定区域内看到您的列表信息。
虽然列表会自动复制，但数据不会自动复制。
对于免费列表，您必须先将数据复制到每个选定区域，然后再发布列表。
对于个性化列表，您可以根据使用者的要求复制数据。
请确保安排出设置复制并了解相关费用的时间。
若要在某个区域中共享数据，您必须拥有该区域中的账户，只有这样才能复制数据。如果您有多个账户，则所有账户必须属于同一个组织。
在远程区域发布列表时，可以允许组织中的所有账户满足列表请求，也可以明确将个别账户添加为提供商。只有列表所有者可以指定谁能满足列表请求。
跨区域数据共享利用 Snowflake 数据复制功能，如需了解更多信息，请参阅 跨区域和云平台安全共享数据。
在使用者提出请求之前，无需将数据复制到各区域。
对于免费列表，您可以预先将共享与远程区域的列表相关联。这将允许使用者在不提交请求的情况下立即获得共享。
若要查看附加到远程区域中列表的共享列表，您必须登录到将共享附加到列表的远程账户。
创建和发布列表¶
要创建免费或个性化数据列表，请执行以下操作：
在 Snowsight 中，导航到 Data Products » Private Sharing。
选择 Share Data 下拉列表，然后选择一个数据交换。
在 New Listing 对话框中，输入向使用者显示的列表标题，然后选择列表类型。有关列表类型的更多信息，请参阅 列表类型。
补全新列表的每个部分。您可以随时保存草稿，以便稍后再完成。有关每个部分和相关字段的说明，请参阅 列表功能参考。
对于免费列表，要将共享与列表相关联，请在编辑 Data 部分时执行以下操作：
备注
在发布列表之前，它只能与本地/主账户中的共享相关联。发布列表后，它可以与您选择的其他区域中的共享相关联。
选择 Select Data。
如果存在安全共享，请导航到该共享，然后选择它。如果共享不存在，请导航到所需的数据库，然后选择要添加到共享的数据库对象。
备注
如果您没有看到共享，则说明该共享已经附加到另一个列表中，或者之前已经与使用者分享过。
选择 Done。
（可选）您可以更改安全共享的默认名称。
选择 Save。
完成所有部分后，选择 Publish 以将列表发布到所选区域。
如果出现以下情况，则表示 Publish 按钮未激活：
所提供的任何 SQL 查询示例都无法通过验证。有关更多信息，请参阅 数据列表字段。
您不是共享所有者。
数据列表字段¶
下表描述了在数据交换中创建和配置数据列表时所需的参数。
部分 |
字段名称 |
描述 |
示例 |
|---|---|---|---|
Basic Information |
Listing Type |
请参阅 列表类型。 |
可用值：Free、Personalized |
Profile |
拥有共享的提供程序简介的名称。您必须先创建提供商简介，然后才能发布列表。 |
||
Title |
数据列表的标题。标题不能超过 110 个字符。 |
按邮政编码显示的历史天气。 |
|
Subtitle |
数据列表的子标题。子标题不能超过 110 个字符。标题和子标题不应过长。 |
按位置显示的历史天气数据。 |
|
Data Update Frequency |
数据的更新频率。 |
可用值：Near real-time、Daily、Weekly、Monthly、Quarterly、Annually、Never (Static Data)。 |
|
Category |
为数据列表划分类别，以便于发现。 |
||
Terms of Service |
提供商网站上托管的列表条款的链接。使用者必须先接受这些条款，然后才能访问数据。列表条款对于免费列表是必需的，对于个性化列表是可选的。 |
|
|
Details |
Description |
共享数据集的描述。描述中必须包括： . (a) 数据规模 . (b) 表/视图的描述 . (c) 数据集是否为样本 . (d) 在何处可以找到 Data Dictionaries。 |
ACME 是为大型企业提供定制、精确天气预警的头号供应商，也是全球天气预报、数据和气象咨询服务的重要信息来源。此数据提供了各个 US 邮政编码对应的历史天气数据，可用于进一步增强现有数据以提供更深入的分析。 |
Link to Documentation |
指向提供商网站上包含更详细文档的页面的链接。文档必须清晰明确，并引用 Snowflake 共享中存在的正确架构对象。此文档不能仅为标准文档。 |
|
|
Data |
Database Objects or Secure Share |
选择想要共享的数据。此部分仅适用于免费数据列表。 |
|
Business Needs |
Business Need |
数据列表按业务需求分组，以便发现。. – 最多可为列表选择六个业务需求。如果在下拉列表中未看到相关的业务需求，则可以创建自定义需求。. – 使用者可以根据下拉列表中可用的业务需求，轻松发现列表。但您添加的自定义业务需求不包括在内，此类自定义需求仅在您的列表详细信息中可见。 |
|
Description |
关于数据或数据服务如何满足业务需求的描述。 |
||
Sample SQL Query |
Title |
查询的描述性标题，可帮助使用者了解数据。可添加多个示例。 |
|
Description (Optional) |
示例描述及附加说明，例如架构名称、示例表、字段、用例。 |
||
SQL Query |
针对用于创建共享的数据库，对示例查询执行测试。Snowflake 会自动验证查询，以确保所引用的全部对象均已添加到共享中，并且查询可以成功运行。如果验证失败，则会显示一条错误消息，并注明原因。每个失败的查询旁边都会显示一个感叹号。 |
||
Region Availability |
All available regions 或 Specific Regions |
您的列表可见的区域。您需要将数据复制到这些区域。您可以随时编辑可用区域列表，而不需要重新提交至管理员进行批准。如果移除以前可用的区域，则该区域中的使用者将无法再看到此列表。 |
查看针对个性化列表的请求¶
备注
系统将向提供商发送电子邮件通知，以通知他们数据请求。您可以在 Settings 选项卡中更改特定列表的请求通知电子邮件。
要查看针对个性化列表的请求，请执行以下操作：
导航到 Data Products » Private Sharing。
选择 Requests 选项卡。使用筛选下拉列表，按状态查看请求。
批准使用者对于远程区域中数据列表的请求¶
备注
对于**个性化**列表，数据不会自动在远程区域中提供。提供商要负责将其数据复制到各区域。
对于**免费**列表，您可以预先将共享与远程区域的列表相关联。这允许使用者在不提交请求的情况下立即获得共享。您还可以在收到区域中第一个使用者发来的请求后复制数据，并将共享附加到列表。将列表附加到共享后，该区域中的所有使用者均可立即访问该共享。
您可以指定列表可由选定提供商账户履行，还是可由组织中的任何账户履行。
要批准使用者针对一个数据列表提交的请求，请执行以下操作：
备注
如果使用者位于不同的区域，则在附加共享之前，必须设置复制，以将数据复制到每个远程区域中的账户。有关更多信息，请参阅 跨区域和云平台安全共享数据。
导航到 Data Products » Private Sharing。
选择 Requests 选项卡。
选择列表名称旁边的 Review。
在 Associate Secure Share 部分中，选择要在其中创建共享的账户。
选择拥有共享和共享的数据库对象的角色（或拥有数据库对象的必要权限，因此能够将其添加到共享的角色）。
选择 Select Data。
如果存在安全共享，请导航到该共享，然后选择它。如果共享不存在，请导航到所需的数据库，然后选择要添加到共享的数据库对象。
备注
如果您没有看到共享，则说明该共享已经附加到另一个列表中，或者之前已经与使用者分享过。
选择 Done。
（可选）您可以更改安全共享的默认名称。
选择 Fullfill Request。
小技巧
如果在履行远程区域的请求时收到错误，请考虑以下事项：
远程账户是否已作为提供商添加到 Marketplace？
远程账户是否与您用于发布列表的账户属于同一组织？
您在创建新共享时是否使用了 ACCOUNTADMIN 角色？
您是否已将其他使用者添加您尝试附加的共享之中？
查看已履行的列表请求¶
使用 Snowsight 履行免费或个性化列表请求的提供商可导航到 Data Products » Private Sharing，并选择 Shared by My Account 选项卡，以查看添加到共享中的使用者的记录。
在 QUERY_HISTORY 视图 中也可找到这些记录。
管理现有数据列表¶
编辑数据列表¶
发布列表的新版本时，新版本会覆盖之前发布的列表。如果移除以前可用的区域，则该区域中的使用者将无法再访问共享数据集。
要编辑数据列表，请执行以下操作：
以 ACCOUNTADMIN 的身份登录到 Snowsight。
在导航菜单中，点击 Data Products » Private Sharing » Shared by My Account。
点击要更新的列表名称。
点击列表标题旁的 New Draft。
点击要更新的部分对应的 Edit。
点击 Publish。
取消发布数据列表¶
在取消发布数据列表时，现有使用者仍可访问数据共享，除非将其从共享中移除。新使用者不会看到此列表。
要取消发布数据列表，请执行以下操作：
以账户管理员身份，使用 Snowsight 登录到数据交换。
在导航菜单中，选择 Data Products » Private Sharing » Shared by My Account。
选择您想要取消发布的列表的名称。
在右上角的 Live 下拉列表中，选择 Unpublish。
重新发布数据列表¶
要重新发布数据列表，请执行以下操作：
以账户管理员身份，使用 Snowsight 登录到数据交换。
在导航菜单中，选择 Data Products » Private Sharing » Shared by My Account。
选择要重新发布的列表名称。
在右上角的下拉列表中，选择 Re-publish。
选择 Re-publish 重新发布列表。