// snowflake native app · em breve
Enriqueça suas tabelas sem sair do Snowflake
Encontre, verifique e enriqueça e-mails, telefones e empresas para as linhas das suas tabelas, em SQL ou pelo app no Snowsight. Cobrado na sua fatura da Snowflake, sem conta na Tomba.
$0.0098 por crédito Tomba · cobrado pela Snowflake
// 01 · no snowsight
O app, ao lado dos seus dados
Um app Streamlit vem com o Native App: consulte um contato, enriqueça uma tabela inteira, monte listas de empresas e acompanhe cada execução. Cada página chama os mesmos procedimentos que você pode chamar em SQL.
Cada linha, uma execução
Aponte uma ferramenta para uma tabela ou uma view, associe as colunas e veja o custo máximo da execução antes de ela começar. Os resultados vão para uma nova tabela no app, e execuções grandes continuam em segundo plano.
Listas de empresas a partir de filtros
Escolha países, setores, palavras-chave, porte e mais. Só os filtros que você escolhe são enviados à Tomba, sem consulta em texto livre e sem IA, e as empresas vão para uma nova tabela.
Resultados ao lado dos seus dados
Cada tabela de resultados guarda os seus valores de entrada, para que possa ser unida de volta às suas linhas. Exporte as primeiras 10.000 linhas como arquivo CSV ou copie a tabela para o seu próprio banco de dados.
Execuções que você pode acompanhar e retomar
Acompanhe as execuções em andamento, cancele uma ou retome uma execução que parou: as linhas já concluídas são mantidas e não são cobradas de novo. A retomada automática tenta de novo no dia seguinte.
Tabelas sempre enriquecidas
Um agendamento executa uma ferramenta em uma tabela nos horários que você define e consulta apenas as linhas adicionadas desde a última execução. Só app_admin pode criar ou alterar um agendamento.
Uso e créditos num relance
A visão geral mostra o estado da instalação, as três formas de começar e os últimos 30 dias: linhas consultadas, créditos de busca e de verificação separados, e o que a Snowflake cobrou.
// 02 · em sql
Cada ferramenta é um procedimento que você chama
Chame a Tomba de uma worksheet, um notebook, uma task ou do dbt. Um valor volta na hora; uma tabela inteira roda em partes e grava uma tabela de resultados dentro do app.
-- one value: the answer comes back at once
CALL TOMBA.core.email_finder('piedpiper.com', 'Richard', 'Hendricks');-- every row of a table: results go to TOMBA.RESULTS.LEADS_FOUND
CALL TOMBA.core.find_emails(
'CRM.PUBLIC.LEADS',
'COMPANY_DOMAIN', 'FIRST_NAME', 'LAST_NAME',
'LEADS_FOUND',
1000
);-- any tool, with its options
CALL TOMBA.core.run_tool(
'domain_search',
'CRM.PUBLIC.ACCOUNTS',
{'domain': 'WEBSITE'},
'SALES_EMAILS',
100,
{'emails_per_domain': 20, 'department': 'sales'}
);-- a large table in the background, with a credit limit
CALL TOMBA.core.run_tool_async(
'email_finder',
'CRM.PUBLIC.LEADS',
{'domain': 'COMPANY_DOMAIN', 'first_name': 'FIRST_NAME', 'last_name': 'LAST_NAME'},
'LEADS_FOUND',
500000,
{'max_credits': 20000}
);
-- new rows every morning at 06:00 UTC
CALL TOMBA.core.create_schedule(
'DAILY_LEADS', 'email_finder', 'CRM.PUBLIC.LEADS',
{'domain': 'COMPANY_DOMAIN', 'full_name': 'NAME'},
'LEADS_ENRICHED', '0 6 * * *',
{'max_credits': 1000}
);-- read the results, then keep a copy in your own database
SELECT INPUT_FIRST_NAME, INPUT_LAST_NAME, EMAIL, SCORE, VERIFICATION_STATUS
FROM TOMBA.RESULTS.LEADS_FOUND
WHERE LOOKUP_STATUS = 'found';
CREATE TABLE crm.public.leads_found AS
SELECT * FROM TOMBA.RESULTS.LEADS_FOUND;Resultados · 3
| # | INPUT_FIRST_NAME | INPUT_LAST_NAME | SCORE | LOOKUP_STATUS | CREDITS | |
|---|---|---|---|---|---|---|
| 1 | Richard | Hendricks | richard@piedpiper.com | 100 | found | 1 |
| 2 | Dinesh | Chugtai | dinesh@piedpiper.com | 99 | found | 1 |
| 3 | Bertram | Gilfoyle | gilfoyle@piedpiper.com | 97 | found | 1 |
Uma tabela de resultados começa com os seus valores de entrada, para que possa ser unida de volta às suas linhas; cada linha diz se a Tomba encontrou algo e quanto custou.
// 03 · os procedimentos
13 ferramentas, para um valor ou uma tabela inteira
Cada ferramenta tem um procedimento para uma tabela inteira e outro para um único valor, e custa o que o endpoint da Tomba custa. Os procedimentos run_tool e lookup aceitam qualquer ferramenta pelo nome, com suas opções.
Email Finder1 search credit
core.find_emails(input_table, domain_column, first_name_column, last_name_column, output_table)
core.email_finder(domain, first_name, last_name)
Email Verifier1 verification credit
core.verify_emails(input_table, email_column, output_table)
core.email_verifier(email)
Domain Search1 search credit per 10 emails requested
core.search_domains(input_table, domain_column, output_table)
core.domain_search(domain)
Email Enrichment1 search credit
core.enrich_emails(input_table, email_column, output_table)
core.email_enrichment(email)
Person Enrichment1 search credit
core.enrich_people(input_table, email_column, output_table)
core.person_enrichment(email)
Todas as 13 ferramentas
Company Enrichment1 search credit
core.enrich_companies(input_table, domain_column, output_table)
core.company_enrichment(domain)
Combined Enrichment2 search credits
core.enrich_combined(input_table, email_column, output_table)
core.combined_enrichment(email)
LinkedIn Finder1 search credit
core.find_emails_from_linkedin(input_table, url_column, output_table)
core.linkedin_finder(url)
Author Finder1 search credit
core.find_authors(input_table, url_column, output_table)
core.author_finder(url)
Phone Finder5 search credits
core.find_phones(input_table, email_column, output_table)
core.phone_finder(email)
Phone Validator1 search credit
core.validate_phones(input_table, phone_column, output_table)
core.phone_validator(phone)
Similar Domains1 search credit
core.find_similar_domains(input_table, domain_column, output_table)
core.similar_finder(domain)
Companies Search1 search credit per 50 companies
core.search_companies(filters, output_table, max_results)
core.lookup('companies_search', {…})
| Ferramenta | Tabela inteira | Um valor | Custo |
|---|---|---|---|
Email FinderGET /email-finder | core.find_emails(input_table, domain_column, first_name_column, last_name_column, output_table) | core.email_finder(domain, first_name, last_name) | 1 search credit |
Email VerifierGET /email-verifier | core.verify_emails(input_table, email_column, output_table) | core.email_verifier(email) | 1 verification credit |
Domain SearchGET /domain-search | core.search_domains(input_table, domain_column, output_table) | core.domain_search(domain) | 1 search credit per 10 emails requested |
Email EnrichmentGET /enrich | core.enrich_emails(input_table, email_column, output_table) | core.email_enrichment(email) | 1 search credit |
Person EnrichmentGET /people/find | core.enrich_people(input_table, email_column, output_table) | core.person_enrichment(email) | 1 search credit |
Company EnrichmentGET /companies/find | core.enrich_companies(input_table, domain_column, output_table) | core.company_enrichment(domain) | 1 search credit |
Combined EnrichmentGET /combined/find | core.enrich_combined(input_table, email_column, output_table) | core.combined_enrichment(email) | 2 search credits |
LinkedIn FinderGET /linkedin | core.find_emails_from_linkedin(input_table, url_column, output_table) | core.linkedin_finder(url) | 1 search credit |
Author FinderGET /author-finder | core.find_authors(input_table, url_column, output_table) | core.author_finder(url) | 1 search credit |
Phone FinderGET /phone-finder | core.find_phones(input_table, email_column, output_table) | core.phone_finder(email) | 5 search credits |
Phone ValidatorGET /phone-validator | core.validate_phones(input_table, phone_column, output_table) | core.phone_validator(phone) | 1 search credit |
Similar DomainsGET /similar | core.find_similar_domains(input_table, domain_column, output_table) | core.similar_finder(domain) | 1 search credit |
Companies SearchPOST /reveal/search | core.search_companies(filters, output_table, max_results) | core.lookup('companies_search', {…}) | 1 search credit per 50 companies |
Em toda tabela de resultados
Primeiro os seus valores de entrada, como colunas INPUT_, depois as colunas da própria ferramenta e depois estas:
- LOOKUP_STATUS
- CREDITS
- CREDIT_TYPE
- DATA
- ERROR
- LOOKED_UP_AT
- SOURCE
// 04 · configuração
Do Marketplace à sua primeira execução
O app cria a própria conexão com api.tomba.io; você a aprova e escolhe as tabelas que ele pode ler. Não há regra de rede, segredo nem chave de API para configurar.
- 01
Obtenha o app
Encontre a Tomba no Snowsight em Data Products › Marketplace, dê um nome ao app e escolha um warehouse. X-Small é suficiente.
- 02
Aprove a conexão
Na guia Security do app, aprove a conexão Tomba API. Ela alcança apenas api.tomba.io.
- 03
Compartilhe suas tabelas
Escolha uma tabela ou uma view no app, ou conceda SELECT nela em SQL.
- 04
Execute uma ferramenta
Consulte um contato ou enriqueça uma tabela no app, ou chame um procedimento de qualquer worksheet.
// 05 · preços
Pague por crédito, na sua fatura da Snowflake
Sem plano e sem conta na Tomba: a Snowflake cobra cada crédito Tomba que o app usa, com um único preço para créditos de busca e de verificação.
// por crédito tomba
$0.0098
Por crédito de busca ou de verificação, cobrado pela Snowflake. Cada ferramenta custa o mesmo que custa em tomba.io.
Exemplos, arredondados ao centavo
- 1 → $0.01
- 3 → $0.03
- 51 → $0.50
- 1,000 → $9.80
O que não é cobrado
Consultas que não encontram nada, entradas inválidas, erros, respostas do cache, repetições da mesma consulta no mês e linhas duplicadas. O Phone Validator é cobrado a cada verificação.
Um teto para cada execução
Defina um limite de créditos para uma execução e um orçamento mensal de créditos para o app inteiro. As execuções são dimensionadas para o pior caso, então nunca passam do limite.
Novas instalações começam com limite
200 consultas por dia UTC até a instalação ser confirmada nos registros da Snowflake, geralmente em poucas horas.
Testes da listagem
Durante um teste da listagem no Marketplace, cada chamada processa até 100 linhas e nada é cobrado.
Computação do Snowflake
Execuções em segundo plano e agendamentos usam tasks serverless, cobradas na sua conta como qualquer task serverless.
Sem cobrança em dobro
Uma execução interrompida continua de onde parou: as linhas já concluídas são mantidas e não são cobradas de novo.
// 06 · seus dados
Suas tabelas ficam no Snowflake
O app lê apenas as tabelas que você compartilha, grava os resultados dentro dele mesmo e envia à Tomba apenas os valores de que cada consulta precisa.
O que sai da sua conta
- Um host, aprovado por você
- O app só consegue alcançar
api.tomba.io:443, pela conexão de acesso externo que você aprova. - Só o que cada consulta precisa
- Os valores que você passa, como domínios, nomes, e-mails, URLs e números de telefone, e contagens de uso para a cobrança. Nunca as suas tabelas.
O que fica no Snowflake
- Resultados no app
- As tabelas de resultados ficam em
TOMBA.RESULTS, na sua conta. Copie-as para o seu próprio banco de dados para guardar e compartilhar. - Credenciais que nenhuma função consegue ler
- O app guarda as credenciais em um schema privado. Não há chave de API para você guardar.
- Duas funções do app
app_publicexecuta as ferramentas e lê resultados e histórico;app_admintambém altera configurações e agendamentos.- Acesso somente leitura
- As tabelas e views que você compartilha são lidas apenas com
SELECT.
Compartilhe uma tabela e dê acesso às pessoas
-- let the app read a table (or use Choose a table in the app)
GRANT USAGE ON DATABASE crm TO APPLICATION TOMBA;
GRANT USAGE ON SCHEMA crm.public TO APPLICATION TOMBA;
GRANT SELECT ON TABLE crm.public.leads TO APPLICATION TOMBA;
-- who runs the tools, and who changes the settings
GRANT APPLICATION ROLE TOMBA.app_public TO ROLE analyst;
GRANT APPLICATION ROLE TOMBA.app_admin TO ROLE sysadmin;// perguntas frequentes
Perguntas sobre a Tomba para Snowflake
Ainda tem dúvidas? Visite a central de ajuda
Snowflake é uma marca comercial da Snowflake Inc.
// tomba para snowflake
Em breve no Snowflake Marketplace
Leia como o app funciona, procedimento por procedimento, ou escreva para nós sobre a sua conta Snowflake.