ALTER APPLICATION PACKAGE … VERSION¶

Sintaxe¶

ALTER APPLICATION PACKAGE <name> ADD VERSION [ <version_identifier> ]
  USING <path_to_version_directory> [ LABEL = '<display_label>' ]

ALTER APPLICATION PACKAGE <name> DROP VERSION <version_identifier>

ALTER APPLICATION PACKAGE <name> ADD PATCH [<patch_number>] FOR VERSION [<version_identifier>]
  USING <path_to_version_directory> [ LABEL = '<display_label>' ]

Parâmetros¶

name

Especifica o identificador do pacote do aplicativo a ser 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.

ADD VERSION [ version_identifier ] USING path_to_version_directory

Adiciona uma versão ou patch usando os arquivos do aplicativo localizados no caminho para um local de estágio especificado por path_to_version_directory.

Você pode especificar um identificador para esta versão usando version_identifier. Se você não especificar um version_identifier no arquivo de manifesto, você deve especificar um version_identifier como parte deste comando. Se você especificar version_identifier como parte deste comando, ele tem precedência sobre version_identifier especificado no arquivo de manifesto.

[ LABEL = 'display_label' ]

Você pode usar a cláusula LABEL para especificar um rótulo para esta nova versão. Este rótulo é exibido ao consumidor. Se você omitir a cláusula LABEL, o rótulo especificado no arquivo manifest.yml será usado.

DROP VERSION version_identifier

Descarta a versão com o nome de versão especificado.

Descarta uma versão com o identificador de versão especificado. Uma versão só pode ser descartada quando não houver diretrizes de versão que se refiram a ela. A eliminação é um processo assíncrono e é concluída quando todas as instâncias do aplicativo tiverem sido atualizadas com êxito da versão anterior e não tiverem mais o código em execução na versão de eliminação.

Use a exibição Exibição APPLICATION_STATE para monitorar o estado das instâncias do aplicativo. Use o comando SHOW VERSIONS IN APPLICATION PACKAGE para monitorar o status da versão descartada.

ADD PATCH patch_number FOR VERSION version_identifier . USING path_to_version_directory [ LABEL = 'display_label' ]

Adiciona um patch para a versão especificada (version_identifier) usando os arquivos do aplicativo localizados no caminho especificado para um local de estágio (path_to_version_directory).

Você pode usar a cláusula LABEL para especificar um rótulo para este novo patch. Este rótulo é exibido ao consumidor. Se você omitir a cláusula LABEL, o rótulo especificado no arquivo manifest.yml será usado.

Notas de uso¶

• Os identificadores de versão têm um limite máximo de 30 caracteres.

• Uma única versão pode ter até 130 patches.

• Modificar a versão exige uma função o privilégio OWNERSHIP no aplicativo ou o privilégio global MANAGE VERSIONS.

• Se você não especificar os valores para as propriedades opcionais, o comando usará os valores especificados no arquivo de manifesto do aplicativo.

  Se você especificar valores para as propriedades no comando e no arquivo de manifesto do aplicativo, os valores especificados no comando terão precedência.

• Se duas versões estiverem ativas, por exemplo, se a versão atual não tiver sido concluída, adicionar uma nova versão resultará em erro.

Exemplos¶

ALTER APPLICATION PACKAGE hello_snowflake_package
  ADD VERSION v1_1
  USING '@hello_snowflake_code.core.hello_snowflake_stage';

+---------------------------------------------------------------------------------------+---------+-------+
| status                                                                                | version | patch |
|---------------------------------------------------------------------------------------+---------+-------|
| Version 'v1_1' of application package 'hello_snowflake_package' created successfully. | v1_1    |     0 |
+---------------------------------------------------------------------------------------+---------+-------+