ALTER CONTACT

Modifica as propriedades de um contato existente.

Consulte também:

CREATE CONTACT , DROP CONTACT , SHOW CONTACTS

Sintaxe

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

Parâmetros

name

Especifica o identificador do contato a ser alterado.

Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

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

RENAME TO new_name

Altera o nome do contato para new_name. O novo identificador deve ser único para o esquema.

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

Você pode mover o objeto para um banco de dados e/ou esquema diferente enquanto opcionalmente renomeia o objeto. Para isso, especifique um valor qualificado new_name que inclua o novo banco de dados e/ou nome do esquema no formulário db_name.schema_name.object_name ou schema_name.object_name, respectivamente.

Nota

  • O banco de dados e/ou esquema de destino já deve existir. Além disso, um objeto com o mesmo nome não pode já existir no banco de dados de destino; caso contrário, a instrução retorna um erro.

  • É proibido mover um objeto para um esquema de acesso gerenciado a menos que o proprietário do objeto (ou seja, a função que tem o privilégio OWNERSHIP sobre o objeto) também possua o esquema de destino.

Quando um contato é renomeado, outros objetos que fazem referência a ele devem ser atualizados com o novo nome.

SET ...

Define um dos seguintes parâmetros para o contato:

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 = '<string_literal>'

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

Requisitos de controle de acesso

Uma função usada para executar esse comando SQL deve ter pelo menos um dos seguintes privilégios, no mínimo:

Privilégio

Objeto

Notas

MODIFY

Contatos

OWNERSHIP

Contatos

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

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.

Exemplos

ALTER CONTACT my_contact SET EMAIL_DISTRIBUTION_LIST = 'support@example.com';
Copy