CREATE CONTACT

创建新 联系人 或替换现有联系人。

另请参阅：

ALTER CONTACT、DROP CONTACT、SHOW CONTACTS

语法

CREATE [ OR REPLACE ] CONTACT [ IF NOT EXISTS ] <name>
  [ {
    USERS = ( '<user-name>' [ , '<user_name>' ... ] )
    | EMAIL_DISTRIBUTION_LIST = '<email>'
    | URL = '<url>'
    } ]
  [ COMMENT = '<string_literal>' ]
Copy

必填参数

name

指定新联系人的姓名。

此外，标识符必须以字母字符开头，且不能包含空格或特殊字符，除非整个标识符字符串放在双引号内（例如，"My object"）。放在双引号内的标识符也区分大小写。

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

可选参数

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

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

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

EMAIL_DISTRIBUTION_LIST = 'email'

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

URL = 'url'

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

COMMENT

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

访问控制要求

用于执行此操作的 角色 必须至少具有以下 权限：

权限

对象

备注

CREATE CONTACT

架构

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

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

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

使用说明

  • 关于元数据：

    注意

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

  • CREATE OR REPLACE <object> 语句是原子的。也就是说，当对象被替换时，旧对象将被删除，新对象将在单个事务中创建。

示例

CREATE CONTACT my_contact
  EMAIL_DISTRIBUTION_LIST = 'company_support@example.com';
Copy
语言: 中文