ALTER ORGANIZATION PROFILE¶
Modifica as propriedades de um perfil de organização.
- Consulte também:
CREATE ORGANIZATION PROFILE, DESCRIBE AVAILABLE ORGANIZATION PROFILE, DESCRIBE ORGANIZATION PROFILE, DROP ORGANIZATION PROFILE, SHOW AVAILABLE ORGANIZATION PROFILES, SHOW ORGANIZATION PROFILES, SHOW VERSIONS IN ORGANIZATION PROFILE
Sintaxe¶
ALTER ORGANIZATION PROFILE [ IF EXISTS ] <name> RENAME TO <new_name>
ALTER ORGANIZATION PROFILE [ IF EXISTS ] <name> PUBLISH
ALTER ORGANIZATION PROFILE <name> ADD VERSION [ [ IF NOT EXISTS ] <version_alias_name> ]
FROM @<yaml_manifest_stage_location>
ALTER ORGANIZATION PROFILE <name> ADD LIVE VERSION [ [ IF NOT EXISTS ] <version_alias_name> ]
FROM LAST
ALTER ORGANIZATION PROFILE <name> COMMIT
ALTER ORGANIZATION PROFILE <name> ABORT
Parâmetros¶
name
Especifica o identificador (nome) do perfil da organização que está sendo alterado. Os nomes dos perfis da organização só podem conter caracteres maiúsculos ou números e devem começar com um caractere maiúsculo.
RENAME TO new_name
Altera o nome do perfil da organização para
new_name
. O novo identificador deve ser exclusivo dentro da organização atual. O identificador deve estar em conformidade com os requisitos para identificadores do Snowflake. Consulte Requisitos para identificadores. Além disso, os nomes dos perfis de organização só podem conter caracteres maiúsculos ou números e devem começar com um caractere maiúsculo.Nota
Um perfil de organização com o mesmo nome não pode já existir na organização; caso contrário, a instrução retorna um erro.
PUBLISH
Torna detectável um perfil de organização que antes não podia ser descoberto.
ADD VERSION [ [ IF NOT EXISTS ] version_alias_name ]
Especifica o identificador de versão exclusivo para a versão que está sendo adicionada. Se
version_alias_name
não for especificado, um alias não será criado. Se o identificador contiver espaços, caracteres especiais ou caracteres com letras maiúsculas e minúsculas, o identificador inteiro deverá ser colocado entre aspas duplas. Identificadores entre aspas duplas também diferenciam maiúsculas de minúsculas. As palavras-chave FIRST, LAST, DEFAULT e LIVE são reservadas como atalhos de versão e não podem ser usadas. O identificador exclusivo de versão não pode começar com “version$” e não pode conter barras ( / ). Para obter informações sobre a sintaxe do identificador, consulte Requisitos para identificadores.ADD LIVE VERSION [ [ IF NOT EXISTS ] version_alias_name ]
Adiciona uma nova versão editável ao vivo com o nome especificado da última versão confirmada.
version_alias_name
é opcional e, se não for especificado, um alias não será criado. Se o identificador contiver espaços, caracteres especiais ou caracteres com letras maiúsculas e minúsculas, o identificador inteiro deverá ser colocado entre aspas duplas. Identificadores entre aspas duplas também diferenciam maiúsculas de minúsculas. As palavras-chave FIRST, LAST, DEFAULT e LIVE são reservadas como atalhos de versão e não podem ser usadas. O identificador exclusivo de versão não pode começar com “version$” e não pode conter barras ( / ). Para obter informações sobre a sintaxe do identificador, consulte Requisitos para identificadores.As alterações feitas nos arquivos em uma versão ativa não são aplicadas ao perfil da organização até que a versão ativa seja confirmada. As propriedades de um perfil de organização permanecem inalteradas até que a versão ativa seja confirmada.
FROM 'yaml_manifest_stage_location'
Especifica o estágio externo, o estágio interno ou o local do estágio do manifesto do formato do clone do repositório Git YAML do Snowflake.
COMMIT
Confirma as alterações no perfil da organização. A versão ativa que está sendo confirmada deve conter um arquivo de manifesto de perfil de organização válido.
ABORT
Descarta as alterações no perfil da organização.
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 ou MODIFY |
Perfil da organização |
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¶
Os perfis da organização podem ser renomeados somente quando estiverem no estado de rascunho.
Ao definir a versão ativa do manifesto do formato YAML para um perfil de organização, você deve usar COMMIT para aplicar as alterações ou ABORT para descartar as alterações. Um perfil de organização só pode ter uma versão ativa por vez.
Exemplos¶
Alterar o perfil da organização MYORGPROFILE para usar um arquivo de manifesto atualizado:
ALTER ORGANIZATION PROFILE MYORGPROFILE ADD VERSION V2 FROM @STAGE_PATH_WITH_UPDATED_MANIFEST;
Publicar o perfil da organização MYORGPROFILE:
ALTER ORGANIZATION PROFILE MYORGPROFILE PUBLISH;