Atualização de um Snowflake Native App¶

Diferenças entre versões e patches¶

Quando um provedor publica uma nova versão de um aplicativo, o Snowflake Native App Framework garante que apenas a versão anterior do aplicativo esteja ativa. Por exemplo, se um provedor publicou V1 e V2 de um aplicativo, o Snowflake Native App Framework garante que apenas V2 esteja atualmente instalado em uma conta de consumidor antes de atualizar para V3. Isso garante que o script de configuração tenha apenas em conta as diferenças entre V2 e V3. Em outras palavras, o script de configuração é compatível apenas com a versão mais recente do aplicativo. Se um provedor fizer uma alteração de estado no aplicativo, por exemplo, criando uma nova tabela ou adicionando colunas a uma tabela, não haverá problemas de compatibilidade entre versões.

Por outro lado, quando um provedor publica um novo patch para uma versão de um aplicativo, o Snowflake Native App Framework não impõe nenhuma restrição ao número de patches ativos em execução. Os provedores devem evitar fazer alterações no estado de um aplicativo em um patch.

Sobre upgrades entre regiões¶

Consulte Upgrade de um aplicativo instalado em várias regiões para obter informações sobre como fazer o upgrade de um aplicativo instalado entre regiões.

Privilégios necessários para adicionar ou remover versões e patches¶

Para especificar uma versão ou patch para um pacote de aplicativo, você deve ter um dos seguintes privilégios concedidos no pacote de aplicativo para sua função:

• OWNERSHIP

• MANAGE VERSIONS

Por exemplo, para conceder o privilégio MANAGE VERSION no pacote de aplicativo à função release_mgr, use o comando GRANT <privilégios> conforme mostrado no exemplo a seguir:

GRANT MANAGE VERSIONS ON APPLICATION PACKAGE hello_snowflake_package
  TO ROLE release_mgr;

Adição de uma versão a um pacote de aplicativo usando SQL¶

O exemplo a seguir mostra como usar o comando ALTER APPLICATION PACKAGE para adicionar uma versão a um pacote de aplicativo.

ALTER APPLICATION PACKAGE MyAppPackage
  ADD VERSION v1_0
  USING '@dev_stage/v1_0'
  LABEL = 'MyApp Version 1.0';

Neste exemplo, v1_0 é um identificador para a versão que não fica visível para os consumidores quando eles instalam o aplicativo. O consumidor vê as informações da versão conforme definido na cláusula LABEL.

Apenas duas versões de um aplicativo podem existir ao mesmo tempo. Por exemplo, se você definir v1_0 e v1_1 em um aplicativo, deverá descartar v1_0 para criar v1_2. No entanto, você pode ter vários patches para uma única versão.

Você pode definir o nome da versão e o rótulo no arquivo manifest.yml, ou especifique-os diretamente com o comando ALTER APPLICATION PACKAGE. Se você os definir no arquivo manifest.yml, bem como com o comando SQL, os valores especificados no comando SQL tem precedência sobre os valores especificados no arquivo manifest.yml.

Adição de um patch a um pacote de aplicativo usando SQL¶

Além de criar versões para um aplicativo, você também pode criar patches para uma versão específica. Assim como as versões, os patches de aplicativo também têm seus próprios arquivos de aplicativo.

Para criar um novo patch para um pacote de aplicativo, use a cláusula ADD PATCH FOR VERSION do comando ALTER APPLICATION PACKAGE … VERSION, conforme o exemplo a seguir:

ALTER APPLICATION PACKAGE MyAppPackage
 ADD PATCH FOR VERSION V1_0
 USING '@dev_stage/v1_0_p1;

No exemplo, nenhum número de patch é fornecido para a cláusula ADD PATCH FOR VERSION V1_0. Neste caso, o Snowflake incrementa automaticamente o número do patch em 1.

Para criar um novo patch para um aplicativo com número de patch personalizado, forneça o número de patch na cláusula ADD PATCH FOR VERSION do comando ALTER APPLICATION PACKAGE … VERSION, conforme mostrado no exemplo a seguir:

ALTER APPLICATION PACKAGE MyAppPackage
 ADD PATCH 3
 FOR VERSION V1_0
 USING '@dev_stage/v1_0_p1;

Exibição das versões e patches para um pacote de aplicativo¶

Como provedor, você pode visualizar as versões e patches definidos para um aplicativo executando o comando SHOW VERSIONS no pacote de aplicativo.

O comando a seguir exibe as versões e patches que foram definidos para um pacote de aplicativo chamado hello_snowflake_package:

SHOW VERSIONS IN APPLICATION PACKAGE hello_snowflake_package;

Remoção de uma versão de um pacote de aplicativo¶

Para remover uma versão de um pacote de aplicativo, você deve verificar se não há diretrizes de versão apontando atualmente para a versão que você deseja remover.

