Configuração da diretriz de lançamento para um aplicativo¶
Este tópico descreve como definir a diretriz de versão de um pacote do aplicativo.
Sobre as diretrizes de versão¶
As diretrizes de versão determinam a versão do aplicativo que está disponível para um consumidor quando ele instala ou atualiza um aplicativo. As diretrizes de versão são definidas no pacote do aplicativo usando o comando ALTER APPLICATION PACKAGE.
Há dois tipos de diretrizes de versão:
- Diretriz de versão personalizada
Permite que um provedor especifique a versão de um aplicativo que as contas específicas Snowflake podem instalar. Consulte Adição de uma diretriz de versão personalizada para obter mais informações.
- Diretriz de versão padrão
Especifica a versão e o patch aplicáveis a todos os consumidores ao instalar um Snowflake Native App. Se um provedor criar versões V1 e V2 de um aplicativo, definir a diretriz de versão padrão como V2 garante que, quando um consumidor instalar o Snowflake Native App, ele será instalado.
Consulte definição de uma diretriz de versão padrão para obter mais informações.
Se um provedor criar as versões V2 e V3 de um aplicativo, ele poderá atribuir a V2 como a versão padrão e criar uma diretriz de versão personalizada para compartilhar a V3 somente com contas específicas. Um provedor também pode compartilhar a versão V3 do aplicativo com uma conta de teste antes de publicar essa versão.
Nota
Se você especificar uma diretriz de versão padrão e personalizada, a diretriz de versão personalizada sempre terá precedência. No exemplo acima, as contas de consumidor especificadas na diretriz de versão personalizada só poderiam instalar a V3 do aplicativo.
Você deve definir uma diretriz de versão em um pacote de aplicativo antes de poder executar as seguintes tarefas:
Crie uma listagem pública com o pacote de aplicativo como conteúdo de dados.
Instale um Snowflake Native App em uma conta de consumidor.
Privilégios necessários para definir a diretriz de versão¶
Para definir uma diretriz de versão, um provedor deve ter o privilégio MANAGE RELEASES ou propriedade do pacote de aplicativo.
GRANT MANAGE RELEASES ON APPLICATION PACKAGE hello_snowflake_package
TO ROLE release_mgr;
Definição da diretriz de versão padrão¶
Use o comando ALTER APPLICATION PACKAGE com SET DEFAULT RELEASE DIRECTIVE para definir a diretriz de versão padrão, conforme mostrado no exemplo a seguir:
ALTER APPLICATION PACKAGE hello_snowflake_package
SET DEFAULT RELEASE DIRECTIVE
VERSION = v1_0
PATCH = 2;
Para atualizar a diretriz de versão padrão para um pacote de aplicativo, execute o comando ALTER APPLICATION PACKAGE com SET DEFAULT RELEASE DIRECTIVE novamente, especificando novos valores para VERSION ou PATCH, conforme apropriado.
Como definir e atualizar uma diretriz de liberação personalizada¶
Como definir uma diretriz de versão personalizada¶
Para adicionar uma diretriz de versão personalizada, use o comando ALTER APPLICATION PACKAGE com SET RELEASE DIRECTIVE. Use a cláusula ACCOUNTS para especificar as contas às quais esta diretriz de versão se aplica. Por exemplo:
ALTER APPLICATION PACKAGE hello_snowflake_package
SET RELEASE DIRECTIVE hello_snowflake_package_custom
ACCOUNTS = (CONSUMER_ORG.CONSUMER_ACCOUNT)
VERSION = v1_0
PATCH = 0;
Atualização de uma diretriz de versão personalizada¶
Para atualizar a versão ou patch para uma diretriz de versão personalizada, use o comando ALTER APPLICATION PACKAGE com MODIFY RELEASE DIRECTIVE como mostrado no exemplo a seguir:
ALTER APPLICATION PACKAGE hello_snowflake_package
MODIFY RELEASE DIRECTIVE hello_snowflake_package_custom
VERSION = v1_0
PATCH = 0;
No entanto, você não pode modificar as contas associadas à diretriz de versão. Para alterar a organização e a conta associadas a uma diretriz de versão, faça o seguinte:
Remova a diretriz de versão do pacote de aplicativo executando o comando ALTER APPLICATION PACKAGE com UNSET RELEASE DIRECTIVE.
Adicione a diretriz de versão de volta ao pacote de aplicativo executando o comando ALTER APPLICATION PACKAGE com SET RELEASE DIRECTIVE e usando a cláusula ACCOUNTS para especificar a lista de contas.
Nota
Ao alterar a organização e a conta associadas à diretriz de versão, adicione a nova diretriz de versão imediatamente após remover a antiga. Caso contrário, os aplicativos instalados para as contas atribuídas à diretriz de versão personalizada serão revertidos para a diretriz de versão padrão.
Remoção de uma diretriz de versão personalizada¶
Para remover uma diretriz de versão personalizada de um pacote de aplicativo, use o comando ALTER APPLICATION PACKAGE com UNSET RELEASE DIRECTIVE como mostrado no exemplo a seguir:
ALTER APPLICATION PACKAGE hello_snowflake_package
UNSET RELEASE DIRECTIVE hello_snowflake_package_custom;
Como testar um aplicativo com base em uma diretriz de versão¶
Ao instalar um aplicativo de um pacote de aplicativo no modo de desenvolvimento, a versão e o patch são explicitamente especificados. No entanto, quando o aplicativo é instalado usando o seguinte comando:
CREATE APPLICATION hello_snowflake
FROM APPLICATION PACKAGE hello_snowflake_package
A diretriz de versão determina a versão instalada ao executar este comando.
Como ver as diretrizes de versão de um pacote do aplicativo¶
Para visualizar as diretrizes de versão usando SQL, execute o comando SHOW RELEASE DIRECTIVES conforme mostrado no exemplo a seguir:
SHOW RELEASE DIRECTIVES IN APPLICATION PACKAGE hello_snowflake_package;