// 01 · snowsight で
アプリをデータのすぐ隣に
Native App には Streamlit アプリが付属しています。連絡先を 1 件検索し、テーブル全体をエンリッチし、企業リストを作成し、すべての実行を追跡できます。各ページは、SQL から呼び出せるのと同じプロシージャを呼び出します。
すべての行を 1 回の実行で
ツールにテーブルまたはビューを指定して列を対応付けると、実行前に最大コストを確認できます。結果はアプリ内の新しいテーブルに書き込まれ、大きな実行はバックグラウンドで続きます。
フィルターから企業リストを作成
国、業種、キーワード、規模などを選びます。Tomba に送信されるのは選んだフィルターだけで、自由記述のクエリや AI は使いません。企業は新しいテーブルに書き込まれます。
データのすぐ隣に結果を
結果テーブルには入力値がそのまま残るため、元の行に結合できます。最初の 10,000 行を CSV ファイルとしてエクスポートするか、テーブルを自分のデータベースにコピーできます。
追跡も再開もできる実行
実行中の処理を追跡し、キャンセルしたり、停止した実行を再開したりできます。処理済みの行は保持され、再び課金されることはありません。自動再開は翌日にもう一度試行します。
テーブルを常にエンリッチされた状態に
スケジュールは設定した時刻にテーブルでツールを実行し、前回の実行以降に追加された行だけを検索します。作成や変更ができるのは app_admin だけです。
使用状況とクレジットをひと目で
概要ページには、インストールの状態、3 つの始め方、過去 30 日間の利用状況(検索した行数、別々に表示される検索クレジットと検証クレジット、Snowflake の請求額)が表示されます。
// 02 · sql で
どのツールも呼び出せるプロシージャ
ワークシート、ノートブック、タスク、dbt から Tomba を呼び出せます。1 つの値はすぐに返り、テーブル全体はチャンク単位で実行され、アプリ内に結果テーブルを書き込みます。
-- 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 のツールを、1 つの値にもテーブル全体にも
各ツールにはテーブル全体用と単一の値用のプロシージャがあり、対応する 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', {…})
| ツール | テーブル全体 | 1 つの値 | コスト |
|---|---|---|---|
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
アプリを入手
Snowsight の Data Products › Marketplace で Tomba を見つけ、アプリに名前を付けてウェアハウスを選びます。X-Small で十分です。
- 02
接続を承認
アプリの Security タブで Tomba API 接続を承認します。接続先は api.tomba.io だけです。
- 03
テーブルを共有
アプリでテーブルまたはビューを選ぶか、SQL で SELECT 権限を付与します。
- 04
ツールを実行
アプリで連絡先を検索したりテーブルをエンリッチしたりするか、任意のワークシートからプロシージャを呼び出します。
// 05 · 料金
クレジット単位の支払いをSnowflake の請求書で
Tomba のプランもアカウントも不要です。アプリが使う Tomba クレジットは、検索クレジットと検証クレジットの区別なく同じ価格で Snowflake が請求します。
// tomba クレジットあたり
$0.0098
検索クレジットまたは検証クレジット 1 つごとに、Snowflake が請求します。各ツールのコストは tomba.io と同じです。
例(セント単位で四捨五入)
- 1 → $0.01
- 3 → $0.03
- 51 → $0.50
- 1,000 → $9.80
課金されないもの
何も見つからなかった検索、無効な入力、エラー、キャッシュからの応答、同じ月内の同じ検索の繰り返し、重複した行。Phone Validator はチェックごとに課金されます。
すべての実行に上限
実行ごとのクレジット上限と、アプリ全体の月間クレジット予算を設定できます。実行は最悪のケースを想定して見積もられるため、上限を超えることはありません。
新しいインストールには上限があります
インストールが Snowflake の記録で確認されるまでは、UTC の 1 日あたり 200 件の検索に制限されます。確認は通常数時間以内です。
リスティングのトライアル
Marketplace リスティングのトライアル中は、1 回の呼び出しで最大 100 行を処理し、料金はかかりません。
Snowflake のコンピューティング
バックグラウンドの実行とスケジュールはサーバーレスタスクを使い、他のサーバーレスタスクと同様にアカウントに請求されます。
二重課金なし
停止した実行は中断したところから再開します。処理済みの行は保持され、再び課金されることはありません。
// 06 · あなたのデータ
テーブルはSnowflake の中に残ります
アプリは共有されたテーブルだけを読み取り、結果はアプリ内に書き込み、Tomba には各検索に必要な値だけを送信します。
アカウントの外に送信されるもの
- 接続先はあなたが承認した 1 つのホストだけ
- アプリが接続できるのは、あなたが承認した外部アクセス接続を通じた
api.tomba.io:443だけです。 - 各検索に必要なものだけ
- 渡した値(ドメイン、名前、メール、URL、電話番号など)と、請求のための利用回数だけです。テーブルそのものは送信しません。
Snowflake の中に残るもの
- 結果はアプリ内に
- 結果テーブルはあなたのアカウント内の
TOMBA.RESULTSに保存されます。保存や共有をするには、自分のデータベースにコピーしてください。 - どのロールも読めない認証情報
- アプリは認証情報をプライベートスキーマに保管します。あなたが保管する API キーはありません。
- 2 つのアプリロール
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 for snowflake
Snowflake Marketplace で近日公開
アプリの仕組みをプロシージャごとにご覧いただくか、Snowflake アカウントについてお問い合わせください。