ALTER ACCOUNT¶

Sintaxe¶

A sintaxe de ALTER ACCOUNT varia dependendo se você está modificando a conta atual ou uma conta diferente.

ALTER ACCOUNT SET { [ accountParams ] [ objectParams ] [ sessionParams ] }

ALTER ACCOUNT UNSET <param_name> [ , ... ]

ALTER ACCOUNT SET RESOURCE_MONITOR = <monitor_name>

ALTER ACCOUNT SET { PASSWORD | SESSION } POLICY <policy_name>

ALTER ACCOUNT SET PACKAGES POLICY <policy_name> [ FORCE ]

ALTER ACCOUNT UNSET { PACKAGES | PASSWORD | SESSION } POLICY

ALTER ACCOUNT SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER ACCOUNT UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER ACCOUNT <name> SET IS_ORG_ADMIN = { TRUE | FALSE }

ALTER ACCOUNT <name> RENAME TO <new_name> [ SAVE_OLD_URL = { TRUE | FALSE } ]

ALTER ACCOUNT <name> DROP OLD URL

ALTER ACCOUNT <name> DROP OLD ORGANIZATION URL

Parâmetros para alterar a conta atual¶

Use os seguintes parâmetros ao modificar a conta atual.

SET ...

Especifica um (ou mais) parâmetros de conta, sessão e objeto a serem definidos para sua conta (separados por espaços em branco, vírgulas ou novas linhas):

• Os parâmetros da conta não podem ser alterados por nenhum outro usuário.

• Os parâmetros de sessão e objeto definidos no nível de conta servem apenas como padrão e podem ser alterados por outros usuários.

Para descrições dos parâmetros que você pode definir para sua conta, consulte Parâmetros.

UNSET ...

Especifica um (ou mais) parâmetro de conta, sessão e objeto a ser removido de sua conta, o que os restaura aos padrões do sistema.

Você pode redefinir várias propriedades com uma única instrução ALTER; no entanto, cada propriedade deve ser separada por uma vírgula. Ao redefinir uma propriedade/parâmetro, especificar somente o nome; especificar um valor para a propriedade retornará um erro.

SET RESOURCE_MONITOR resource_monitor_name

Parâmetro especial que especifica o nome do monitor de recursos utilizado para controlar todos os warehouses virtuais criados na conta.

Importante

A definição de um monitor de recursos no nível de conta não afeta nenhum dos warehouses fornecidos pelo Snowflake que o Snowflake utiliza para Snowpipe, reclustering automático ou exibições materializadas. Os créditos consumidos por esses warehouses não contam para a cota de crédito de um monitor de recursos em nível de conta.

Para obter mais detalhes, consulte Como trabalhar com monitores de recursos.

SET { PASSWORD | SESSION } POLICY policy_name

Especifica a política de senhas ou a política de sessão a ser definida para a conta.

SET PACKAGES POLICY policy_name [ FORCE ]

Especifica a política de pacotes a ser definida para a conta. Se uma política de pacotes já estiver definida na conta atual, você poderá usar FORCE para definir a política de pacotes sem precisar cancelar a definição da política de pacotes primeiro.

UNSET { PACKAGES | PASSWORD | SESSION } POLICY

Desativa a política de pacotes, a política de senhas ou a política de sessão da conta.

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 mais detalhes sobre como especificar tags em uma instrução, consulte Cotas de tags para objetos e colunas.

Parâmetros para alterar uma conta diferente¶

Use os parâmetros a seguir ao usar a conta atual para modificar uma conta diferente. Somente administradores da organização (ou seja, usuários com a função ORGADMIN) podem usar estes parâmetros.

name

Especifica o nome da conta que está sendo modificada.

SET

Especifica uma propriedade de conta a ser definida para a conta.

IS_ORG_ADMIN = { TRUE | FALSE }

Define uma propriedade de conta que determina se a função ORGADMIN está habilitada na conta. Somente um administrador da organização (ou seja, usuário com a função ORGADMIN) pode definir a propriedade.

Para ativar a função ORGADMIN para uma conta, especifique SET IS_ORG_ADMIN = TRUE.

Você não pode definir a propriedade como FALSE na conta atual. Como solução alternativa, ative a função em uma conta diferente e alterne para essa conta antes de executar o comando ALTER ACCOUNT.

Por padrão, a função ORGADMIN pode ser habilitada em, no máximo, 8 contas. Se sua organização precisar de mais contas com a função ORGADMIN, entre em contato com o suporte Snowflake.

RENAME TO new_name

Muda o nome de uma conta para o nome especificado.

Os administradores da organização não podem renomear uma conta enquanto estiverem logados nela, portanto devem logar em uma conta diferente antes de executar o comando ALTER ACCOUNT. Se sua organização consiste em uma única conta que precisa ser renomeada, entre em contato com o suporte Snowflake.

SAVE_OLD_URL = { TRUE | FALSE }

Parâmetro opcional utilizado em conjunto com RENAME TO que preserva a URL da conta usada para acessar o Snowflake antes da renomeação. Por padrão, o Snowflake salva a URL original, o que significa que você pode acessar a conta com a URL antiga ou a URL que contém o novo nome da conta. Quando definido como FALSE, você deve usar a nova URL para acessar a conta.

Padrão

TRUE

DROP OLD URL

Remove o URL da conta original de uma conta que foi renomeada. Depois que a URL antiga é removida, você deve acessar a conta com a URL que contém o novo nome da conta.

Se uma conta tiver um URL de conta antigo porque foi movida para outra organização, tiver sua organização renomeada ou fizer parte de uma organização que foi fundida, use ALTER ACCOUNT… DROP OLD ORGANIZATION URL em vez disso.

DROP OLD ORGANIZATION URL

Remove o URL da conta original de uma conta após ocorrer uma das seguintes opções:

• Conta movida para outra organização

• A conta teve sua organização renomeada.

• A conta fazia parte de uma organização que foi fundida com outra organização.

Se uma conta tiver um URL de conta antiga porque a conta, e não a organização, foi renomeada, use o comando ALTER ACCOUNT … DROP OLD URL.

Notas de uso¶

• Os parâmetros da conta podem ser definidos apenas no nível da conta.

• Os parâmetros de sessão e objeto que são definidos usando este comando servem apenas como padrão:

  • Os parâmetros do usuário podem ser anulados no nível de usuário individual.

  • Os parâmetros da sessão podem ser anulados em nível de usuário individual e de sessão.

  • Os parâmetros do objeto podem ser anulados no nível do objeto individual.

• A definição de um monitor de recursos no nível de conta controla o uso de crédito para todos os warehouses virtuais criados na conta, mas não afeta o uso do crédito para nenhum dos warehouses fornecidos pelo Snowflake. Para obter mais detalhes, consulte Como trabalhar com monitores de recursos.

• 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¶

Associar uma política de redes chamada mypolicy à sua conta:

ALTER ACCOUNT SET NETWORK_POLICY = mypolicy;

Copy

Remover a associação da política de redes de sua conta:

ALTER ACCOUNT UNSET NETWORK_POLICY;

Copy

Defina a política de pacotes no nível da conta.

ALTER ACCOUNT SET PACKAGES POLICY packages_policy_prod_1 FORCE;

Copy

Nota

Se uma política de pacotes já estiver definida na conta atual, você poderá usar FORCE para definir a política de pacotes sem precisar cancelar a definição da política de pacotes primeiro.

Desative a política de pacotes.

ALTER ACCOUNT UNSET PACKAGES POLICY;

Copy