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).

要对架构中的任何对象执行操作，需要对父数据库和架构的 USAGE 权限。请注意，如果某个角色获授某个架构的任意权限，该角色便能够解析该架构。例如，若某角色被授予 CREATE 权限，则可以在该架构上创建对象，而无需 同时 被授予该架构的 USAGE 权限。

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

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

使用说明

  • 关于元数据：

    注意

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

示例

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