ALTER APPLICATION¶

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 <name> UPGRADE

 ALTER APPLICATION <name> UPGRADE USING VERSION <version_name> [ PATCH <patch_num> ]

 ALTER APPLICATION <name> UPGRADE USING <path_to_stage>

 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> UNSET REFERENCES[ ( '<reference_name>' [ , '<reference_alias>' ] ) ]

 ALTER APPLICATION <name> SET SHARED TELEMETRY EVENTS ('<event_definition' [ , <event_definition>, ...])

 ALTER APPLICATION <name> SET AUTHORIZE_TELEMETRY_EVENT_SHARING = { TRUE | FALSE }

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.

:code:`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 para o aplicativo instalado.

Você só pode definir DEBUG_MODE no aplicativo se forem cumpridas as seguintes condições:

• O aplicativo instalado está na mesma conta que o pacote de aplicativo.

• 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 aplicativo 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 Cotas de tags para objetos e colunas.

UPGRADE

Executa uma atualização de aplicativo se o provedor de aplicativos indicou que a instância deve ser atualizada.

Um aplicativo será atualizado automaticamente quando o provedor indicar que deve fazê-lo; no entanto, esse comando pode ser usado para fazer com que a atualização ocorra imediatamente, sem esperar que a atualização automática ocorra. Este comando só pode ser usado em aplicativos de modo não-desenvolvimento, que são instalados a partir de uma listagem ou sem especificar um estágio ou versão, e destina-se principalmente a oferecer suporte ao teste do processo de atualização do aplicativo.

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. Este comando é válido apenas para aplicativos que foram instalados especificando uma versão e um patch.

UPGRADE USING <path_to_version_directory>

Atualiza o aplicativo usando arquivos em um estágio nomeado no caminho especificado por path_to_stage.

Esta cláusula se aplica somente se você instalou o aplicativo de um estágio nomeado.

UNSET

Especifica uma (ou mais) propriedades e/ou parâmetros de sessão a serem removidos para o aplicativo, o que os restabelece 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 para o 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, desativa todas as referências persistentes definidas para o aplicativo.

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.

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.