> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar o Tomi ao Snowflake

> Dê ao Tomi acesso aos seus dados de publicidade sem exportar relatórios repetidamente.

## O que é o conector do Snowflake?

Você não precisa usar a plataforma de anúncios da Topsort para dar ao Tomi um contexto rico sobre seus dados de anúncios. Se seus dados de publicidade já estão no Snowflake, você pode conectá-los diretamente ao Tomi. Conecte detalhes de campanha, desempenho, catálogo de produtos e dados de inventário para que o Tomi tenha o contexto necessário para responder a perguntas e fazer recomendações.

Clientes atuais da Topsort também podem fornecer contexto de negócio adicional, como dados de fidelidade e margem de vendas.

Depois de conectado, faça perguntas em linguagem natural. O Tomi escreve e executa SQL no banco de dados conectado, usando o acesso que você conceder.

## Antes de começar

Você vai precisar de:

* Uma conta em [tomi.topsort.com](https://tomi.topsort.com).
* Dados de publicidade armazenados no Snowflake.
* Um administrador do Snowflake para criar um usuário, configurar acesso somente leitura e gerar um token de acesso programático.

Escolha tabelas que deem ao Tomi um contexto útil de publicidade. Detalhes e desempenho de campanha são o ponto de partida mais importante. Catálogo de produtos, inventário e outros dados de negócio podem apoiar uma análise mais detalhada.

Use os mesmos IDs nas tabelas para que o Tomi conecte as configurações das campanhas aos produtos e aos resultados. Comentários de tabelas e colunas no Snowflake ajudam o Tomi a entender seus dados.

Veja [Tomi para quem não é cliente](https://docs.topsort.com/pt/knowledge-base/ad-platform/tomi/non-clients.md) para orientação sobre as informações a fornecer.

## Conectar seu warehouse

1. **Crie um usuário e uma função somente leitura no Snowflake.** Conceda `SELECT` nas tabelas que o Tomi deve acessar e `USAGE` no warehouse e no banco de dados necessários. Não conceda privilégios de escrita. O Tomi rejeita a conexão se detectar permissões para inserir, atualizar, excluir ou alterar objetos.

2. **Crie um token de acesso programático** para o usuário do Snowflake.

3. **Abra a conexão do Snowflake no Tomi.** Entre em [tomi.topsort.com](https://tomi.topsort.com), abra **Connections** e selecione **Connect** em Snowflake.

4. **Informe os dados da conexão:**

   * Identificador da conta, por exemplo `xy12345.us-east-1`
   * Usuário
   * Warehouse
   * Banco de dados
   * Função
   * Token de acesso programático

   Informar a função é fortemente recomendado. Se ficar em branco, o Tomi usa a função padrão do usuário. O Tomi usa a função selecionada mesmo que o usuário tenha outras funções.

5. **Aguarde a varredura do esquema.** O status muda de **Reading schema** para **Ready** quando a conexão fica disponível. Se a varredura falhar, selecione **Rescan schema** para tentar de novo.

6. **Confira a conexão com uma pergunta.** Pergunte ao Tomi sobre as tabelas conectadas e confirme que ele consegue acessar os dados pretendidos.

## Faça perguntas sobre seus dados de publicidade

Comece com uma pergunta que identifique o período, as campanhas ou o resultado de negócio que você quer investigar. Por exemplo:

* “Quais campanhas tiveram a maior queda de ROAS nos últimos 30 dias?”
* “Compare o desempenho das campanhas por categoria de produto e identifique onde o gasto gera poucas compras.”
* “Use nossos dados de margem de produto para identificar campanhas com ROAS alto, mas baixa lucratividade.”

As perguntas que o Tomi pode responder dependem das tabelas e dos campos que você disponibilizar. Novas perguntas podem usar a conexão existente, sem outra exportação de arquivo.

## Acesso e limites

* **Acesso somente leitura:** O Tomi consulta os dados; ele não pode alterar seus registros ou objetos no Snowflake.
* **Armazenamento de credenciais:** O token de acesso é criptografado em repouso e nunca é exibido novamente.
* **Acesso aos dados:** O Tomi consulta seu warehouse diretamente. Ele não copia seu banco de dados para a Topsort.
* **Escopo da conexão:** Cada usuário do Tomi pode ter uma conexão do Snowflake, usando um usuário, um warehouse, um banco de dados e uma função do Snowflake.
* **Descoberta de esquema:** A varredura do esquema cobre até 200 tabelas e usa os comentários do Snowflake para iniciar as descrições.
* **Limites de consulta:** As consultas retornam até 200 linhas e são canceladas após 60 segundos.

## Desconectar ou reconectar

Desconecte a conexão do Snowflake em **Connections**. Desconectar exclui o token armazenado. Para reconectar, informe um novo token.

***

**Última atualização:** 
<time dateTime="2026-10-30">2026-10-30</time>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.