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

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 definir DEBUG_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.