Executar qualquer consulta de forma assíncrona

Compatibilidade do projeto

Windows | Multiplataforma

Visão geral

Description	Método do API	Caminho da API
Execute consultas de forma assíncrona no Snowflake, incluindo seleção, inserção, atualização e procedimentos armazenados.	Postar	/executeAsyncConsulte

Entrada

Parâmetro	Description	Tipo de dados
Consulta	Forneça uma consulta do Snowflake válida.	String
Consultar tag	As tags de consulta são rótulos que você pode anexar a cada consulta individual ou grupo de consultas para ajudar a organizar e categorizá-las para fins de rastreamento e relatórios.	lista de dados

Importante:

• Para recuperar o status de consultas assíncronas, use Obter status de execução de consulta assíncrona. Se o status for bem-sucedido, use Obter resultados da execução de consulta assíncronos. Você pode usar o ID da consulta da saída para gerar um esquema de saída enquanto usa Get Assíncrona Resultados da Execução de Consulta.
• O tipo de dados Snowflake Variant não é compatível.
• Por razões de segurança, alguns padrões e comandos não são suportados. Para obter uma lista completa, consulte a seção Restrições de consulta abaixo.

Saída

Parâmetro	Description	Tipo de dados
Resultados da consulta	Os resultados da consulta	Object
ID da consulta	O ID de execução exclusivo da instrução de consulta	String

Observação:

• Nos fluxos de trabalho de API, um único objeto de resposta é retornado como a saída. Quaisquer campos necessários podem ser extraídos diretamente deste objeto.
• Em fluxos de trabalho de RPA, alguns parâmetros de saída podem diferir, mas os valores necessários ainda podem ser recuperados do objeto de resposta, mesmo que não estejam explicitamente expostos.

Restrições de consulta

O conector do Snowflake impõe restrições de segurança em consultas SQL para evitar operações potencialmente nocivas. Os seguintes padrões e comandos não são compatíveis:

• Comentários SQL - Os seguintes padrões de comentários são bloqueados em qualquer lugar na consulta, incluindo dentro de valores de string:
  • # (hash/símbolo de linha)
  • -- (traço duplo)
  • /* e */ (delimitadores de comentários em bloco)
  • /**/ (comentários do bloco vazio)
• Referências de arquivo - As consultas não podem conter:
  • file: Padrões de URL
  • Comandos LOAD
• Comandos DDL - Operações em linguagem de definição de dados não são compatíveis:
  • Criar
  • Alterar
  • Soltar