使用联系人¶

继承和覆盖联系人¶

联系人由后代对象继承。如果将某个联系人关联到一个作为父对象的对象上，那么子对象、孙对象等各级下级对象都会继承该联系人。例如，如果您将联系人与架构相关联，则默认情况下，架构中的所有表都会继承该联系人。

如果子对象具有相同目的的联系人，则联系人继承将被覆盖。例如，假设有人将以下两个联系人与包含 t1 表的 ac_sch 架构相关联：

现在，假设有人出于访问批准的目的将联系人 finance_dept 与 t1 关联。与 t1 关联的联系人现在如下：

负责 ac_schema 访问批准的联系人已替换为与 t1 直接关联的联系人，但 t1 将继续继承架构中的 data_stewards 联系人。

受支持对象¶

您可以将联系人与以下对象关联：

创建联系人¶

创建联系人时，您需要指定联系人的姓名以及他人应如何与该联系人通信。通信方法包括以下几种：

• 网站的 URL。

• 电子邮件地址，可以是通讯组列表。

• Snowflake 用户列表。

您可以使用 |sf-web-interface|或 SQL 创建联系人。在专用架构中创建所有联系人可能会很有帮助。

Snowsight:

1. 登录 Snowsight。

2. 选择 Data。

3. 导航到要创建联系人的架构。

4. 选择 Create » Contact。

5. 指定联系人的姓名。

6. 选择一种通信方式，然后指定数据用户在需要对象相关帮助时可联系的电子邮件地址、用户或 URL。

7. 选择能够将联系人与对象关联的角色。联系人授予这些角色 APPLY 权限。

8. 选择 Create。

SQL:

您可以执行 CREATE CONTACT 命令来创建新联系人。

示例

为通过其网站联系的支持团队创建联系人。

CREATE CONTACT support_dept URL = 'http://internalsupport.example.com';

Copy

为财务团队创建一个通过电子邮件地址联系的联络方式，该邮箱将作为分发列表使用。

CREATE CONTACT finance_dept EMAIL_DISTRIBUTION_LIST = 'fd_dl@example.com';

Copy

为数据库管理员创建联系人，以其 Snowflake 用户对象的名称进行标识。

CREATE CONTACT db_admins USERS = ('ex_admin1', 'ex_admin2');

Copy

将联系人与对象关联¶

将联系人与对象关联时，需要指定联系人的姓名以及联系人和对象之间关联的目的。当用户查看与某个对象关联的所有联系人时，他们将能够根据每个联系人的目的决定与谁通信。

将联系人与对象关联的目的可以是以下其中之一：

修改现有对象或创建新对象时，您可以关联联系人并定义其目的。

WITH CONTACT ( <purpose> = <contact_name> [ , <purpose> = <contact_name> ... ] )

CREATE TABLE t1 (col1 VARCHAR, col2 INT) WITH CONTACT (ACCESS_APPROVAL = finance_dept);

CREATE DATABASE my_db WITH CONTACT (SUPPORT = internal_support);

CREATE SCHEMA sch1 WITH CONTACT (STEWARD = data_stewards, ACCESS_APPROVAL = finance_dept);

将联系人与对象分离¶

Snowsight:

1. 登录 Snowsight。

2. 选择 Data » Databases。

3. 导航到对象。

4. 选择 Details 选项卡。

5. 找到 Assigned Contacts 部分并选择 Edit 图标。

6. 找到您要分离的联系人的目的（例如 Approver），然后使用下拉列表选择 None。

7. 选择 Save。

SQL:

ALTER ... UNSET CONTACT 命令允许您将联系人与对象分离。对于所有可以与联系人关联的对象，分离联系人的语法是相同的：

ALTER <object_type> <object_name>
  UNSET CONTACT <purpose>

Copy

您可以通过指定联系人和对象之间的关联目的来确定要分离的联系人，而不是通过联系人姓名。有关可以指定用于分离联系人的可能目的的列表，请参阅 预定义的目的。

例如，要分离作为表中 STEWARD 添加的联系人，请执行：

ALTER TABLE t1 UNSET CONTACT STEWARD;

Copy

备注

如果要对现有 Iceberg 表、外部表或动态表取消设置联系人，则必须使用 ALTER TABLE 命令。

查看对象的联系人¶

Snowsight:

当您导航到 Snowsight 中的某个对象时，与该对象关联的联系人会显示在 Details 选项卡上。

SQL:

对某个对象具有至少一项权限的用户可以使用 GET_CONTACTS 表格功能查看与该对象关联的联系人。该函数为与该对象关联的每个联系人返回一行。

例如，要列出表 t1 中的联系人，至少具有一项权限的用户可以执行以下操作：

SELECT *
  FROM TABLE(SNOWFLAKE.CORE.GET_CONTACTS('t1', 'TABLE'));

Copy

对于每个联系人，该函数列出了以下内容：

• 联系的目的。

• 联系人的通信方式。

• 联系人是直接与对象关联还是继承自父对象。

治理联系人及其关联¶

Snowsight:

要列出在架构中创建的联系人并深入了解特定联系人的详细信息，请执行以下操作：

1. 登录 Snowsight。

2. 使用 Data » Databases 菜单导航到架构。

3. 选择 Contacts 选项卡。

4. 如果要查看联系人的详细信息，包括与之关联的对象，请选择该联系人。

SQL:

ACCOUNT_USAGE 架构提供以下视图来帮助管理联系人：

• CONTACTS 视图 – 列出账户中的所有联系人。

• CONTACT_REFERENCES 视图 – 列出与联系人关联的对象。

访问控制权限¶

以下内容总结了用户使用联系人所需的权限。