CREATE CONTACT

Cria um novo contato ou substitui um contato existente.

Consulte também:

ALTER CONTACT , DROP CONTACT , SHOW CONTACTS

Sintaxe

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

Parâmetros obrigatórios

name

Especifica o nome do novo contato.

Além disso, o identificador deve começar com um caractere alfabético e não pode conter espaços ou caracteres especiais, a menos que toda a cadeia de caracteres do identificador esteja entre aspas duplas (por exemplo, "My object"). Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

Parâmetros opcionais

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

Lista delimitada por vírgulas de usuários do Snowflake que podem ser contatados, especificados pelo nome de seus objetos de usuário.

EMAIL_DISTRIBUTION_LIST = 'email'

Um endereço de e-mail válido, que pode ser uma lista de distribuição se você quiser que os usuários possam entrar em contato com mais de uma pessoa.

URL = 'url'

Um URL que pode ser usado para contatar pessoas sobre um objeto.

COMMENT

Uma cadeia de caracteres definida pelo usuário. Especifica um comentário para o contato.

Requisitos de controle de acesso

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:

Privilégio

Objeto

Notas

CREATE CONTACT

Esquema

O privilégio USAGE no banco de dados e no esquema pai é necessário para executar operações em qualquer objeto de um esquema.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso

  • Em relação aos metadados:

    Atenção

    Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

  • Instruções CREATE OR REPLACE <object> são atômicas. Ou seja, quando um objeto é substituído, o objeto antigo é excluído e o novo objeto é criado em uma única transação.

Exemplos

CREATE CONTACT my_contact
  EMAIL_DISTRIBUTION_LIST = 'comany_support@example.com';
Copy