Criação de um objeto de aplicativo¶

Sobre como criar e testar objetos de aplicativo¶

O Snowflake Native App Framework permite que o provedor crie um objeto APPLICATION na mesma conta do pacote do aplicativo. Isso permite que os provedores testem um Snowflake Native App antes de publicá-lo aos consumidores. Ele também permite que os provedores testem o Snowflake Native App em uma única conta sem precisar alternar entre contas de provedor e de consumidor.

Privilégios necessários para criar e testar um objeto APPLICATION¶

Para criar um objeto APPLICATION a partir de um pacote de aplicativo, você deve ter os seguintes privilégios concedidos à sua função:

• O privilégio de nível de conta CREATE APPLICATION concedido à sua função.

• O privilégio de nível de objeto INSTALL concedido no pacote de aplicativo.

Os exemplos a seguir mostram como usar o comando GRANT <privilégios> para conceder esses privilégios à sua conta:

GRANT CREATE APPLICATION ON ACCOUNT TO ROLE provider_role;
GRANT INSTALL ON APPLICATION PACKAGE hello_snowflake_package
  TO ROLE provider_role;

GRANT DEVELOP ON APPLICATION PACKAGE hello_snowflake_package TO ROLE other_dev_role;

Fluxo de trabalho para criar e testar um aplicativo¶

O Snowflake Native App Framework fornece diferentes maneiras de criar um objeto APPLICATION a partir de um pacote de aplicativo. Isso permite testar um Snowflake Native App antes de publicá-lo aos consumidores. O método usado depende de quais partes do objeto APPLICATION você deseja testar.

As etapas a seguir descrevem um fluxo de trabalho típico para testar um objeto APPLICATION:

1. Crie um objeto APPLICATION usando o conteúdo em um estágio.

   Isso permite testar rapidamente uma nova versão de um script de configuração ou arquivo de código de aplicativo. Para obter mais informações, consulte Criação de um aplicativo usando arquivos preparados.

2. Crie um objeto APPLICATION de uma versão ou patch.

   Depois de definir uma versão ou patch para um pacote de aplicativo, você pode testar essa versão criando um objeto APPLICATION usando essa versão. Consulte Criação de um objeto de aplicativo de uma versão ou nível de patch.

3. Atualize um objeto APPLICATION.

   Depois de verificar se uma versão de um pacote de aplicativo está funcionando corretamente, você poderá atualizar um objeto APPLICATION existente para a nova versão. Você pode atualizar de duas maneiras:

   • Atualização de um aplicativo usando um estágio (conta única)

   • Atualização de um aplicativo de uma versão (conta única)

4. Crie um objeto APPLICATION diretamente de um pacote de aplicativo.

   Depois de verificar se o objeto APPLICATION funciona corretamente, você pode criar um objeto APPLICATION a partir de um pacote de aplicativo sem especificar uma versão ou arquivos de estágio. Isso cria o objeto APPLICATION usando a diretriz de versão padrão.

   Para obter mais informações, consulte Criação de um aplicativo usando arquivos preparados.

5. Instale um Snowflake Native App a partir de uma listagem.

   Depois de verificar em sua conta se o pacote de aplicativo e o objeto APPLICATION estão funcionando corretamente, você poderá adicionar o pacote de aplicativo a uma listagem e testar a instalação usando a Snowsight.

   Para obter mais informações, consulte Criação de um aplicativo usando arquivos preparados.

Criação de um objeto de aplicativo¶

O Snowflake Native App Framework permite que você instale um objeto APPLICATION diretamente na sua conta para testar um Snowflake Native App antes de ser compartilhado com os clientes. O comando CREATE APPLICATION oferece suporte à sintaxe diferente para criar um objeto APPLICATION.

CREATE APPLICATION hello_snowflake_app FROM APPLICATION PACKAGE hello_snowflake_package
  USING '@hello_snowflake_code.core.hello_snowflake_stage';

CREATE APPLICATION hello_snowflake_app FROM APPLICATION PACKAGE hello_snowflake_package
  USING VERSION v1_0;

