ALTER DCM PROJECT

Modifica as propriedades de um projeto DCM existente.

Consulte também:

CREATE DCM PROJECT , DESCRIBE DCM PROJECT, DROP DCM PROJECT, EXECUTE DCM PROJECT, SHOW DCM PROJECTS, SHOW DEPLOYMENTS IN DCM PROJECT

Sintaxe

ALTER DCM PROJECT [ IF EXISTS ] <name> SET
  [ LOG_LEVEL = <log_level> ]
  [ COMMENT = '<string_literal>' ]

ALTER DCM PROJECT [ IF EXISTS ] <name> UNSET
  [ LOG_LEVEL ]
  [ COMMENT ]

Parâmetros obrigatórios

name

Especifica o identificador da DCM project a ser alterada.

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.

SET ...

Define uma ou mais propriedades ou parâmetros especificados para o DCM project:

Parâmetros opcionais
LOG_LEVEL = log_level

Define o nível de registro em log para o DCM project.

Para obter mais informações sobre os níveis, consulte LOG_LEVEL. Para obter informações sobre como configurar o nível de log, consulte Definição de níveis para registro, métricas e rastreamento.

O valor pode ser um dos seguintes:

  • TRACE

  • DEBUG

  • INFO

  • WARN

  • ERROR

  • FATAL

  • OFF

Padrão: OFF

COMMENT = 'string_literal'

Adiciona um comentário ou substitui um comentário existente para o DCM project.

UNSET ...

Renove a definição de uma ou mais propriedades ou parâmetros especificados para o DCM project, o que redefine as propriedades aos seus padrões:

  • LOG_LEVEL

  • COMMENT

Para desmarcar várias propriedades ou parâmetros com uma única instrução ALTER, separe cada propriedade ou parâmetro com uma vírgula.

Ao desmarcar uma propriedade ou parâmetro, especifique apenas o nome da propriedade ou parâmetro (a menos que a sintaxe acima indique que você deve especificar o valor). Especificar o valor retorna um erro.

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

OWNERSHIP

Projeto DCM

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

Operar em um objeto em um esquema requer pelo menos um privilégio no banco de dados pai e pelo menos um privilégio no esquema pai.

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

O exemplo a seguir define o nível de registro em log para o projeto DCM chamado my_project como DEBUG:

ALTER DCM PROJECT my_project SET LOG_LEVEL = DEBUG;

O exemplo a seguir adiciona um comentário ao projeto DCM chamado my_project:

ALTER DCM PROJECT my_project SET COMMENT = 'Updated project for Q4 data management';