ALTER ACCOUNT

Modifica uma conta. Pode ser usado para modificar qualquer tipo de parâmetro (conta, sessão ou objeto) no nível da conta. Também usado para renomear uma conta e atribuir monitores de recursos e tags a uma conta. O comando só pode ser executado por:

  • Administradores de conta (ou seja, usuários com a função ACCOUNTADMIN) para definir e cancelar definições:

    • Parâmetros de conta, que não podem ser alterados por nenhum outro usuário.

    • Parâmetros de sessão e objeto, que servem como padrão de parâmetros para os usuários, sessões e objetos relevantes. Esses padrões podem ser anulados a qualquer momento.

    • Monitores de recursos

    • Tags

  • Administradores de segurança (ou seja, usuários com a função SECURITYADMIN) ou uma função superior para definir e remover o parâmetro de conta NETWORK_POLICY.

  • Administradores da organização (ou seja, usuários com a função ORGADMIN) para:

    • Renomear uma conta e especificar se o URL original pode ser usado para acessar a conta.

    • Ativar a função ORGADMIN em uma conta.

Também pode ser usado para especificar um monitor de recursos para controlar o uso de crédito para todos os warehouses virtuais criados na conta.

Para obter mais informações sobre a definição de parâmetros no nível da conta, consulte Gerenciamento de parâmetros. Para detalhes dos parâmetros, consulte Parâmetros.

Sintaxe

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

Alteração da conta atual

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

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

ALTER ACCOUNT SET RESOURCE_MONITOR = <monitor_name>

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

ALTER ACCOUNT UNSET { AUTHENTICATION | PASSWORD | SESSION } POLICY

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

Onde:

accountParams ::=
    ALLOW_ID_TOKEN = TRUE | FALSE
    CLIENT_ENCRYPTION_KEY_SIZE = <integer>
    ENABLE_INTERNAL_STAGES_PRIVATELINK = TRUE | FALSE
    ENFORCE_NETWORK_RULES_FOR_INTERNAL_STAGES = TRUE | FALSE
    EXTERNAL_OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST = TRUE | FALSE
    INITIAL_REPLICATION_SIZE_LIMIT_IN_TB = <num>
    NETWORK_POLICY = <string>
    OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST = TRUE | FALSE
    PERIODIC_DATA_REKEYING = TRUE | FALSE
    PREVENT_UNLOAD_TO_INLINE_URL = TRUE | FALSE
    PREVENT_UNLOAD_TO_INTERNAL_STAGES = TRUE | FALSE
    REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_CREATION = TRUE | FALSE
    REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_OPERATION = TRUE | FALSE
    SAML_IDENTITY_PROVIDER = <json_object>
    SSO_LOGIN_PAGE = TRUE | FALSE
Copy
objectParams ::=
    DATA_RETENTION_TIME_IN_DAYS = <integer>
    ENABLE_UNREDACTED_QUERY_SYNTAX_ERROR = TRUE | FALSE
    MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer>
    DEFAULT_DDL_COLLATION = '<collation_specification>'
    MAX_CONCURRENCY_LEVEL = <num>
    NETWORK_POLICY = <string>
    PIPE_EXECUTION_PAUSED = TRUE | FALSE
    STATEMENT_QUEUED_TIMEOUT_IN_SECONDS = <num>
    STATEMENT_TIMEOUT_IN_SECONDS = <num>
Copy
sessionParams ::=
    ABORT_DETACHED_QUERY = TRUE | FALSE
    AUTOCOMMIT = TRUE | FALSE
    BINARY_INPUT_FORMAT = <string>
    BINARY_OUTPUT_FORMAT = <string>
    DATE_INPUT_FORMAT = <string>
    DATE_OUTPUT_FORMAT = <string>
    ERROR_ON_NONDETERMINISTIC_MERGE = TRUE | FALSE
    ERROR_ON_NONDETERMINISTIC_UPDATE = TRUE | FALSE
    JSON_INDENT = <num>
    LOCK_TIMEOUT = <num>
    QUERY_TAG = <string>
    ROWS_PER_RESULTSET = <num>
    S3_STAGE_VPCE_DNS_NAME = <string>
    SEARCH_PATH = <string>
    SIMULATED_DATA_SHARING_CONSUMER = <string>
    STATEMENT_TIMEOUT_IN_SECONDS = <num>
    STRICT_JSON_OUTPUT = TRUE | FALSE
    TIMESTAMP_DAY_IS_ALWAYS_24H = TRUE | FALSE
    TIMESTAMP_INPUT_FORMAT = <string>
    TIMESTAMP_LTZ_OUTPUT_FORMAT = <string>
    TIMESTAMP_NTZ_OUTPUT_FORMAT = <string>
    TIMESTAMP_OUTPUT_FORMAT = <string>
    TIMESTAMP_TYPE_MAPPING = <string>
    TIMESTAMP_TZ_OUTPUT_FORMAT = <string>
    TIMEZONE = <string>
    TIME_INPUT_FORMAT = <string>
    TIME_OUTPUT_FORMAT = <string>
    TRANSACTION_DEFAULT_ISOLATION_LEVEL = <string>
    TWO_DIGIT_CENTURY_START = <num>
    UNSUPPORTED_DDL_ACTION = <string>
    USE_CACHED_RESULT = TRUE | FALSE
    WEEK_OF_YEAR_POLICY = <num>
    WEEK_START = <num>
Copy

Nota

Para fins de legibilidade, a lista completa de parâmetros de sessão que podem ser definidos para uma conta não está incluída aqui. Para uma lista completa de todos os parâmetros de sessão com suas descrições, bem como parâmetros de conta e objeto, consulte Parâmetros.

Alteração de uma conta diferente

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
Copy

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 { AUTHENTICATION | PASSWORD | SESSION } POLICY policy_name

Especifica uma das seguintes políticas 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 informações 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