Instalação e teste um aplicativo localmente¶

Use o privilégio DEVELOP¶

Por padrão, a função usada para criar um pacote de aplicativos tem permissões para usar o comando CREATE APPLICATION para criar um aplicativo com base no pacote de aplicativos.

No entanto, em alguns ambientes de desenvolvimento, pode ser necessário permitir que usuários com outras funções criem e testem um pacote de aplicativo. Para isso, conceda o privilégio DEVELOP de nível de objeto no pacote de aplicativo para uma função.

O privilégio DEVELOP concede os privilégios necessários para criar e testar um aplicativo com base em um pacote de aplicativos. Esse privilégio permite que um usuário execute as seguintes tarefas usando o pacote de aplicativos ao qual foi concedido acesso:

• Criar um aplicativo com base em uma versão ou patch especificado no pacote de aplicativos.

• Fazer upgrade para uma versão diferente de um aplicativo usando o comando ALTER APPLICATION.

• Criar ou atualizar um aplicativo usando arquivos em um estágio nomeado.

• Habilitar o modo de depuração em um aplicativo criado no modo de desenvolvimento.

Para conceder o privilégio DEVELOP a uma função, use o comando GRANT <privilégios> … TO ROLE, conforme mostrado no exemplo a seguir:

GRANT DEVELOP ON APPLICATION PACKAGE hello_snowflake_package TO ROLE other_dev_role;

Criar um aplicativo usando arquivos preparados¶

Você pode criar um aplicativo usando um arquivo de manifesto e um script de configuração carregado em um estágio nomeado. Isso permite que você teste as alterações nesses arquivos sem precisar adicionar uma nova versão a um pacote de aplicativos.

Use o comando CREATE APPLICATION para criar um aplicativo usando arquivos preparados, conforme mostrado no exemplo a seguir:

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

Criar um aplicativo a partir de uma versão ou patch¶

Depois de definir uma versão ou patch em um pacote de aplicativos, você pode criar um aplicativo com base nessa versão ou patch.

Para criar um aplicativo a partir de uma versão específica, use o comando CREATE APPLICATION, conforme mostrado no exemplo a seguir:

CREATE APPLICATION hello_snowflake_app
  FROM APPLICATION PACKAGE hello_snowflake_package
  USING VERSION v1_0;

Para criar um aplicativo a partir de um patch específico, use o comando CREATE APPLICATION, conforme mostrado no exemplo a seguir:

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

Criar um aplicativo com base em uma diretiva de lançamento¶

Depois de especificar uma diretiva de lançamento (personalizada ou padrão) em um pacote de aplicativos, você pode criar um aplicativo com base nessa diretiva de lançamento.

Para criar um aplicativo com base em uma diretiva de lançamento, use o comando CREATE APPLICATION, conforme mostrado no exemplo a seguir:

CREATE APPLICATION hello_snowflake_app FROM APPLICATION PACKAGE hello_snowflake_package;

Fazer upgrade de um aplicativo usando um estágio¶

Para fazer upgrade de um aplicativo usando arquivos em um estágio nomeado, use o comando ALTER APPLICATION, conforme mostrado no exemplo a seguir:

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

Atualizar um aplicativo a partir de uma versão ou patch¶

Para atualizar um aplicativo que foi criado usando uma versão ou um patch específico, use o comando ALTER APPLICATION, conforme mostrado no exemplo a seguir:

ALTER APPLICATION HelloSnowflake
 UPGRADE USING VERSION "v1_1";

Sobre o modo de desenvolvimento¶

Quando você cria um aplicativo localmente a partir de um pacote de aplicativos, especificando uma versão ou arquivos de aplicativos em um estágio nomeado, considera-se que aplicativo está no modo de desenvolvimento.

Use o modo de desenvolvimento para testar e solucionar problemas de um aplicativo em uma única conta. No modo de desenvolvimento, você pode criar e testar um aplicativo com base em uma versão específica de um pacote de aplicativos. Você também pode criar e testar um aplicativo usando arquivos de aplicativos 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 oferece um modo de depuração adicional que você pode usar para visualizar e testar todos os objetos de um aplicativo que um consumidor não conseguiria visualizar.

No modo de desenvolvimento, por exemplo, a execução dos comandos SHOW ou DESC em objetos no aplicativo exibirá apenas os objetos para os quais o consumidor recebeu permissões de visualização. Entretanto, no modo DEBUG, você pode ver todos os objetos no aplicativo.

Sobre o modo de depuração¶

No modo de depuração, você pode visualizar e modificar todos os objetos de um aplicativo. 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.

O teste de um aplicativo no modo de depuração requer o seguinte:

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

• Você deve ativar explicitamente o modo de depuração no aplicativo.

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

ALTER APPLICATION hello_snowflake_app SET DEBUG_MODE = TRUE;

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

ALTER APPLICATION hello_snowflake_app SET DEBUG_MODE = FALSE;

