Skip to main content

​
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.
  • 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 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, 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.