Operações remotas para Snowflake Native Apps já estão disponíveis

Para que serve

Imagine que você desenvolve um Snowflake Native App e precisa realizar manutenções ou rodar comandos de suporte no ambiente de um cliente sem precisar de acesso direto à conta dele. Agora, os provedores podem executar operações diretamente nos aplicativos instalados usando uma função do sistema.

• Executar comandos SQL remotos no aplicativo do cliente.
• Habilitar ou desabilitar o aplicativo com uma justificativa.
• Tentar novamente um upgrade que falhou anteriormente.

Como usar

A função SYSTEM$REMOTE_APP_OPERATION permite que o provedor dispare ações informando o tipo de operação, o pacote e o hash do aplicativo.

SELECT SYSTEM$REMOTE_APP_OPERATION(
  'run_sql',
  'meu_pacote',
  'meu_hash_do_aplicativo',
  '{"sql": "SELECT * FROM meu_esquema.minha_tabela"}'
);

O que acontece nesse código:

1. A função recebe o tipo de operação desejada, que neste caso é 'run_sql'.
2. Informa o nome do pacote e o hash único do aplicativo instalado.
3. Passa uma string JSON com o comando SQL que será executado no ambiente do cliente.
4. Retorna um identificador de requisição para rastreio.

Para desativar um aplicativo informando o motivo, utilize:

SELECT SYSTEM$REMOTE_APP_OPERATION(
  'disable',
  'meu_pacote',
  'meu_hash_do_aplicativo',
  '{"reason": "Manutencao programada"}'
);

O que acontece nesse código:

1. Define o tipo de operação como 'disable'.
2. Identifica o aplicativo pelo pacote e hash.
3. Envia no JSON o motivo da desativação exigido para essa operação.

O que retorna

Campo	Descrição
request_id	Identificador único UUID em formato JSON para rastrear o resultado na tabela de eventos.

Limitações e requisitos

• O recurso está em General Availability (GA).
• Disponível apenas para provedores.
• Operações restritas como 'run_sql' exigem consentimento prévio do consumidor configurado via CREATE APPLICATION ou ALTER APPLICATION.
• O status do consentimento pode ser validado na view APPLICATION_STATE.