Esse comando desativa o modo de depuração do aplicativo chamado hello_snowflake_app.

Privilégios necessários para usar o modo de depuração de sessão¶

O uso do modo de depuração de sessão para visualizar objetos em um aplicativo tem os seguintes requisitos:

• O aplicativo deve ser criado no modo de desenvolvimento, que exige que o aplicativo seja criado com base em uma versão específica ou com base em arquivos localizados em um estágio.

• O aplicativo deve estar na mesma conta que o pacote de aplicativos no qual o aplicativo se baseia.

• Você deve ter o privilégio OWNERSHIP no aplicativo.

• Você deve ter o privilégio DEVELOP no pacote de aplicativos.

Ativar o modo de depuração de sessão para um aplicativo¶

Para ativar o modo de depuração de sessão em um aplicativo na sessão atual, use a função de sistema SYSTEM$BEGIN_DEBUG_APPLICATION, conforme mostrado no exemplo a seguir:

SELECT SYSTEM$BEGIN_DEBUG_APPLICATION(‘hello_snowflake_app’);

Essa função ativa o modo de depuração de sessão para o aplicativo chamado hello_snowflake_app.

Você também pode ativar a depuração de sessão especificando o modo de execução do aplicativo, conforme mostrado no exemplo a seguir:

SYSTEM$BEGIN_DEBUG_APPLICATION( 'hello_snowflake_app', execution_mode ='AS_APPLICATION')

Essa função define o modo de execução do aplicativo hello_snowflake_app como AS_APPLICATION. Esse modo executa todas as instruções usando os mesmos privilégios que o aplicativo tem quando criado na conta do consumidor.

Exibir o status de depuração de sessão para um aplicativo na sessão atual¶

Para visualizar o status de depuração de sessão na sessão atual, use a função de sistema SYSTEM$GET_DEBUG_STATUS, conforme mostrado no exemplo a seguir:

SELECT SYSTEM$GET_DEBUG_STATUS();

Desativar o modo de depuração de sessão para um aplicativo¶

Para desativar o modo de depuração de sessão para um aplicativo na sessão atual, use a função de sistema SYSTEM$END_DEBUG_APPLICATION, conforme mostrado no exemplo a seguir:

SELECT SYSTEM$END_DEBUG_APPLICATION();

Privilégios necessários para desativar a remoção de dados do provedor ao testar um aplicativo¶

A desativação da remoção de dados do provedor para um aplicativo requer os seguintes privilégios:

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

• O aplicativo deve ser criado na mesma conta que contém o pacote de aplicativos.

• Você deve ter o privilégio OWNERSHIP no aplicativo.

• Você deve ter o privilégio DEVELOP no pacote de aplicativos.

Desativar a remoção de informações dos dados do provedor¶

Para desativar as informações de um aplicativo, use o comando ALTER APPLICATION, conforme mostrado no exemplo a seguir:

ALTER APPLICATION hello_snowflake_app SET DISABLE_APPLICATION_REDACTION = TRUE;

Esse comando desativa a remoção de dados do provedor para um aplicativo chamado hello_snowflake_app.

Para ativar a remoção dos dados do provedor, use o mesmo comando mostrado no exemplo a seguir:

ALTER APPLICATION hello_snowflake_app SET DISABLE_APPLICATION_REDACTION = FALSE;

Diferenças no modo de desenvolvimento¶

No modo de desenvolvimento, os aplicativos são criados com base em uma das seguintes opções:

• Arquivos carregados em um estágio.

• Versões ou patches definidos no pacote do aplicativo.

Ao testar o compartilhamento de eventos localmente no modo de desenvolvimento, há diferenças no comportamento dos aplicativos criados a partir de uma listagem.

• O privilégio global MANAGE EVENT SHARING não é necessário para ativar o compartilhamento de eventos.

• Os eventos compartilhados são coletados em tabelas de eventos locais. Na tabela de eventos locais, os provedores podem ver duas entradas para um evento:

  • O evento que o aplicativo emite no lado do consumidor quando o aplicativo é instalado.

  • O evento que é compartilhado com o provedor.

Teste do compartilhamento de eventos no modo de desenvolvimento¶

1. Configure o aplicativo para usar o registro e o rastreamento de eventos.

2. Configure uma tabela de eventos na conta de desenvolvimento local.

3. Crie o aplicativo localmente executando um dos seguintes comandos:

   CREATE APPLICATION hello_snowflake_app
     FROM APPLICATION PACKAGE hello_snowflake_package
     USING @path_to_staged_files
     AUTHORIZE_TELEMETRY_EVENT_SHARING = TRUE;
   
   CREATE APPLICATION hello_snowflake_app
     FROM APPLICATION PACKAGE hello_snowflake_package
     USING VERSION v1_0
     PATCH 0
     AUTHORIZE_TELEMETRY_EVENT_SHARING = TRUE;
   

   Copy

4. Visualize as mensagens de log e rastreie os eventos na tabela de evento.