Snowflake Basic

Visão geral

O Snowflake é um data warehouse em nuvem que oferece escalabilidade elástica, compartilhamento seguro de dados e análise SQL em múltiplos ambientes de nuvem. Com a integração no SquadOS, seus agentes podem executar consultas SQL, listar bancos de dados e esquemas, explorar colunas e descrever tabelas diretamente no seu Snowflake — sem sair do fluxo do agente.

Site oficial: https://www.snowflake.com/
Documentação na Composio: docs.composio.dev/toolkits/snowflake_basic

Autenticação

Esta ferramenta utiliza autenticação básica (usuário/senha) (BASIC) para conectar.

Você vai precisar dos seguintes campos:

Campo	Obrigatório	Descrição
`username`	Sim	Nome de usuário da conta Snowflake.
`password`	Sim	Senha da conta Snowflake.
`account`	Sim	Identificador da conta Snowflake no formato `orgname-accountname` (ex.: `myorg-myaccount`). Encontrado em Admin → Accounts no Snowflake.

Consulte a Composio para confirmar a lista completa de campos obrigatórios de conexão.

Como obter a credencial

Acesse app.snowflake.com e faça login com um usuário que tenha permissão de consulta nos dados desejados.
Para obter o identificador da conta, vá em Admin → Accounts e copie o valor exibido na coluna Account. O formato é orgname-accountname.
Certifique-se de que o usuário tem os privilégios necessários (USAGE no warehouse, banco de dados e esquema que serão consultados).

Como conectar no SquadOS

Acesse Ferramentas no menu lateral (/admin/tools).
Abra a aba Disponíveis e procure por Snowflake Basic.
Clique no card para abrir o modal de detalhes e em Conectar.
Você é levado para a página de conexão segura hospedada pela Composio, onde informa as credenciais obtidas acima.
Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Ações disponíveis

Descrever tabela

SNOWFLAKE_BASIC_DESCRIBE_TABLE

Recupera informações detalhadas de cada coluna (incluindo nome, tipo de dado, tipo de campo, nulabilidade, valor padrão e status de chave) de uma tabela Snowflake especificada.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`database`	string	Sim	O nome do banco de dados Snowflake que contém a tabela.
`table_name`	string	Sim	O nome da tabela a descrever.
`schema_name`	string	Sim	O nome do esquema dentro do banco de dados que contém a tabela.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Explorar colunas

SNOWFLAKE_BASIC_EXPLORE_COLUMNS

Recupera uma amostra de valores distintos para colunas especificadas de uma tabela Snowflake.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`limit`	integer	Não	Número máximo de valores distintos a retornar para cada coluna especificada.
`database`	string	Sim	O nome do banco de dados Snowflake.
`table_name`	string	Sim	O nome da tabela dentro do esquema especificado.
`schema_name`	string	Sim	O nome do esquema dentro do banco de dados especificado.
`column_names`	array	Não	Lista de nomes de colunas específicas a explorar. Se vazio, todas as colunas da tabela serão exploradas.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Executar consulta

SNOWFLAKE_BASIC_RUN_QUERY

Executa a consulta SQL fornecida no Snowflake dentro do banco de dados e esquema especificados (que devem existir e estar acessíveis), configurando o contexto automaticamente antes.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`query`	string	Sim	Consulta SQL a executar; roda dentro do contexto do banco de dados e esquema especificados.
`database`	string	Sim	Nome do banco de dados Snowflake.
`schema_name`	string	Sim	Nome do esquema dentro do banco de dados especificado.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar bancos de dados

SNOWFLAKE_BASIC_SHOW_DATABASES

Recupera a lista de todos os bancos de dados disponíveis na conta Snowflake.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar esquemas

SNOWFLAKE_BASIC_SHOW_SCHEMAS

Recupera a lista de todos os esquemas dentro de um banco de dados Snowflake especificado.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`database`	string	Sim	O nome do banco de dados para o qual listar os esquemas.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar tabelas

SNOWFLAKE_BASIC_SHOW_TABLES

Recupera a lista de tabelas, incluindo contagem de linhas e tamanhos em bytes, de um esquema especificado dentro de um banco de dados Snowflake.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`database`	string	Sim	O nome do banco de dados que contém o esquema do qual listar as tabelas.
`schema_name`	string	Sim	O nome do esquema dentro do banco de dados especificado para o qual listar as tabelas.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.