Uso de ações do Snowflake em fluxos de ação

Suite, todas as versões

Team, Growth, Professional, Enterprise ou Enterprise Plus

Support

Team, Professional ou Enterprise

Resumo: ◀▼

Você pode conectar fluxos de ação ao Snowflake usando autenticação OAuth 2.0 para automatizar os fluxos de trabalho que envolvem consultas SQL, pesquisas de tabela e pesquisas de esquema. Use uma conta de serviço dedicada para uma integração segura. As ações disponíveis permitem que você execute instruções SQL, localize tabelas com filtros de padrão e receba informações de esquema de tabela detalhadas, ajudando a gerenciar dados e automatizar tarefas em plataformas com eficácia.

Ao conectar o criador de ações a sistemas externos, como o Snowflake, os administradores podem integrar o Zendesk a sistemas externos em fluxos de trabalho automatizados, melhorando a colaboração e mantendo uma experiência contínua em várias plataformas.

Observação: as etapas associadas aos sistemas externos em fluxos de ação são chamadas coletivamente de ações externas.

Este artigo contém os seguintes tópicos:

Conexão do Snowflake ao criador de ações
Uso de ações do Snowflake em fluxos de ação

Conexão do Snowflake ao criador de ações

Antes de incluir ações externas nos seus fluxos de ação, é preciso conectar o criador de ações ao sistema externo.

Ao se conectar a sistemas externos para uso em fluxos de ação, as seguintes práticas recomendadas devem ser observadas:

Todas as ações externas realizadas por um fluxo de ação são atribuídas ao usuário que conectou o sistema externo. Portanto, é uma prática recomendada usar uma conta de serviço dedicada em vez de credenciais pessoais ao se conectar a cada sistema externo.
Todas as integrações solicitam acesso aos escopos necessários. No entanto, é importante que você avalie e valide os escopos antes de autorizar a conexão com o sistema externo.
Ao gerenciar credenciais para ferramentas baseadas em chave de API, como a OpenAI, recomendamos armazenar as chaves em um cofre seguro ou em um gerenciador de credenciais.

A conexão do Snowflake usa a autenticação OAuth 2.0 com o tipo de concessão de código de autorização. Você precisará fornecer três informações:

Identificador da conta: seu identificador da conta do Snowflake (por exemplo, APAC_DEV.AWS_AP_NORTHEAST_1)
ID do cliente OAuth: o ID do cliente OAuth de sua integração de segurança do Snowflake
Segredo do cliente OAuth: o segredo do cliente OAuth de sua integração de segurança do Snowflake

Como configurar a autenticação OAuth no Snowflake

Crie uma integração de segurança no Snowflake com configurações OAuth.
Gere as credenciais de ID do cliente e segredo do cliente.
Configure os URIs de redirecionamento adequados para os fluxos de ação.

Como conectar o criador de ações ao Snowflake

Na Central de administração, clique em Aplicativos e integrações na barra lateral e selecione Ações > Fluxos de ação.
Crie ou edite um fluxo de ação.
Abra a barra lateral da etapa.
Em Ações externas, clique em Snowflake.
Clique em Conectar.
Siga os comandos do Snowflake para se autenticar e concluir a conexão.
O conector usa o escopo refresh_token durante a autenticação. A função e o armazenamento são especificados por ação em tempo de execução, fornecendo flexibilidade para escolher recursos apropriados com base nas necessidades da carga de trabalho.

Revise as permissões solicitadas com atenção antes de autorizar a conexão. Mantenha seu segredo do cliente seguro e não o compartilhe nem o inclua no controle de versão.

Observação: Todas as ações externas realizadas por um fluxo de ação são atribuídas ao usuário que conectou o sistema externo. Portanto, é uma prática recomendada usar uma conta de serviço dedicada em vez de credenciais pessoais ao se conectar a cada sistema externo.

Depois de se conectar ao sistema, você verá um indicador de conexão e detalhes sobre a instância à qual está conectado, bem como as ações disponíveis para o Snowflake.

Uso de ações do Snowflake em fluxos de ação

As seguintes ações do Snowflake estão disponíveis:

Execução de uma consulta
Pesquisa de tabelas
Pesquisa de um esquema de tabela

Execução de uma consulta

Use a ação Executar consulta para executar instruções SQL arbitrárias no Snowflake.

As entradas e saídas dessa ação são:

Variáveis

Entradas

	Variáveis
Entradas	Obrigatórias: `SQL statement`, `Warehouse`, `Role` Opcional: `Timeout` Ao usar a ação Executar consulta, considere o seguinte: O campo de instrução SQL tem suporte para todos os tipos de instrução SQL, incluindo SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, entre outras. O campo Warehouse é uma lista suspensa pesquisável de armazenamentos disponíveis. O campo Função é uma lista suspensa pesquisável de funções disponíveis. O campo Tempo limite especifica o tempo limote da consulta em segundos. Para consultas SELECT, a matriz de dados contém dados de linha como pares de valores-chave. Para operações INSERT, UPDATE ou DELETE, o campo de linhas afetadas mostra o número de linhas modificadas.
Saída	Resultados de execução de consulta, incluindo gerenciamento de consulta, URL de status, mensagem de execução, total de linhas, linhas afetadas e matriz de dados para consultas SELECT.

