ALTER APPLICATION¶
Modifica as propriedades de um aplicativo instalado no Native Apps Framework. Use ALTER APPLICATION para atualizar um aplicativo instalado para uma versão ou patch específico. Este comando também é usado para habilitar ou desabilitar o modo de depuração para 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 <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 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, 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.