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>' ] ) ]

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 mais detalhes 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.

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.