Obrigatórias: SQL statement, Warehouse, Role

Opcional: Timeout

Ao usar a ação Executar consulta, considere o seguinte:

O campo de instrução SQL tem suporte para todos os tipos de instrução SQL, incluindo SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, entre outras.
O campo Warehouse é uma lista suspensa pesquisável de armazenamentos disponíveis.
O campo Função é uma lista suspensa pesquisável de funções disponíveis.
O campo Tempo limite especifica o tempo limote da consulta em segundos.
Para consultas SELECT, a matriz de dados contém dados de linha como pares de valores-chave.
Para operações INSERT, UPDATE ou DELETE, o campo de linhas afetadas mostra o número de linhas modificadas.

Saída Resultados de execução de consulta, incluindo gerenciamento de consulta, URL de status, mensagem de execução, total de linhas, linhas afetadas e matriz de dados para consultas SELECT.

Pesquisa de tabelas

Use a ação Pesquisar tabelas para descobrir tabelas em um esquema de banco de dados Snowflake com filtro de padrão opcional.

As entradas e saídas dessa ação são:

Variáveis

Entradas

	Variáveis
Entradas	Obrigatórias: `Database`, `Schema`, `Warehouse`, `Role` Opcional: `Table name pattern` Ao usar a ação Pesquisar tabelas, considere o seguinte: O campo Banco de dados é uma lista suspensa pesquisável de bancos de dados disponíveis. O campo Esquema é uma lista suspensa pesquisável que depende do banco de dados selecionado. O campo Padrão de nome da tabela aceita padrões SQL LIKE para filtragem (por exemplo, "USER%" para localizar tabelas que começam com USER). Os campos Warehouse e Função são listas suspensas pesquisáveis.
Saída	Matriz de objetos de tabela contendo nome, tipo, contagem de linhas, tamanho em bytes e data de criação, além de contagem total. O campo de tipo indica o tipo de tabela (TABLE, VIEW e etc.).

Obrigatórias: Database, Schema, Warehouse, Role

Opcional: Table name pattern

Ao usar a ação Pesquisar tabelas, considere o seguinte:

O campo Banco de dados é uma lista suspensa pesquisável de bancos de dados disponíveis.
O campo Esquema é uma lista suspensa pesquisável que depende do banco de dados selecionado.
O campo Padrão de nome da tabela aceita padrões SQL LIKE para filtragem (por exemplo, "USER%" para localizar tabelas que começam com USER).
Os campos Warehouse e Função são listas suspensas pesquisáveis.

Saída

Matriz de objetos de tabela contendo nome, tipo, contagem de linhas, tamanho em bytes e data de criação, além de contagem total.

O campo de tipo indica o tipo de tabela (TABLE, VIEW e etc.).

Pesquisa de um esquema de tabela

Use a ação Pesquisar esquema da tabela para recuperar definições de coluna e metadados para uma tabela específica do Snowflake.

As entradas e saídas dessa ação são:

Variáveis

Entradas

	Variáveis
Entradas	Obrigatórias: `Database`, `Schema`, `Table`, `Warehouse`, `Role` Ao usar a ação Pesquisar esquema da tabela, considere o seguinte: O campo Banco de dados é uma lista suspensa pesquisável de bancos de dados disponíveis. O campo Esquema é uma lista suspensa pesquisável que depende do banco de dados selecionado. O campo Tabela é uma lista suspensa pesquisável que depende das seleções de banco de dados e esquema. Os campos Warehouse e Função são listas suspensas pesquisáveis.
Saída	Matriz de objetos de coluna contendo nome, tipo de dados, status anulável, valor padrão e indicador de chave primária, juntamente com a matriz de nomes de coluna de chave primária. A saída de coluna inclui informações de tipo de dados (por exemplo, VARCHAR, NUMBER, DATE), independente se cada coluna aceita valores nulos, valores padrão, se definidos, e se a coluna faz parte da chave primária. Para sua comodidade, o campo de chave primária fornece uma lista separada de todos os nomes de coluna de chave primária.

Obrigatórias: Database, Schema, Table, Warehouse, Role

Ao usar a ação Pesquisar esquema da tabela, considere o seguinte:

O campo Banco de dados é uma lista suspensa pesquisável de bancos de dados disponíveis.
O campo Esquema é uma lista suspensa pesquisável que depende do banco de dados selecionado.
O campo Tabela é uma lista suspensa pesquisável que depende das seleções de banco de dados e esquema.
Os campos Warehouse e Função são listas suspensas pesquisáveis.

Saída

Matriz de objetos de coluna contendo nome, tipo de dados, status anulável, valor padrão e indicador de chave primária, juntamente com a matriz de nomes de coluna de chave primária.

A saída de coluna inclui informações de tipo de dados (por exemplo, VARCHAR, NUMBER, DATE), independente se cada coluna aceita valores nulos, valores padrão, se definidos, e se a coluna faz parte da chave primária. Para sua comodidade, o campo de chave primária fornece uma lista separada de todos os nomes de coluna de chave primária.