// snowflake native app · скоро
Обогащайте свои таблицы, не покидая Snowflake
Находите, проверяйте и обогащайте email, телефоны и компании для строк ваших таблиц из SQL или из приложения в Snowsight. Оплата в счёте Snowflake, аккаунт Tomba не нужен.
$0.0098 за кредит Tomba · оплата через Snowflake
// 01 · в snowsight
Приложение рядом с вашими данными
Вместе с Native App поставляется приложение Streamlit: найдите один контакт, обогатите целую таблицу, составьте списки компаний и следите за каждым запуском. Каждая страница вызывает те же процедуры, которые можно вызвать из SQL.
Каждая строка, один запуск
Направьте инструмент на таблицу или представление, сопоставьте столбцы и ещё до старта увидите максимальную стоимость запуска. Результаты попадают в новую таблицу в приложении, а большие запуски продолжаются в фоновом режиме.
Списки компаний по фильтрам
Выберите страны, отрасли, ключевые слова, размер и другое. В Tomba отправляются только выбранные фильтры, без произвольного текстового запроса и без ИИ, а компании попадают в новую таблицу.
Результаты рядом с вашими данными
Каждая таблица результатов хранит ваши входные значения, поэтому её можно соединить с вашими строками. Экспортируйте первые 10 000 строк в CSV-файл или скопируйте таблицу в свою базу данных.
Запуски можно отслеживать и возобновлять
Следите за текущими запусками, отменяйте их или возобновляйте остановленные: уже обработанные строки сохраняются и повторно не оплачиваются. Автовозобновление пробует снова на следующий день.
Таблицы, которые остаются обогащёнными
Расписание запускает инструмент для таблицы в заданное время и ищет только строки, добавленные после прошлого запуска. Создавать и менять расписания может только app_admin.
Использование и кредиты с первого взгляда
Обзор показывает состояние установки, три способа начать работу и последние 30 дней: обработанные строки, кредиты на поиск и на проверку по отдельности и сумму, списанную Snowflake.
// 02 · в sql
Каждый инструмент доступен как вызываемая процедура
Вызывайте Tomba из рабочего листа, ноутбука, задачи или dbt. Одно значение возвращается сразу; целая таблица обрабатывается частями и записывает таблицу результатов внутри приложения.
-- 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;Результаты · 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 |
Таблица результатов начинается с ваших входных значений, поэтому её можно соединить с вашими строками; в каждой строке указано, нашёл ли Tomba результат и сколько это стоило.
// 03 · процедуры
13 инструментов для одного значения или целой таблицы
У каждого инструмента есть процедура для целой таблицы и процедура для одного значения, и стоит он столько же, сколько его эндпоинт Tomba. Процедуры run_tool и lookup принимают любой инструмент по имени вместе с его параметрами.
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)
Все инструменты (13)
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', {…})
| Инструмент | Вся таблица | Одно значение | Стоимость |
|---|---|---|---|
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 |
В каждой таблице результатов
Сначала ваши входные значения в столбцах INPUT_, затем собственные столбцы инструмента, а затем эти:
- LOOKUP_STATUS
- CREDITS
- CREDIT_TYPE
- DATA
- ERROR
- LOOKED_UP_AT
- SOURCE
// 04 · настройка
От Marketplace до первого запуска
Приложение само создаёт подключение к api.tomba.io; вы одобряете его и выбираете таблицы, которые оно может читать. Не нужно настраивать сетевые правила, секреты или API-ключи.
- 01
Получите приложение
Найдите Tomba в Snowsight в разделе Data Products › Marketplace, задайте имя приложения и выберите warehouse. Размера X-Small достаточно.
- 02
Одобрите подключение
На вкладке Security приложения одобрите подключение Tomba API. Оно обращается только к api.tomba.io.
- 03
Откройте доступ к таблицам
Выберите таблицу или представление в приложении либо выдайте на него SELECT из SQL.
- 04
Запустите инструмент
Найдите контакт или обогатите таблицу в приложении либо вызовите процедуру из любого рабочего листа.
// 05 · цены
Оплата за кредит в вашем счёте Snowflake
Без тарифа Tomba и без аккаунта Tomba: Snowflake выставляет счёт за каждый кредит Tomba, который использует приложение, по единой цене для кредитов на поиск и на проверку.
// за кредит tomba
$0.0098
За каждый кредит на поиск или на проверку, оплата через Snowflake. Каждый инструмент стоит столько же, сколько на tomba.io.
Примеры с округлением до цента
- 1 → $0.01
- 3 → $0.03
- 51 → $0.50
- 1,000 → $9.80
Что не оплачивается
Запросы без результата, неверные входные данные, ошибки, ответы из кэша, повторы того же запроса в течение месяца и дубликаты строк. Phone Validator оплачивается за каждую проверку.
Предел для каждого запуска
Задайте лимит кредитов для запуска и месячный бюджет кредитов для всего приложения. Запуск рассчитывается по максимальной возможной стоимости, поэтому лимит не превышается.
Новые установки начинают с лимита
200 запросов в сутки по UTC, пока установка не будет подтверждена в записях Snowflake, обычно в течение нескольких часов.
Пробные версии в Marketplace
Во время пробного периода листинга в Marketplace каждый вызов обрабатывает до 100 строк, и ничего не оплачивается.
Вычисления Snowflake
Фоновые запуски и расписания используют бессерверные задачи, которые оплачиваются с вашего аккаунта как любые бессерверные задачи.
Без повторной оплаты
Остановленный запуск продолжается с того места, где остановился: уже обработанные строки сохраняются и повторно не оплачиваются.
// 06 · ваши данные
Ваши таблицы остаются в Snowflake
Приложение читает только таблицы, к которым вы открыли доступ, записывает результаты внутри себя и отправляет в Tomba только значения, нужные для каждого запроса.
Что покидает ваш аккаунт
- Один хост, одобренный вами
- Приложение может обращаться только к
api.tomba.io:443через одобренное вами подключение внешнего доступа. - Только то, что нужно запросу
- Значения, которые вы передаёте, например домены, имена, email, URL и номера телефонов, а также счётчики использования для оплаты. Ваши таблицы никогда не отправляются.
Что остаётся в Snowflake
- Результаты в приложении
- Таблицы результатов хранятся в
TOMBA.RESULTSв вашем аккаунте. Скопируйте их в свою базу данных, чтобы сохранить и делиться ими. - Учётные данные, которые не прочитает ни одна роль
- Приложение хранит свои учётные данные в закрытой схеме. Вам не нужно хранить API-ключ.
- Две роли приложения
app_publicзапускает инструменты и читает результаты и историю;app_adminтакже меняет настройки и расписания.- Доступ только на чтение
- Таблицы и представления, к которым вы открыли доступ, читаются только через
SELECT.
Откройте доступ к таблице и выдайте права пользователям
-- 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;Snowflake является товарным знаком Snowflake Inc.
// tomba для snowflake
Скоро в Snowflake Marketplace
Прочитайте, как работает приложение, процедура за процедурой, или напишите нам о вашем аккаунте Snowflake.