CREATE APPLICATION hello_snowflake_app FROM APPLICATION PACKAGE hello_snowflake_package
  USING VERSION v1_0 PATCH 2;

CREATE APPLICATION hello_snowflake_app FROM APPLICATION PACKAGE hello_snowflake_package;

ALTER APPLICATION HelloSnowflake
  UPGRADE USING @CODEDATABASE.CODESCHEMA.AppCodeStage;

ALTER APPLICATION HelloSnowflake
 UPGRADE USING VERSION "v1_1";

Exiba os objetos de aplicativo¶

Para ver uma lista de objetos APPLICATION disponíveis para sua conta, use o comando SHOW APPLICATIONS conforme mostrado no exemplo a seguir:

SHOW APPLICATIONS

Sobre o modo de desenvolvimento¶

Quando você cria um objeto APPLICATION a partir de um pacote de aplicativo especificando uma versão ou arquivos de aplicativo em um estágio nomeado, o objeto APPLICATION é considerado como estando no modo de desenvolvimento.

O modo de desenvolvimento permite testar e solucionar problemas de um objeto APPLICATION em uma única conta. No modo de desenvolvimento você pode criar e testar um objeto APPLICATION com base em uma versão específica de um pacote de aplicativo. Você também pode criar e testar um objeto APPLICATION usando arquivos de aplicativo em um estágio. Isso permite que você teste rapidamente as alterações no script de configuração ou na lógica do aplicativo.

O modo de desenvolvimento fornece um modo de depuração adicional que permite verificar o estado interno de um objeto APPLICATION que, de outra forma, um consumidor não conseguiria visualizar.

No modo de desenvolvimento, por exemplo, ao executar os comando SHOW ou DESC em objetos dentro do objeto APPLICATION, apenas os objetos aos quais o consumidor recebeu permissão para visualizar serão exibidos. No entanto, no modo DEBUG, você pode ver todos os objetos dentro do objeto APPLICATION.

Ativação do modo de depuração¶

O Snowflake Native App Framework permite que você teste um objeto APPLICATION no modo de depuração. O modo de depuração permite visualizar e modificar todos os objetos dentro do objeto APPLICATION. Objetos que não são visíveis para um consumidor, por exemplo, objetos não concedidos a uma função de banco de dados ou objetos de conteúdo compartilhado, ficam visíveis nesse modo.

Usar um objeto APPLICATION no modo de depuração requer o seguinte:

• O objeto APPLICATION deve ser criado no modo de desenvolvimento, o que significa que deve ser baseado em uma versão ou arquivos específicos em um estágio.

• Você deve definir explicitamente o modo de depuração no objeto APPLICATION.

Para ativar o modo de depuração em um objeto APPLICATION, use o comando ALTER APPLICATION conforme mostrado no exemplo a seguir:

ALTER APPLICATION hello_snowflake_app SET DEBUG_MODE = TRUE;

Este comando ativa o modo de depuração para um objeto APPLICATION chamado hello_snowflake_app. Da mesma forma, para desativar o modo de depuração, use o mesmo comando mostrado no exemplo a seguir:

ALTER APPLICATION hello_snowflake_app SET DEBUG_MODE = FALSE;

Este comando desativa o modo de depuração para o objeto APPLICATION denominado hello_snowflake_app.

Definição de um objeto de aplicativo como contexto ativo¶

Para definir um objeto APPLICATION como o contexto ativo e atual de uma sessão, execute o comando USE APPLICATION conforme mostrado no exemplo a seguir:

USE APPlICATION hello_snowflake_app;

Exibição de detalhes de um objeto de aplicativo¶

Para visualizar detalhes de um objeto de aplicativo, execute o comando DESCRIBE APPLICATION conforme mostrado no exemplo a seguir:

DESC APPLICATION hello_snowflake_app;

No modo de desenvolvimento, esse comando exibe apenas os esquemas que são expostos ao consumidor por meio de funções de banco de dados de aplicativo.

No modo de depuração, esse comando exibe todos os esquemas na instância e no pacote de aplicativo.