ALTER APPLICATION¶
Modifica as propriedades de um Snowflake Native App instalado. Use ALTER APPLICATION para atualizar um aplicativo para uma versão ou patch específico. Este comando também é usado para definir outras propriedades de um aplicativo.
- Consulte também:
CREATE APPLICATION, DESCRIBE APPLICATION, DROP APPLICATION, SHOW APPLICATIONS
Sintaxe¶
ALTER APPLICATION [ IF EXISTS ] <name> SET
[ COMMENT = '<string-literal>' ]
[ SHARE_EVENTS_WITH_PROVIDER = { TRUE | FALSE } ]
[ DEBUG_MODE = { TRUE | FALSE } ]
ALTER APPLICATION [ IF EXISTS ] <name> UNSET
[ COMMENT ]
[ SHARE_EVENTS_WITH_PROVIDER ]
[ DEBUG_MODE ]
ALTER APPLICATION [ IF EXISTS ] <name> RENAME TO <new_app_name>
ALTER APPLICATION <name> SET FEATURE POLICY <policy_name> [ FORCE ]
ALTER APPLICATION <name> UNSET FEATURE POLICY;
ALTER APPLICATION <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]
ALTER APPLICATION <name> UNSET TAG <tag_name> [ , <tag_name> ... ]
ALTER APPLICATION <name> SET SHARED TELEMETRY EVENTS ('<event_definition' [ , <event_definition>, ...])
ALTER APPLICATION <name> SET AUTHORIZE_TELEMETRY_EVENT_SHARING = { TRUE | FALSE }
ALTER APPLICATION <name> UNSET REFERENCES [ ( '<reference_name>' [ , '<reference_alias>' ] ) ]
ALTER APPLICATION <name> UPGRADE
ALTER APPLICATION <name> UPGRADE USING VERSION <version_name> [ PATCH <patch_num> ]
ALTER APPLICATION <name> UPGRADE USING <path_to_stage>
Parâmetros¶
name
Especifica o identificador do aplicativo que está sendo alterado. Se o identificador contiver espaços, caracteres especiais ou caracteres com letras maiúsculas e minúsculas, toda a cadeia de caracteres deve ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.
SET
Especifica uma (ou mais) propriedades a serem definidas para o aplicativo (separadas por espaços em branco, vírgulas ou novas linhas). Para obter mais detalhes sobre as propriedades que você pode definir, consulte CREATE APPLICATION.
COMMENT = '{string}'
Adiciona um comentário ou substitui um comentário existente para o aplicativo.
DEBUG_MODE = { TRUE | FALSE }
Ativa ou desativa o modo de depuração para o aplicativo instalado.
TRUE
ativa o modo de depuração para o aplicativo instalado.FALSE
desativa o modo de depuração do aplicativo instalado.
Você só pode definir
DEBUG_MODE
no aplicativo se as seguintes condições forem atendidas:O aplicativo instalado está na mesma conta que o pacote de aplicativos.
O aplicativo instalado deve ter sido criado no modo de desenvolvimento.
O modo de desenvolvimento é instalado com um estágio, versão ou patch explícito.
Você tem privilégios OWNERSHIP no aplicativo instalado e sua função recebeu o privilégio DEVELOP no pacote de aplicativos usado para criar o aplicativo instalado.
SHARE_EVENTS_WITH_PROVIDER = { TRUE | FALSE }
Especifica se os logs e dados de eventos devem ser compartilhados com o provedor.
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.
UNSET
Especifica uma (ou mais) propriedades e/ou parâmetros de sessão a serem desmarcados para o aplicativo, o que os redefine para os padrões.
Você pode redefinir várias propriedades/parâmetros com uma única instrução ALTER; no entanto, cada propriedade/parâmetro deve ser separado por uma vírgula. Ao redefinir uma propriedade/parâmetro, especifique somente o nome; especificar um valor para a propriedade/parâmetro retornará um erro.
COMMENT
DEBUG_MODE
Desativa o modo de depuração do aplicativo instalado. Esta cláusula é semanticamente o mesmo que definirDEBUG_MODE = FALSE
.TAG tag_name [ , tag_name ... ]
REFERENCES[ ( 'reference_name' [, 'reference_alias' ] ) ]
Desativa uma referência persistente para um aplicativo. Se nenhum argumento for passado, cancela todas as referências persistentes definidas para o aplicativo.
RENAME TO new_app_name
Especifica um novo identificador para o aplicativo. Esse identificador deve ser exclusivo para sua conta.
SET FEATURE POLICY policy_name [ FORCE ]
Especifica a política de recursos a ser aplicada ao aplicativo. Se uma política de recursos já estiver definida no aplicativo, você poderá usar o FORCE para definir a política de recursos sem precisar redefinir a política de recursos primeiro.
UNSET FEATURE POLICY
Remove a política de recursos do aplicativo. Quando uma política de recursos é removida de um aplicativo, a política de recursos no nível da conta, se existir, é aplicada.
SET SHARED TELEMETRY EVENTS ( 'event_definition' [ , event_definition, ... ] )
Especifica a definição de evento opcional a ser habilitada para um aplicativo.
SET AUTHORIZE_TELEMETRY_EVENT_SHARING = { TRUE | FALSE }
Ao definir como TRUE, habilita todas as definições de evento necessárias para um aplicativo. Entretanto, as definições de evento opcionais permanecem desabilitadas. Use a cláusula SET SHARED TELEMETRY EVENTS para definir as definições de evento opcionais para um aplicativo.
Cuidado
Após configurar esse valor como TRUE, você não poderá redefini-lo novamente como FALSE, se houver definições de evento necessárias no aplicativo.
UNSET REFERENCES[ ( 'reference_name' [ , 'reference_alias' ] ) ]
Remove as referências especificadas do aplicativo.
UPGRADE
Atualiza o aplicativo se o provedor tiver publicado uma nova versão ou patch para o aplicativo.
Um aplicativo é atualizado automaticamente quando o provedor define a diretriz de versão do aplicativo. No entanto, esse comando pode ser usado para iniciar a atualização imediatamente, sem esperar que a atualização automática ocorra. Esse comando só pode ser usado em aplicativos que não foram criados no modo de desenvolvimento. Os aplicativos em modo de desenvolvimento são instalados a partir de uma listagem ou sem especificar um estágio ou uma versão, e têm como objetivo principal testar o processo de atualização.
UPGRADE USING VERSION version_name [ PATCH patch_num ]
Atualiza o aplicativo para a versão especificada. Se
patch_num
não for especificado, o patch mais recente será usado. Esse comando só é válido para aplicativos que foram instalados especificando uma versão e um patch.UPGRADE USING path_to_stage
Atualiza o aplicativo usando arquivos em um estágio nomeado no caminho especificado por
path_to_stage
.Essa cláusula se aplica somente se você instalou o aplicativo a partir de um estágio nomeado.
Notas de uso¶
Se você não especificar valores para parâmetros opcionais, os valores desses parâmetros serão obtidos do arquivo
manifest.yml
. Se você especificar valores no manifesto e ao executar o comando, os valores especificados no comando terão precedência.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.