ALTER CONTACT

修改现有 联系人 的属性。

另请参阅：

CREATE CONTACT、DROP CONTACT、SHOW CONTACTS

语法

ALTER CONTACT [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER CONTACT [ IF EXISTS ] <name> SET
  [ {
    USERS = ( '<user_name>' [ , '<user_name>' ... ] )
    | EMAIL_DISTRIBUTION_LIST = '<email>'
    | URL = '<url>'
    } ]
  [ COMMENT = '<string_literal>' ]
Copy

参数

name

指定要更改的联系人的标识符。

如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

有关更多信息，请参阅 标识符要求。

RENAME TO new_name

将联系人的姓名更改为 new_name。新的标识符必须在架构中是唯一的。

有关标识符的更多详细信息，请参阅 标识符要求。

可以将对象移动到其他数据库和/或架构，同时选择重命名对象。为此，请指定一个限定 new_name 值，该值分别以 db_name.schema_name.object_name 或 schema_name.object_name 的形式包含新数据库和/或架构名称。

备注

  • 目标数据库和/或架构必须已存在。此外，新位置中不能存在同名对象；否则，该语句将返回错误。

  • 除非 对象所有者（即拥有对象 OWNERSHIP 权限的角色）也拥有目标架构，否则禁止将对象移动到托管访问架构。

重命名联系人时，引用该联系人的其他对象必须使用新名称进行更新。

SET ...

为联系人设置以下参数之一：

USERS = ( 'user_name' [ , 'user_name' ... ] )

可以联系的 Snowflake 用户列表（以逗号分隔），这些用户通过其用户对象的名称指定。

如果用户名区分大小写或包含任何特殊字符或空格，则必须使用双引号。双引号必须放在单引号内。例如，如果用户是 joe@example.com，您必须指定 '"joe@example.com"'。

EMAIL_DISTRIBUTION_LIST = 'email'

一个有效的电子邮件地址；如果您希望用户能够联系多位人员，也可以使用邮件分发列表。

URL = 'url'

可用于就对象与他人联系的 URL。

COMMENT = '<string_literal>'

用户定义的字符串。指定联系人的注释。

访问控制要求

用于执行此 SQL 命令的 角色 必须至少具有以下 一项 权限：

权限

对象

备注

MODIFY

联系人

OWNERSHIP

联系人

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

使用说明

  • 关于元数据：

    注意

    客户应确保在使用 Snowflake 服务时，不会将个人数据（用户对象除外）、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息，请参阅 Snowflake 中的元数据字段。

示例

ALTER CONTACT my_contact SET EMAIL_DISTRIBUTION_LIST = 'support@example.com';
Copy
语言: 中文