Para visualizar as diretrizes de versão especificadas em um pacote de aplicativo, execute o comando SHOW RELEASE DIRECTIVES conforme mostrado no exemplo a seguir:

SHOW RELEASE DIRECTIVES IN APPLICATION PACKAGE hello_snowflake_package;

Para remover uma versão de um pacote de aplicativo, use a cláusula DROP VERSION do comando ALTER APPLICATION PACKAGE como mostrado no exemplo a seguir:

ALTER APPLICATION PACKAGE hello_snowflake_package
  DROP VERSION v1_0;

Depois de executar este comando, a versão não será descartada até que todas as instâncias instaladas do aplicativo sejam descartadas. Para verificar o status do comando drop, use SHOW VERSIONS conforme mostrado no exemplo a seguir:

SHOW VERSIONS IN APPLICATION PACKAGE hello_snowflake_package;

A coluna dropped_on lista o carimbo de data/hora em que o descarte foi iniciado.

Quando uma versão é descartada, os consumidores não podem mais instalar novas instâncias dessa versão do aplicativo.

Dependendo de como o aplicativo é publicado para os consumidores, pode levar diferentes períodos para que a versão seja descartada:

• Se o pacote de aplicativo não tiver sido publicado para os consumidores, a versão será descartada imediatamente.

• Se o pacote de aplicativo tiver sido publicado como uma listagem pública ou privada em uma única região, a versão será descartada imediatamente.

• Se o pacote de aplicativo for publicado como produto de dados de uma listagem compartilhada na mesma região que o pacote de aplicativo, a versão será descartada em algumas horas.

• Se o pacote de aplicativo for publicado como produto de dados de uma listagem usando o preenchimento automático entre nuvens, poderá levar mais tempo para que a versão seja descartada em todas as regiões.

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 para um pacote de aplicativo¶

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.

Definição de uma diretriz de versão personalizada para um pacote de aplicativo¶

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:

1. Remova a diretriz de versão do pacote de aplicativo executando o comando ALTER APPLICATION PACKAGE com UNSET RELEASE DIRECTIVE.

2. 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.

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;

Teste de uma versão e patch usando 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.

Fluxo de trabalho para fazer o upgrade de um Snowflake Native App¶

Um provedor faz o upgrade de um aplicativo instalado usando o seguinte fluxo de trabalho:

1. Atualize lógica do aplicativo e o script de configuração do pacote de aplicativo.

2. Se houver duas versões definidas atualmente, remova uma versão do pacote de aplicativo.

3. Crie uma nova versão ou patch para as alterações no pacote de aplicativo.

   Se a propriedade DISTRIBUTION do aplicativo estiver definida como EXTERNAL, a verificação de segurança automatizada será iniciada. A verificação de segurança deve passar antes que o upgrade possa ocorrer.

4. Teste a nova versão criando um objeto APPLICATION na conta de teste do provedor.

5. Atualize a diretriz de versão da versão ou patch.

   Isso inicia um upgrade automatizado que atualizará todas as instâncias instaladas da versão anterior. Um provedor pode notificar o consumidor de que um upgrade está disponível e solicitar que ele execute manualmente um upgrade manual.

Upgrade de um aplicativo instalado em várias regiões¶

Se um provedor publicar um Snowflake Native App usando o preenchimento automático entre nuvens, os upgrades automatizados poderão demorar um pouco para serem atualizados, dependendo dos seguintes fatores:

• O valor do agendamento de atualização.

• O número de instâncias instaladas do aplicativo.

• O número de regiões onde o aplicativo está implantado.

Se o upgrade contiver uma correção urgente que precise ser atualizada em uma região remota, os provedores poderão considerar as seguintes maneiras de realizar um upgrade mais rapidamente:

• Reduza a frequência de atualização da listagem para um valor menor.

  Nota

  A redução da frequência de atualização pode aumentar os custos associados à replicação. Consulte Configuração do preenchimento automático entre nuvens para obter mais informações.

• Peça ao consumidor para realizar um upgrade manual.

Execução de um upgrade manual para um aplicativo instalado¶

Os upgrades manuais permitem que um consumidor inicie o upgrade de uma versão instalada ou patch de um aplicativo usando a diretriz de versão especificada no pacote de aplicativo.

Para fazer o upgrade de um Snowflake Native App instalado para a versão mais recente disponível, um consumidor pode usar a cláusula UPGRADE do comando ALTER APPLICATION para modificar o objeto do aplicativo:

ALTER APPLICATION <name> UPGRADE

Exibição do status de um upgrade¶

Para exibir o estado do upgrade de um aplicativo, use a exibição do sistema Exibição APPLICATION_STATE conforme mostrado no exemplo a seguir:

SELECT * FROM snowflake.data_sharing_usage.APPLICATION_STATE

Essa exibição inclui colunas específicas para upgrades, incluindo o estado do upgrade e a região onde o aplicativo está implantado.