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 用户列表（以逗号分隔），这些用户通过其用户对象的名称指定。

EMAIL_DISTRIBUTION_LIST = 'email'

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

URL = 'url'

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

COMMENT

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

访问控制要求

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

权限

对象

备注

CREATE CONTACT

架构

要对架构中的任何对象执行操作，需要对父数据库和架构具有 USAGE 权限。

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

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

使用说明

  • 关于元数据：

    注意

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

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

示例

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