一つの接続、あらゆる表面
HubSpotのデータが保存される場所
- 1 発信接続
- 0 受信ポート
- 読み取り専用 · 認証情報はそのまま保持されます
走る
- チーム、ベンダー、パートナーの皆様へ
-
エクセル アドイン · オンデマンド更新
-
グーグル シート アドオン · オンデマンド更新
-
ノヴァAI 平易な英語で質問する · テキストからSQLへ
-
データビューア ライブ結果を共有 · チーム、ベンダー、パートナー · あらゆるデバイス
- アプリとシステム向け
-
REST API JSONエンドポイント · OpenAPI 3.1
-
Power BI Power Query M
-
スケジュールされた同期 Google Sheets · Airtable · Baserow · SeaTable · Smartsheet · Anvil
- AIツール向け
-
AIアシスタント クロード · カーソル · MCPサーバー
- 人々に届けられる
-
アラートとレポート Slack · Discord · メール · Webhook
Query Streams は、HubSpot ポータルを 31 個の SQL テーブル (連絡先、企業、取引、チケット、エンゲージメント、見積もり、請求書、リスト、およびそれらの背後にあるパイプライン定義) に変換し、Microsoft Excel、Google Sheets、Power BI、MCP 経由の AI アシスタント、および REST エンドポイントから読み取り可能にします。関連付けは独自のテーブルとして扱われるため、連絡先と企業、取引と明細項目のリンクは、手動で再構築する必要のあるエクスポートではなく、通常の JOIN で済みます。
- チーム、ベンダー、パートナーの皆様へ
-
HubSpot から Excel Microsoft Excel · Excelアドイン
HubSpotのリアルタイムの結果をワークシートに直接取り込み、必要に応じて更新できます(デスクトップ版Excel、Excel Online、Microsoft 365に対応)。
HubSpotガイド -
HubSpot から Google スプレッドシートへ Sheetsアドオン
サイドバーから保存済みのHubSpotクエリを実行し、結果をシートにドラッグ&ドロップしてください。共有されている共同作業者は、各自でシートを更新できます。
HubSpotガイド -
HubSpotについてNovaに聞いてみてください Nova AI · テキストからSQLへ
分かりやすい英語で質問してください。Novaは既にHubSpotのテーブルを把握しており、SQL文を作成して実行し、回答を説明してグラフ化します。クエリを作成する必要も、認証情報を提供する必要もありません。
Novaの仕組み -
HubSpotからデータビューアへ 結果共有 · チーム、ベンダー、パートナー · 電話、タブレット、デスクトップ
HubSpotのリアルタイム結果を、同僚、ベンダー、パートナーなど、誰とでも共有できます。共有されたグリッドはブックマーク可能で、スマートフォン、タブレット、デスクトップなど、どのデバイスで開いても常に最新の状態が表示されます。相手には結果のみが表示され、SQLや認証情報は一切表示されません。
データビューアの仕組み - アプリとシステム向け
-
HubSpot REST API HTTPエンドポイント
HubSpotクエリを認証済みのJSONエンドポイントとして公開し、OpenAPI 3.1仕様に準拠した、Postman、Insomnia、Hoppscotch用の既製コレクションをあらゆるアプリケーションから呼び出し可能にします。データベースポートは開放されません。
REST APIの仕組み -
HubSpotからPower BIへ Power Query M
生成された Power Query M を Power BI アドバンスト エディターに貼り付けると、レポートは HTTPS 経由で HubSpot のリアルタイムの結果を読み取ります。ODBC ドライバーもデータベース ポートも必要ありません。
Power BI の仕組み -
HubSpotからAirtableへ 自動化プラットフォーム
HubSpotの行をスケジュールに基づいてAirtableベースに同期したり、Airtableの自動化スクリプト内で取得したりできます。
HubSpotガイド -
HubSpotからBaserowへ 自動化プラットフォーム
HubSpotからBaserowテーブルにRESTエンドポイント経由でデータを送信します(セルフホスト型またはBaserowクラウド)。
HubSpotガイド -
HubSpotからSeaTableへ 自動化プラットフォーム
ファイルをエクスポートしたりデータベースを公開したりすることなく、SeaTableのデータベースをHubSpotのデータで常に最新の状態に保つ。
HubSpotガイド -
HubSpotからSmartsheetへ 自動化プラットフォーム
HubSpotの結果をSmartsheetのグリッドにプッシュすることで、計画やレポートが先週のエクスポートデータではなく、ソースシステムから読み込まれるようになります。
HubSpotガイド -
HubSpotからAnvilへ Anvil Works · アプリプラットフォーム
Anvil PythonアプリをHubSpotと連携させるには、アプリ内にデータベース認証情報を埋め込むのではなく、RESTエンドポイントを介して連携させます。
HubSpotガイド - AIツール向け
-
HubSpot MCPサーバー Claude、Cursor、およびMCPクライアント
AIアシスタントに、正しいSQLを作成するために必要なスキーマを含むHubSpotへの読み取り専用アクセス権を付与します。チャットに認証情報を含めないでください。
HubSpotガイド - 人々に届けられる
-
HubSpotのアラートとレポート Slack · Discord · メール · Webhook
HubSpotのクエリをスケジュール設定して、結果をSlack、Discord、メール、または署名付きWebhookに送信するか、行数、しきい値、または変化率が設定した値を超えるまでメッセージを保留することができます。
アラートとレポートの仕組み
仕組み
5つのステップ、受信ファイアウォールの変更は不要
HubSpotポータルでプライベートアプリを作成し、関心のあるオブジェクトに対して読み取り権限を付与してください。
ネットワークエージェントをインストールし、アクセストークンを貼り付けてください。トークンはそこに保存されます。HubSpotは、あなたのネットワークからのみ情報を受け取ります。
同期する31個のテーブルと同期頻度を選択してください。連絡先、企業、取引、所有者、パイプライン、パイプラインステージ、および物件はデフォルトで有効になっています。
hubspot.deals、hubspot.companies、その他に対して通常のSQL文を記述するか、Novaに自動で記述させることもできます。
Excel、Sheets、Power BI、MCP、またはRESTからデータを読み込み、同じステートメント内で独自のデータベースに結合します。
機能の詳細解説
HubSpotが提供するもの
連想は表であって、パズルではない
HubSpotのエクスポートが面倒なのは、重要な情報がオブジェクト間のリンクに含まれているのに、連絡先のCSVファイルにはそれが含まれていないからです。ここでは、各行にリンクとリンクの両方を含む独自のテーブルを用意しています。
- hubspot.associations には、from オブジェクト、to オブジェクト、関連付けタイプ、ラベルが保持されるため、取引の連絡先やチケットの会社は単純な JOIN になります。
- 企業への連絡先、取引への連絡先、取引への企業、取引から明細項目、チケットから連絡先、チケットから企業まで、すべて網羅されています。
- パイプラインとパイプラインステージも別々のテーブルになっているため、取引のステージは不透明なIDではなく、名前と注文に解決されます。
31のテーブル
- CRMオブジェクト — 連絡先、企業、取引、チケット、所有者、パイプライン、パイプラインステージ、製品、明細項目。
- 婚約 — 電話、メール、会議、メモ、タスク、コミュニケーション。
- 商取引 — 見積書、請求書、購読料、支払い、税金、割引、手数料。
- マーケティング — マーケティングイベント、フォーム、フォーム送信、フィードバック送信。
- リストと自動化 — リスト、ワークフロー。
- 定義 — プロパティ、スキーマ、関連付け。
カスタムプロパティが実際に存在する場所
これは、多くの人が異なる動作を想定する唯一の点であるため、正確に説明しておく価値があります。各オブジェクトテーブルには、固定された一連の名前付き列(標準フィールド)があり、HubSpotが返すその他のすべてのデータ(カスタムプロパティを含む)は、同じ行のraw_data JSON列に保持されます。
- 何も破棄されません。カスタムプロパティはクエリ可能ですが、独立した列としてではなく、JSON列を介してクエリされます。
- hubspot.propertiesには、15種類のオブジェクトタイプにわたるすべてのプロパティ定義が一覧表示されます。 —名前、ラベル、タイプ、フィールドタイプ—など、何が存在し、それが何と呼ばれているかを調べることができます。
- hubspot.schemasにはカスタムオブジェクト定義が格納されます。カスタムオブジェクトレコードは、独自のテーブルとして同期されません。
- カスタムプロパティをスプレッドシートの第一級列として読み込ませたい場合は、保存済みクエリからそのプロパティを抽出してください。一度式を記述すれば、そのクエリを使用するすべてのユーザーが適切な列として認識できるようになります。
すべてのAPIコネクタで共有されます
各APIコネクタの仕組み
- あなたのアカウントはテーブルになります エンドポイントは、主キーとインデックスを持つ型付きSQLテーブルにマッピングされるため、JSONをページングする代わりに、SELECT、JOIN、GROUP BYを記述します。
- 同期する項目と頻度は自分で選択できます。 各テーブルにはそれぞれ独自の間隔が設定されている場合と、間隔が設定されていない場合がある。ベンダーのAPIが対応している場合は、前回の実行以降に変更されたレコードのみが取得される。
- コピーはあなたのものです — それは、お客様のマシン上のエージェントと同じ場所にある、AES-256-GCMで暗号化されたDuckDBファイル内に存在します。当社のクラウド上にはありません。
- ベンダーはあなたからしか連絡を受けない エージェントはユーザー自身のネットワークから直接APIを呼び出すため、クエリストリームがクエリに応答する際にトークンは必要ありません。
知っておくと良い
- これは同期されたコピーであり、ライブプロキシではありません。 クエリは既に取得済みのデータを読み取るため、SQLの速度で処理が進み、APIのレート制限を消費することはありません。選択したテーブルでは、読み取り時に古い行を更新することも可能です。
- レート制限は尊重されます 各コネクタはベンダーが公表している制限値を十分に下回るペースで動作するため、レポートによって、そのコネクタを使用する他のすべてのアカウントが制限されることはありません。
- 何も捨てられない テーブルに名前が付けられていないフィールドは、クエリ可能なraw_data JSON列に保持されます。
- データベースに結合してください — 同じステートメント内で API テーブルと SQL Server テーブルを使用することは、ここでは通常のクエリであり、統合プロジェクトではありません。
クロスソースSQL
HubSpotを他のデータと連携させる
CRMは顧客が誰であるかを把握しており、決済処理業者は顧客がいくら支払ったかを把握しています。しかし、どちらも両方を把握しているわけではなく、四半期末に求められる数値には、両方の情報が同じ行に含まれている必要があります。各ソースは実行可能な部分のみを実行し、結果をストリームで送信します。結合処理は中央で行われ、ソース同士が直接やり取りしたり、データがどこかにコピーされたりすることはありません。
接続数3件・エージェント数3名
一つの声明
-- HubSpotのアカウント、顧客情報、Stripeの請求書
セレクト h.industry、COUNT(DISTINCT h.id) AS accounts、SUM(i.amount_due) / 100 AS invoiced
フロム CRM.hubspot.companies1 h
ジョイン pg_crm.一般顧客2 c ON c.domain = h.domain
ジョイン 請求する.stripe.invoices3 i ON i.customer = c.stripe_id
GROUP BY h.産業
ORDER BY 請求書記載のDESC;
3 つの部分は、接続、スキーマ、テーブルです。接続名は、あなたが付けた名前です。例示用の列です。テーブルは、あなたのテーブルになります。HubSpot の取引には顧客参照がないため、結合は会社のドメインで実行されます。オブジェクト間のリンクは、関連付けテーブルの行であり、アカウントではなく取引が必要な場合は、この行もクエリできます。Stripe は最小通貨単位で金額を報告するため、分割されています。読み取り専用はすべての部分に適用されます。SELECT、WITH、EXPLAIN のみで、1 つのソースが単一のクエリで渡せる金額には上限があります。 フェデレーションクエリの仕組み
接続の詳細
HubSpotが必要としているもの
- 認証
- エージェントに保持されるプライベートなアプリアクセストークン。維持する必要のあるOAuthの往復通信ではありません。
- 手を伸ばして
- あなたのネットワークからHubSpotへのHTTPS接続。受信接続はありません。
- スキーマ
- hubspot — つまり、hubspot.deals、hubspot.contacts、hubspot.associations
- 表
- 31項目のうち、デフォルトで有効になっている項目は、連絡先、企業、取引、所有者、パイプライン、パイプラインステージ、およびプロパティの7項目です。
- カスタムプロパティ
- オブジェクト行の raw_data JSON 列に格納され、定義は hubspot.properties に記載されています。これらは列として追加されません。
- 増分
- HubSpotのCRM検索で最終更新日を検索するため、既存レコードへの編集が反映されます。
- ライブ更新
- CRMオブジェクトテーブルのうち20種類で利用可能。1つのレコードをキーとしたクエリを実行すると、回答前にHubSpotと照合されます。
- レート制限
- HubSpotが公開している制限の範囲内で処理されるため、レポートによって他のユーザーのポータルへのアクセスが制限されることはありません。
- ローカルコピー
- エージェントと同じマシン上に、AES-256-GCMで暗号化されたDuckDBファイルがあります。
読み取り専用は構造的なものです。コネクタはHubSpotの書き込み呼び出しを一切実装していません。すべてのリクエストは読み取り、検索、またはバッチ読み取りです。そのため、トークンのスコープが何であっても、クエリによって取引ステージを変更したり、連絡先にアクセスしたりすることはできません。それでも、プライベートアプリのスコープを読み取り専用に設定する価値はあります。
関連付けの同期は、各タイプのすべてのオブジェクトを走査し、リンクをバッチ処理で読み込むため、ここで最も負荷の高いテーブルです。リンクを最新の状態に維持する必要がない限り、オブジェクトテーブルよりも長い間隔を設定してください。
ベンダー資料: www.hubspot.com
よくある質問
HubSpotに関する質問
HubSpotのクエリストリームを介してデータを読み取ることができるツールはどれですか?
Excel、Google Sheets、MCP、REST API、Airtable、Baserow、SeaTable、Smartsheet、Anvil、Power BI、スケジュールされたアラートやレポートなど、すべてを1つの接続で利用できます。アカウントを一度接続すれば、すべてのインターフェースが同じ読み取り専用接続を読み取ることができます。ツールごとの設定やデータの複製は一切不要です。
HubSpotアカウントへのファイアウォールポートを開放する必要がありますか?
いいえ。Query Streams Network Agentはネットワーク内で動作し、暗号化された単一の送信接続を開きます。受信トラフィックを監視するものはなく、VPNも不要で、アカウントは既存のファイアウォールルールを維持します。
クエリ ストリームは HubSpot のデータを変更することができますか?
いいえ。エージェントは実行時に読み取り専用を強制します。つまり、一度に1つのステートメント(SELECT文など)のみを実行します。認証情報はエージェント上に保持され、クエリ ストリームに送信されることはありません。
Query StreamsがHubSpotに接続するために必要なものは何ですか?
到達可能なホスト、ロール、およびそのパスワード - エージェントがドライバーを保持するため、アカウントには何もインストールされません。認証: エージェントに保持されるプライベート アプリ アクセス トークン。維持する必要のある OAuth ラウンド トリップではありません。アクセス: ネットワークから HubSpot への HTTPS。受信はありません。スキーマ: hubspot - hubspot.deals、hubspot.contacts、hubspot.associations。テーブル: 31 個。デフォルトで有効になっているのは、contacts、companys、deals、owners、pipelines、pipelines_stages、properties の 7 個です。
HubSpotを別のデータベースに同じクエリで結合することはできますか?
はい、それはフェデレーションクエリです。1つのステートメントでHubSpotと他の接続を同時に参照でき、connection.schema.tableの形式で記述されます。各ソースは実行可能な部分のみを実行し、結果をストリームで返します。結合は中央で行われるため、ソース同士が接続されることはなく、何もコピーまたはスケジュールされません。読み取り専用はすべての部分(SELECT、WITH、EXPLAINのみ)に適用され、1つのクエリで1つのソースが渡せるデータ量には上限があります。フェデレーションクエリはプラン機能であり、フェデレーションクエリのページには現在のソースとサイズの制限が表示されます。

