准备创建共享
在创建共享之前，Snowflake 建议确定您计划共享的 Snowflake 对象：
数据库
表
动态表
外部表
Iceberg 表
安全视图
安全的物化视图
安全的用户定义函数 (UDFs)
这可能需要执行一些额外的规划和管理任务，特别是当您决定仅共享任何表中的数据子集时。
数据库和表
如果您计划共享数据库，则只需进行少量准备或无需准备。
如果您计划共享整个表，则无需进行任何准备。
但是，如果您决定根据特定条件或按使用者账户筛选表（或表集）中的数据，则必须在表上创建一个或多个安全视图。
安全对象（视图、物化视图和 UDFs）
若要严格控制对共享数据库中数据的访问，则 必须 使用 安全视图、安全的物化视图 和/或 安全的 UDFs。例如，您可以选择按日期或其他条件筛选数据，也可以决定使用单个共享来对不同使用者账户的共享数据进行分区。通过安全对象，您可以指定要应用于数据的粒度级别，同时确保不会公开基表和业务逻辑。
与标准对象类似，安全对象也是使用相应的 CREATE <object> 或 ALTER <object> 命令来定义。但是，请注意以下重要的用法信息：
通过完全限定名称（即 <db_name>.<schema_name>.<table_name>）引用表的安全对象可以包含在共享中；但是，必须确保引用的数据库名称与共享的数据库 匹配。
不要 在 CURRENT_USER 或 CURRENT_ROLE 函数的定义中包含使用了这两个函数的安全对象。这两个函数返回的上下文值与使用者的账户无关，并且会导致对象在被查询/使用时失败。
在定义要与使用者账户共享的安全对象时，要执行的一个关键/重要附加步骤是：验证对象是否正确配置为仅显示您希望显示的数据。如果您希望根据与之共享数据的账户限制数据访问，这一点尤为重要。为了便于执行此验证，Snowflake 提供了 SIMULATED_DATA_SHARING_CONSUMER 会话参数。SIMULATED_DATA_SHARING_CONSUMER 会话参数仅支持安全视图和安全的物化视图，而不支持安全的 UDFs。通过在会话中设置此参数，您可以在计划与之共享安全视图的任何使用者账户中，模拟以用户身份查询该视图。
例如，对于使用者账户 xy12345：
ALTER SESSION SET SIMULATED_DATA_SHARING_CONSUMER = xy12345;
有关详细示例，请参阅 使用安全对象控制数据访问。
共享对象上的流
数据使用者可以在自己的数据库中创建流，以记录对源表或源视图所做的数据操作语言 (DML) 更改。
备注
此处列出的操作不受支持：
不支持在辅助源对象的共享上创建仅追加流。
不支持修改其他账户中的流。
您可以允许使用者在共享表或安全视图上创建流。在执行此操作之前，您需要延长表的数据保留期，并且还需要在共享表或共享视图的基础表上启用更改跟踪。在使用 CREATE TABLE 或 ALTER TABLE 创建或更改表时，可以设置 CHANGE_TRACKING 和 DATA_RETENTION_TIME_IN_DAYS 参数。
- 启用更改跟踪:
目前，当创建本地表的第一个流时，表中会自动添加一对隐藏列，而且这对列会开始存储更改跟踪元数据。由于共享的使用者无法修改源数据库，因此，无法对共享表进行此更改。要为计划用于共享的表启用更改跟踪，请在每个表上执行 ALTER TABLE ... CHANGE_TRACKING = TRUE。
- 延长表的数据保留期:
如果未定期使用本地表上的流，Snowflake 会暂时延长源表的数据保留期，以帮助避免过期。
共享表上的流不会延长表的数据保留期。同样，共享视图上的流不会延长基础表的数据保留期。若要手动为任何共享表或共享视图的任何基础表指定更长的数据保留期，请设置表的 DATA_RETENTION_TIME_IN_DAYS 参数。
共享的标签引用
数据共享提供商可以在对象上设置标签，并与数据共享使用者共享标签和标记的对象。此外，共享对象的标签引用可供使用者使用。共享标签引用允许提供商共享有关共享对象的其他上下文，例如基于标签字符串值的表或列的数据敏感度。
使用者可使用 SQL 查看共享对象上的标签分配，并确定共享对象的标签引用。通过查看共享对象的标签分配和引用，使用者账户中的数据管理员可以提供有关数据来源和数据使用方式的更全面评估。这些新的见解有助于确保遵守法规。
提供商必须在与标记的对象相同的数据库中创建标签，并共享此数据库。共享数据库后，如果提供商从共享对象中取消设置标签，则使用者账户中也会发生标签分配的更改。一旦取消设置标签，使用者就无法使用该标签跟踪共享对象。通过取消设置标签，提供商可以在无意中标记了对象时保持数据处理权。
标签沿袭 适用于共享数据库中的标记对象。例如，如果提供商在共享数据库中的架构上设置标签，则该架构中的对象和列也会受到标记。但是，使用者无法使用 Information Schema TAG_REFERENCES 表函数来确定提供商最初设置标签的位置。Snowflake 会在该表函数的输出中隐藏 LEVEL 列中的值，以通过不显示最初设置标签的位置来保护数据提供商。
重要
共享标签是只读的。使用者无法在其账户中的对象上设置共享标签。
- 提供商选择
若要共享标签，提供商具有以下选择：
使用 SQL 允许共享访问标签，并允许使用者查看共享对象上的共享标签分配。
提供商必须授予每个标签的 READ 权限，才能使标签可供使用者使用。
GRANT READ ON TAG mydb.tags.tag1 TO SHARE my_share;
GRANT USAGE ON DATABASE mydb TO SHARE my_share;
GRANT USAGE ON SCHEMA mydb.tags TO SHARE my_share;
创建数据库角色，将标签的 READ 权限授予数据库角色，并 将数据库角色授予共享。数据库角色还需要存储标签的架构的 USAGE 权限。
GRANT READ ON TAG mydb.tags.tag1 TO DATABASE ROLE my_db_role;
GRANT USAGE ON SCHEMA mydb.tags TO DATABASE ROLE my_db_role;
GRANT DATABASE ROLE my_db_role TO SHARE my_share;
- 使用者选择
若要查看使用者账户中的共享标签，使用者具有以下选择：
使用 ACCOUNTADMIN 角色。使用者账户管理员可以查看提供商提供的共享标签。
使用具有 IMPORTED PRIVILEGES 的角色。对于从共享创建的数据库，如果账户角色被授予该数据库的 IMPORTED PRIVILEGES，或继承具有这些权限的角色，则可以查看提供商提供的共享标签。
GRANT IMPORTED PRIVILEGES ON DATABASE db_share TO ROLE db_share_role;
使用共享数据库角色。如果提供商将标签的 READ 权限授予数据库角色并共享数据库角色，则使用者可以将共享的数据库角色授予其账户中的账户角色。
GRANT DATABASE ROLE my_db_role TO ROLE consumer_analyst_role;
在使用者账户中，您可以使用 SQL 查看提供商共享的标签、标签引用和标记的对象：
目前，您无法在使用者账户中使用以下选择来查看提供商共享的标签、标签引用和标记的对象：
维护共享
要管理共享，您必须使用具有共享的 OWNERSHIP 权限和 CREATE SHARE 全局权限的角色。
向共享添加对象
可以随时将对象添加到现有共享。添加到共享的对象立即可供已从该共享创建数据库的使用者账户使用。例如，如果将表添加到共享中，则使用者账户中的用户可以在表添加到共享后立即查询表中的数据。
重要
如果计划在不同 区域 或 云平台 上与数据使用者安全地共享数据，请注意，如果主数据库包含某些类型的对象，则系统会阻止复制主数据库。有关会导致刷新操作失败的对象的完整列表，请参阅 当前复制的局限性。
使用 Snowsight 将对象添加到共享
要使用 Snowsight 修改与共享关联的数据，请执行以下步骤：
登录 Snowsight。
选择 Data Products » Private Sharing。
选择 Shared by Your Account 选项卡。
找到并选择要修改的共享。
在 Data 部分中，选择 Edit。
选择要添加的数据。
选择 Done。
备注
目前，Web 界面不支持在共享中添加或移除外部表、安全的物化视图或安全的 UDFs。对共享中这些对象的所有管理都必须使用 SQL 来执行。
您无法使用 Web 界面将引用其他数据库中的对象的安全视图添加到共享中。您必须使用 SQL 创建共享。请参阅 共享来自多个数据库的数据。
使用 Classic Console 将对象添加到共享
在 Classic Console 的 Shares 
页面上，选择 Outbound 选项卡。
使用 SQL 将对象添加到共享
使用 GRANT <privilege> ...TO SHARE 命令。
以下示例将 aggregates_eula 架构中名为 agg_secure 的安全视图添加到 sales_s 共享中：
SHOW GRANTS TO SHARE sales_s;
+-------------------------------+-----------+------------+--------------------------------------+------------+----------------+--------------+--------------+
| created_on | privilege | granted_on | name | granted_to | grantee_name | grant_option | granted_by |
|-------------------------------+-----------+------------+--------------------------------------+------------+----------------+--------------+--------------|
| 2017-06-15 16:45:07.307 -0700 | USAGE | DATABASE | SALES_DB | SHARE | PRVDR1.SALES_S | false | ACCOUNTADMIN |
| 2017-06-15 16:45:10.310 -0700 | USAGE | SCHEMA | SALES_DB.AGGREGATES_EULA | SHARE | PRVDR1.SALES_S | false | ACCOUNTADMIN |
| 2017-06-15 16:45:12.312 -0700 | SELECT | TABLE | SALES_DB.AGGREGATES_EULA.AGGREGATE_1 | SHARE | PRVDR1.SALES_S | false | ACCOUNTADMIN |
+-------------------------------+-----------+------------+--------------------------------------+------------+----------------+--------------+--------------+
GRANT SELECT ON VIEW sales_db.aggregates_eula.agg_secure TO SHARE sales_s;
SHOW GRANTS TO SHARE sales_s;
+-------------------------------+-----------+------------+--------------------------------------+------------+----------------+--------------+--------------+
| created_on | privilege | granted_on | name | granted_to | grantee_name | grant_option | granted_by |
|-------------------------------+-----------+------------+--------------------------------------+------------+----------------+--------------+--------------|
| 2017-06-15 16:45:07.307 -0700 | USAGE | DATABASE | SALES_DB | SHARE | PRVDR1.SALES_S | false | ACCOUNTADMIN |
| 2017-06-15 16:45:10.310 -0700 | USAGE | SCHEMA | SALES_DB.AGGREGATES_EULA | SHARE | PRVDR1.SALES_S | false | ACCOUNTADMIN |
| 2017-06-15 16:45:12.312 -0700 | SELECT | TABLE | SALES_DB.AGGREGATES_EULA.AGGREGATE_1 | SHARE | PRVDR1.SALES_S | false | ACCOUNTADMIN |
| 2017-06-17 12:33:15.310 -0700 | SELECT | TABLE | SALES_DB.AGGREGATES_EULA.AGG_SECURE | SHARE | PRVDR1.SALES_S | false | ACCOUNTADMIN |
+-------------------------------+-----------+------------+--------------------------------------+------------+----------------+--------------+--------------+
从共享中移除对象
您可以随时从现有共享中移除对象。从共享中移除的任何对象会立即对已从该共享创建数据库的使用者账户不可用。
例如，如果从共享中移除表，则一旦从共享中移除表，使用者账户中的用户就无法再查询表中的数据。
备注
目前，Web 界面不支持在共享中添加或移除外部表、安全的物化视图或安全的 UDFs。对共享中这些对象的所有管理都必须使用 SQL 来执行。
使用 Snowsight 从共享中删除对象
要使用 Snowsight 移除与共享关联的数据，请执行以下步骤：
登录 Snowsight。
选择 Data Products » Private Sharing。
选择 Shared by Your Account 选项卡。
找到并选择要修改的共享。
在 Data 部分中，选择 Edit。
选择共享中的数据，然后取消选中要从共享中移除的数据的复选框。
选择 Done。
使用 Classic Console 从共享中删除对象
在 Classic Console 的 Shares 页面上，选择 Outbound 选项卡。
使用 SQL 从共享中删除对象
随时可以使用 REVOKE <privilege> ...FROM SHARE 命令从现有共享中移除对象。
以下示例从 sales_s 共享中移除 aggregates_eula 架构中名为 agg_secure 的安全视图：
SHOW GRANTS TO SHARE sales_s;
+-------------------------------+-----------+------------+--------------------------------------+------------+----------------+--------------+--------------+
| created_on | privilege | granted_on | name | granted_to | grantee_name | grant_option | granted_by |
|-------------------------------+-----------+------------+--------------------------------------+------------+----------------+--------------+--------------|
| 2017-06-15 16:45:07.307 -0700 | USAGE | DATABASE | SALES_DB | SHARE | PRVDR1.SALES_S | false | ACCOUNTADMIN |
| 2017-06-15 16:45:10.310 -0700 | USAGE | SCHEMA | SALES_DB.AGGREGATES_EULA | SHARE | PRVDR1.SALES_S | false | ACCOUNTADMIN |
| 2017-06-15 16:45:12.312 -0700 | SELECT | TABLE | SALES_DB.AGGREGATES_EULA.AGGREGATE_1 | SHARE | PRVDR1.SALES_S | false | ACCOUNTADMIN |
| 2017-06-17 12:33:15.310 -0700 | SELECT | TABLE | SALES_DB.AGGREGATES_EULA.AGG_SECURE | SHARE | PRVDR1.SALES_S | false | ACCOUNTADMIN |
+-------------------------------+-----------+------------+--------------------------------------+------------+----------------+--------------+--------------+
REVOKE SELECT ON VIEW sales_db.aggregates_eula.agg_secure FROM SHARE sales_s;
+-------------------------------+-----------+------------+--------------------------------------+------------+----------------+--------------+--------------+
| created_on | privilege | granted_on | name | granted_to | grantee_name | grant_option | granted_by |
|-------------------------------+-----------+------------+--------------------------------------+------------+----------------+--------------+--------------|
| 2017-06-15 16:45:07.307 -0700 | USAGE | DATABASE | SALES_DB | SHARE | PRVDR1.SALES_S | false | ACCOUNTADMIN |
| 2017-06-15 16:45:10.310 -0700 | USAGE | SCHEMA | SALES_DB.AGGREGATES_EULA | SHARE | PRVDR1.SALES_S | false | ACCOUNTADMIN |
| 2017-06-15 16:45:12.312 -0700 | SELECT | TABLE | SALES_DB.AGGREGATES_EULA.AGGREGATE_1 | SHARE | PRVDR1.SALES_S | false | ACCOUNTADMIN |
+-------------------------------+-----------+------------+--------------------------------------+------------+----------------+--------------+--------------+
将账户添加到共享
可以随时将账户添加到现有共享。将账户添加到共享后，共享将立即对账户“可见”，并且账户可以从共享创建数据库，以及开始查询数据库中的 Snowflake 对象。
使用 Snowsight 将账户添加到共享
要使用 Snowsight 将使用者添加到现有共享，请执行以下步骤：
登录 Snowsight。
选择 Data Products » Private Sharing。
选择 Shared by Your Account 选项卡。
找到要修改的共享。
在 Shared With 部分中，选择 Add Consumers。
对于 Share With Snowflake Accounts，输入一个或多个账户定位器。输入账户定位器的一部分会列出所有匹配的账户。
选择 Add。
使用 Classic Console 将账户添加到共享
在 Classic Console 的 Shares 页面上，选择 Outbound 选项卡。
添加账户时，可以选择添加完整账户或阅读者账户。也可以选择立即创建阅读者账户，然后将其添加到共享中。
使用 SQL 将账户添加到共享
要使用 SQL 将使用者添加到现有共享，请使用 ALTER SHARE 命令。
从共享中移除账户
您可以随时从现有共享中移除账户。从共享中移除账户会立即使账户从共享中创建的数据库失效。账户中的用户对数据库执行的所有查询和其他操作都将停止工作。
从共享中移除账户后，可以将其重新添加回共享中；但是，这不会恢复账户早前从共享中创建的数据库。账户必须从共享中创建新数据库。
备注
在从共享中移除账户之前，请考虑这将对账户产生的下游影响。由于数据库会立即失效，因此账户中的用户对数据库执行的所有查询和其他操作都将停止工作，这可能会对账户的业务运营产生重大影响。
使用 Snowsight 从共享中删除账户
要使用 Snowsight 从现有共享中移除使用者，请执行以下步骤：
登录 Snowsight。
选择 Data Products » Private Sharing。
选择 Shared by Your Account 选项卡。
找到并选择要修改的共享。
在 Shared With 部分中，选择 ... » Remove。
在确认对话框中，选择 Remove。
使用 Classic Console 从共享中删除账户
在 Classic Console 的 Shares 页面上，选择 Outbound 选项卡。
使用 SQL 从共享中删除账户
使用 ALTER SHARE 命令从现有共享中移除账户。
通过为共享设置新的账户列表，并将所需的账户从该列表中排除，即可从共享中移除账户。
删除共享
您可以随时删除（移除）共享。删除共享后，使用者账户从该共享中创建的所有数据库会立即失效。对这些数据库执行的所有查询和其他操作都会停止工作。
删除共享后，可以使用相同的名称重新创建它；但是，这不会恢复使用者账户从共享中创建的任何数据库。重新创建的共享将被视为新共享，所有使用者账户都必须从新共享中创建新数据库。
备注
删除共享之前，请考虑这将对使用该共享的所有使用者账户产生的下游影响。
您可能要考虑从共享中移除单个对象。移除的对象可以重新添加到共享中，而无需使用者账户执行任何其他任务。
使用 Snowsight 删除共享
要使用 Snowsight 删除共享，请执行以下步骤：
登录 Snowsight。
选择 Data Products » Private Sharing。
选择 Shared by Your Account 选项卡。
找到并选择要删除的共享。
选择 ... » Drop。
在确认对话框中，选择 Drop。
使用 Classic Console 删除共享
在 Classic Console 的 Shares 页面上，选择 Outbound 选项卡。