ALTER BUDGET

Nome totalmente qualificado: SNOWFLAKE.CORE.BUDGET

Modifica as propriedades de um orçamento personalizado:

  • Renomeia o orçamento.

  • Define ou desmarca uma tag.

  • Define ou desmarca o comentário.

Consulte também:

CREATE BUDGET, SHOW BUDGET, DROP BUDGET

Sintaxe

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> UNSET COMMENT

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> UNSET TAG <tag_name> [ , <tag_name> ... ]
Copy

Parâmetros

name

Especifica o identificador (ou seja, nome) do orçamento.

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

Especifica uma ou mais propriedades de orçamento a serem definidas.

COMMENT = 'string_literal'

Define o comentário do orçamento. Isso também pode ser feito usando o comando COMMENT.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Especifica o nome da tag e o valor da cadeia de caracteres dela.

O valor de tag é sempre uma cadeia de caracteres, e o número máximo de caracteres do valor da tag é 256.

Para obter informações sobre como especificar tags em uma instrução, consulte Cotas de tags para objetos e colunas.

UNSET ...

Especifica uma (ou mais) propriedades e/ou parâmetros a serem desmarcados para o orçamento, que os redefine aos padrões:

  • COMMENT

  • TAG tag_name [ , tag_name ... ]

Requisitos de controle de acesso

Uma função usada para executar este comando SQL deve ter os seguintes privilégios no mínimo:

Privilégio/Função

Objeto

Notas

ADMIN

Budget

A função usada para modificar as propriedades de um orçamento personalizado deve receber esta função de instância.

Observe que operar em qualquer objeto de um esquema também requer o privilégio USAGE no banco de dados e esquema principais.

Para obter mais informações, consulte Funções e privilégios do Budgets.

Notas de uso

  • Você só pode modificar as propriedades para um orçamento personalizado.

  • Para se referir a esta classe pelo seu nome não qualificado, inclua o banco de dados e o esquema da classe em seu caminho de busca.

Exemplos

Defina a tag dept para o orçamento my_budget no esquema atual:

ALTER SNOWFLAKE.CORE.BUDGET my_budget SET TAG dept = 'finance';
Copy
Linguagem: Português