// snowflake native app · próximamente
Enriquece tus tablas sin salir de Snowflake
Encuentra, verifica y enriquece emails, teléfonos y empresas para las filas de tus tablas, desde SQL o desde la app en Snowsight. Con cargo en tu factura de Snowflake, sin cuenta de Tomba.
$0.0098 por crédito de Tomba · lo factura Snowflake
// 01 · en snowsight
La app, junto a tus datos
La Native App incluye una app de Streamlit: busca un contacto, enriquece una tabla entera, crea listas de empresas y sigue cada ejecución. Cada página llama a los mismos procedimientos que puedes llamar desde SQL.
Cada fila, una sola ejecución
Apunta una herramienta a una tabla o una vista, asigna sus columnas y mira lo máximo que puede costar la ejecución antes de que empiece. Los resultados van a una tabla nueva dentro de la app, y las ejecuciones grandes siguen en segundo plano.
Listas de empresas a partir de filtros
Elige países, sectores, palabras clave, tamaño y más. Solo se envían a Tomba los filtros que eliges, sin consulta de texto libre ni IA, y las empresas llegan a una tabla nueva.
Resultados junto a tus datos
Cada tabla de resultados conserva tus valores de entrada, así que se puede unir de nuevo a tus filas. Exporta las primeras 10.000 filas como archivo CSV o copia la tabla en tu propia base de datos.
Ejecuciones que puedes seguir y reanudar
Sigue las ejecuciones en curso, cancela una o reanuda una ejecución que se detuvo: las filas ya hechas se conservan y no se vuelven a cobrar. La reanudación automática lo vuelve a intentar al día siguiente.
Tablas siempre enriquecidas
Una programación ejecuta una herramienta sobre una tabla a las horas que fijes y solo busca las filas añadidas desde su última ejecución. Solo app_admin puede crear o cambiar una.
Uso y créditos de un vistazo
El resumen muestra el estado de la instalación, las tres formas de empezar y los últimos 30 días: filas buscadas, créditos de búsqueda y de verificación por separado, y lo que cobró Snowflake.
// 02 · en sql
Cada herramienta es un procedimiento que llamas
Llama a Tomba desde una hoja de trabajo, un notebook, una tarea o dbt. Un valor vuelve al momento; una tabla entera se ejecuta por partes y escribe una tabla de resultados dentro de la 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 |
Una tabla de resultados empieza con tus valores de entrada, así que se puede unir de nuevo a tus filas; cada fila indica si Tomba la encontró y lo que costó.
// 03 · los procedimientos
13 herramientas, para un valor o una tabla entera
Cada herramienta tiene un procedimiento para una tabla entera y otro para un solo valor, y cuesta lo que cuesta su endpoint de Tomba. Los procedimientos run_tool y lookup aceptan cualquier herramienta por su nombre, con sus opciones.
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)
Las 13 herramientas
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', {…})
| Herramienta | Tabla entera | Un valor | Coste |
|---|---|---|---|
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 |
En cada tabla de resultados
Primero tus valores de entrada, como columnas INPUT_, luego las columnas propias de la herramienta y después estas:
- LOOKUP_STATUS
- CREDITS
- CREDIT_TYPE
- DATA
- ERROR
- LOOKED_UP_AT
- SOURCE
// 04 · configuración
Del Marketplace a tu primera ejecución
La app crea su propia conexión con api.tomba.io; tú la apruebas y eliges las tablas que puede leer. No hay que configurar ninguna regla de red, secreto ni clave de API.
- 01
Consigue la app
Busca Tomba en Snowsight, en Data Products › Marketplace, ponle nombre a la app y elige un almacén. X-Small es suficiente.
- 02
Aprueba la conexión
En la pestaña Security de la app, aprueba la conexión Tomba API. Solo llega a api.tomba.io.
- 03
Comparte tus tablas
Elige una tabla o una vista en la app, o concede SELECT sobre ella desde SQL.
- 04
Ejecuta una herramienta
Busca un contacto o enriquece una tabla en la app, o llama a un procedimiento desde cualquier hoja de trabajo.
// 05 · precios
Paga por crédito, en tu factura de Snowflake
Sin plan de Tomba y sin cuenta de Tomba: Snowflake factura cada crédito de Tomba que usa la app, al mismo precio para los créditos de búsqueda y de verificación.
// por crédito de tomba
$0.0098
Por cada crédito de búsqueda o de verificación, facturado por Snowflake. Cada herramienta cuesta lo mismo que en tomba.io.
Ejemplos, redondeados al céntimo
- 1 → $0.01
- 3 → $0.03
- 51 → $0.50
- 1,000 → $9.80
Lo que no se cobra
Las búsquedas que no encuentran nada, las entradas no válidas, los errores, las respuestas de la caché, las repeticiones de la misma búsqueda en el mes y las filas duplicadas. Phone Validator se cobra en cada comprobación.
Un límite para cada ejecución
Fija un límite de créditos para una ejecución y un presupuesto mensual de créditos para toda la app. Las ejecuciones se calculan para el peor caso, así que nunca lo superan.
Las instalaciones nuevas empiezan con límite
200 búsquedas por día UTC hasta que la instalación se confirma en los registros de Snowflake, normalmente en unas horas.
Pruebas de la ficha
Durante una prueba de la ficha del Marketplace, cada llamada procesa hasta 100 filas y no se cobra nada.
Cómputo de Snowflake
Las ejecuciones en segundo plano y las programaciones usan tareas sin servidor, que se facturan a tu cuenta como cualquier tarea sin servidor.
Nada se cobra dos veces
Una ejecución que se detuvo se reanuda donde lo dejó: las filas ya hechas se conservan y no se vuelven a cobrar.
// 06 · tus datos
Tus tablas se quedan en Snowflake
La app solo lee las tablas que compartes, escribe sus resultados en sus propias tablas y solo envía a Tomba los valores que necesita cada búsqueda.
Lo que sale de tu cuenta
- Un solo host, aprobado por ti
- La app solo puede llegar a
api.tomba.io:443, a través de la conexión de acceso externo que apruebas. - Solo lo que necesita cada búsqueda
- Los valores que pasas, como dominios, nombres, emails, URL y números de teléfono, y los recuentos de uso para la facturación. Nunca tus tablas.
Lo que se queda en Snowflake
- Resultados en la app
- Las tablas de resultados están en
TOMBA.RESULTS, en tu cuenta. Cópialas en tu propia base de datos para conservarlas y compartirlas. - Credenciales que ningún rol puede leer
- La app guarda sus credenciales en un esquema privado. No tienes que guardar ninguna clave de API.
- Dos roles de la app
app_publicejecuta las herramientas y lee los resultados y el historial;app_admintambién cambia la configuración y las programaciones.- Acceso de solo lectura
- Las tablas y vistas que compartes se leen solo con
SELECT.
Comparte una tabla y da acceso a las personas
-- 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;// preguntas frecuentes
Preguntas sobre Tomba para Snowflake
¿Tiene más preguntas? Visite el centro de ayuda
Snowflake es una marca comercial de Snowflake Inc.
// tomba para snowflake
Próximamente en Snowflake Marketplace
Lee cómo funciona la app, procedimiento a procedimiento, o escríbenos sobre tu cuenta de Snowflake.