ALTER FEATURE POLICY

Altera ou renomeia uma política de recursos.

Consulte também:

CREATE FEATURE POLICY , DESCRIBE FEATURE POLICY, DROP FEATURE POLICY, SHOW FEATURE POLICIES

Sintaxe

ALTER FEATURE POLICY [ IF EXISTS ] <name> SET
  [ BLOCKED_OBJECT_TYPES_FOR_CREATION = ( [ <type> [ , <type>  ... ] ] ) ]
  [ COMMENT = '<string_literal>' ]

ALTER FEATURE POLICY [ IF EXISTS ] <name> UNSET
  [ BLOCKED_OBJECT_TYPES_FOR_CREATION ]
  [ COMMENT ]

ALTER FEATURE POLICY [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER FEATURE POLICY [ IF EXISTS ] <name> SET  TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER FEATURE POLICY [ IF EXISTS ] <name> UNSET TAG <tag_name> [ , ... ]
Copy

Parâmetros

name

Especifica o identificador da política de recursos 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

Especifica uma (ou mais) propriedades a serem definidas para a política de recursos.

BLOCKED_OBJECT_TYPES_FOR_CREATION = ( type [ , type ... ] )

Especifica os objetos que um aplicativo está proibido de criar.

Os valores possíveis são:

  • COMPUTE_POOLS

  • DATABASES

  • TASKS

  • WAREHOUSES

COMMENT = 'string_literal'

Cadeia de caracteres (literal) que especifica um comentário para a política de recursos.

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 Cota de tags para objetos.

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

APPLY FEATURE POLICY

Conta

Esse privilégio é necessário para definir uma política de recursos para a conta corrente.

APPLY ou OWNERSHIP

Política de recursos

Um desses privilégios é necessário para modificar uma política de recursos.

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

  • Se uma política anterior tiver sido aplicada à conta ou a um aplicativo, um erro será retornado, a menos que você especifique a opção FORCE para forçar a substituição da política existente.

  • Quando uma política de recursos é desvinculada de um aplicativo, a política no nível da conta entra em vigor, se existir.

Exemplos

O exemplo a seguir define a propriedade BLOCKED_OBJECT_TYPES_FOR_CREATION na política de recursos para proibir um aplicativo de criar bancos de dados ou tarefas:

ALTER FEATURE POLICY block_create_db_policy SET
  BLOCKED_OBJECT_TYPES_FOR_CREATION = (DATABASES, TASKS);
Copy

O exemplo a seguir altera o nome de uma política de recursos de block_create_db_policy para block_create_db_task_policy:

ALTER FEATURE POLICY block_create_db_policy RENAME TO block_create_db_task_policy;
Copy