SnowflakeでHubSpotデータを照会する

SnowflakeをH ubSpot アカウントに接続した後、SnowflakeのData Shareを使用して、SnowflakeアカウントからHubSpotのデータを照会することができます。

データラグとSnowflakeのアカウントリージョン

15分ごとに更新されるV2_LIVEスキーマと、毎日更新されるV2_DAILYスキーマにアクセスすることができます。

注： V2_LIVEスキーマの以下の表示条件は、毎日更新されます： association_definitions、owners、pipelines、pipeline_stages。

Snowflake環境を設定する

SnowflakeでHubSpotデータを照会するには、照会元のウェアハウス、データベース、スキーマを選択する必要があります。ワークシートレベルでこれらを設定して自動的にクエリーに含めるか、または手動で追加することができます。

ワークシートレベルでウェアハウス、データベース、スキーマを選択するには、次の手順に従います。

• ワークシートの一番上の行で、［Worksheet actions］バーをクリックします。
  
  
• ポップアップウィンドウで、次の操作を行います。
  • ［Warehouse］ドロップダウンメニューをクリックして、ウェアハウスを選択します。
  • ［Database］ドロップダウンメニューをクリックして、HubSpotデータベースを選択します。
  • ［Schema］ドロップダウンメニューをクリックして、使用するスキーマを選択します。
    • V2_DAILY: テーブルに基づいたデータを照会するための日次スキーマ。このスキーマのデータは1日1回更新されます。このスキーマを使用すると、クエリーが高速になります。Snowflakeで直接照会する場合に推奨されます。
    • V2_LIVE： HubSpotデータのSecure Viewsに基づくライブスキーマです。このスキーマのデータは最大で15分ごとに更新されます。大規模なデータセットを照会する場合、クエリーに時間がかかることがあります。このような場合は、まずETLプロセスで自分のテーブルにデータをコピーし、そのテーブルを照会することをお勧めします。
    
    
    

設定された環境では、HubSpotデータを照会するときに、データベースやスキーマタイプを手動でクエリーに追加する必要がありません。

データベースとスキーマの種類を手動でクエリーに追加するには、データベース名の後にスキーマを追加して、クエリーの先頭に追加します。FROMのフィールドを使用します。例として、以下のような場合が挙げられます。

データの概要

クエリーはSQLで構築され、以下のようなHubSpotのデータを取得することが可能です：

• オブジェクト：コンタクト、会社、製品など、標準およびカスタムのオブジェクト。 
• レコード：個々のコンタクトや会社など、個々の記録。 
• 関連付け：利用可能なすべての関連付けの種類と現在関連付けられているレコード。
• Eメール： Eメールの開封などHubSpotの標準的なイベントと、カスタムの行動イベントの両方のイベントデータです。
• リストです： HubSpotのコンタクトリストと会社リストです。
• 所有者：レコードの所有者として設定されているHubSpotアカウントのユーザー。
• パイプライン：取引パイプラインとチケットパイプライン（パイプラインステージを含む）。
• プロパティー：プロパティーの履歴を含む、CRMレコードのプロパティーとその値。

HubSpotのCRMデータモデルについて詳細をご確認ください。

注：データシェアを進化させるにあたり、変更点を導入し、中には破壊的な変更もあります。HubSpot の開発者向け変更ログを配信(サブスクリプション)することを強くお勧めします。これらの変更は、アップデートの前に必ず変更履歴に掲載されます。

返されるデータの制限と順序の設定

クエリーを作成するときに、返されるデータの量と、データが返される順序を制御できます。このためにはLIMITとORDER BYをクエリーに追加します。例えば、すべてのコンタクトとそのプロパティーを照会するが、3件の結果だけをコンタクトIDの順で返すには、クエリーを次のように作成します。

列のデータ型

Snowflakeでデータを照会する場合、返される列は、照会するデータによって異なります。Snowflakeで、指定したテーブルまたはビューで利用可能な列を確認するには、左側のサイドバーでビューを選択します。

ご注意ください。このドキュメントの残りの部分では、テーブルとビューの両方に適用されるコンテキストでは、データベースオブジェクトという語句を使用します。

特定の列を返すには、その列をSELECTのフィールドで、クエリーを実行します。例えば、次のようなクエリーでは、以下のようなものだけが返されます。OBJECTIDとUpdatedAtの欄があります：


SELECTobjectId, updatedAt
FROM objects_contacts



以下に、クエリーが返す可能性のある列の一般的な定義を示します。以下に記載されていないその他の定義については、上記の各ビューの定義を参照してください。

• OBJECTTYPEID:オブジェクトのタイプを表すVARCHAR値。例えば、「0-1」はコンタクトオブジェクト、「0-2」は会社オブジェクト、「2-1232」はアカウントのカスタムオブジェクトを表します。リストでは、リストのタイプ（コンタクトや会社など）を指します。object_and_event_type_definitionsビューを使って、アカウント内のすべてのオブジェクトとイベントのIDを照会できます。
• OBJECTID： HubSpotアカウント内の所定のタイプのオブジェクトの単一レコードを表すBIGINT番号です。レコードを識別するには、オブジェクトタイプIDとオブジェクトIDの両方を使用する必要があります。
• INGESTEDAT：データ行がSnowflakeに追加された時のタイムスタンプで、TIMESTAMP_NTZ値で表されます。HubSpotでの作成操作または更新操作の論理タイムスタンプとは関係ありません。
  • HubSpotの内部処理により、行の他の列が変更されていなくても、行のインジェスチョンタイムスタンプが更新されることがあります。
  • 最近変更されたデータをコピーするETLプロセスを作成するときには、インジェスチョンタイムスタンプに基づいてクエリーを作成することをお勧めします。また、フローで毎日データをコピーする場合は、遅延を考慮して過去2日間のデータをコピーすることをお勧めします。
• CREATEDATとUPDATEDAT：データがHubSpotで作成または更新されたときの論理的なタイムスタンプで、TIMESTAMP_NTZ 値で表わされます。これらのタイムスタンプは、HubSpotのタイムスタンプと一致します。例えば、HubSpotでレコード作成日に表示される時刻は、Snowflakeの「CREATEDAT」列のタイムスタンプと同じになります。これらはインジェストのタイムスタンプとは直接関係がなく、これらのプロパティーに基づいてETL処理を行うことは推奨されない。
• COMBINEDASSOCIATIONTYPE：関連付けの定義を一意に識別するVARCHAR値です。

データ型を変換する

VARCHAR列を持つクエリーから、別の型にした方が望ましいデータが返ってくることがあります。このような場合、Snowflakeの関数を使用してVARCHARデータ型を目的の型に変換することをお勧めします。例えば、オブジェクトレコードのプロパティーは、ほとんどのデータベースオブジェクトではVARCHARデータ型として格納されるが、時には数値やdatetime値を含むこともある。
try_to_number , try_to_timestamp_ntzなどの関数で、VARCHAR データをそれぞれNUMBER型、DATETIME型に変換することができる：


SELECT objectid, value AS amount_str, try_to_number(value) AS amount
FROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1



オブジェクトのクエリー

以下では、特定のHubSpotオブジェクトやレコードのデータを照会する方法と、返されるデータを説明します。 

さまざまな種類のオブジェクトデータは、2つの方法で整理され、利用することができます。 

• 個別です。各オブジェクトタイプは独自のビューに格納され、同じオブジェクトタイプのレコードのみを含みます。例えば、objects_contactsはコンタクトレコードのみを含みます。これにより、問い合わせの際にobjecttypeidを指定する必要がなくなる。これらのビューは、ObjectTypeIds を知る必要がないため、クエリーが簡単です。また、各行がオブジェクトとそのプロパティーの現在のバージョンに対応する、より使いやすいフォーマットでデータを返します。クエリーが遅くならない限り、これらのビューを使用してオブジェクトデータを取得することが推奨されます。詳しくは下記のObjects_X viewsでご覧ください。 
• 結合される。すべてのオブジェクトタイプのすべてのレコードが1つのデータベースオブジェクトに結合されます。したがって、問い合わせの際には、「WHERE objectTypeId='0-1'」のようなフィルターを指定する必要があります。例えば、問い合わせの際に以下のようなobjecttypeidを使用することができる。

カスタムオブジェクトには、作成時にIDが割り当てられ、「2-unique_ID」として識別されます。例えば「2-12345」などです。object_and_event_type_definitionsについて詳細をご確認ください。

これらのデータベースオブジェクトは、objects_xビューから得られるものより優れたクエリパフォーマンスが必要な場合に一般的に適しています。詳細は、下記のobject_with_object_properties、object_properties、object_properties_historyをご覧ください。

objects_x views

このデータベースオブジェクトでは、カスタムオブジェクトを含む利用可能な各オブジェクトタイプは、特定のビューを持ち、各ビューにはその特定のオブジェクトタイプのオブジェクトのレコードのみが含まれます。これらのビューは、OBJECTS_ <object type name>というフォーマットに従って命名されます。<object type name>は、オブジェクトタイプの複数形ラベルです（オブジェクトタイプに複数形がない場合、<object type name>は、オブジェクトタイプ名の単数形ラベルに "S" を結合しただけのものになります）。

このビューに対するクエリは、オブジェクト内の各レコードに対して1行を返し、オブジェクトの各プロパティーは個別の列として利用できます。

HubSpot（つまり非カスタム）のオブジェクトタイプの一覧と、それらが表すデータの簡単な説明、および対応するビューは以下のとおりです。

各データベースオブジェクトは、以下の列を返す。

例1

全てのコンタクトの名、姓、ライフサイクルステージを取得します。

クエリーを実行します。


SELECT objectId, property_firstname AS firstname, property_lastname AS lastname,property_lifecyclestage AS lifecyclestage
FROM objects_contact



リターンです。

例2

最大3つの案件の案件名とステージを取得します。

クエリーを実行します。


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

戻り値：

例3

金額上位3件の案件名とステージを取得する。

クエリー：

取引金額データは数値データ型として利用できるため、変換やキャストを行うことなく、順序付けに利用することができる。


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3




戻り値：

object_with_object_properties

このデータベースオブジェクトには、HubSpotのレコードのデータが含まれています。このデータベースオブジェクトへの問い合わせは、オブジェクトタイプ内の各レコードに対して1行を返します（例：contactsオブジェクトタイプ内の全てのcontactレコード）。全てのプロパティーは、Snowflake Variant / JSON列であるProperties列に格納されます。 

このビューでは、以下の列が返されます。

ご注意：2022年1月25日、object_with_object_propertiesテーブルおよびビューのtimestampという列は、HubSpotでオブジェクトレコードが最後に更新された日時を表し、updateatになります。これは、残りのデータ共有で、datetime データがどのように表現されているかを合わせるためです。

これは画期的な変更であるため、新しい列 updatedatがテーブルとビューに追加されまし た。今後90日間、この2つの新しい列は、置き換えようとしている列であるtimestampと共存することになる。

90日後の2022年1月25日に、テーブルとビューから列のタイムスタンプが削除されます。この日付以降、タイムスタンプ列を使用してobject_with_object_propertiesテーブルまたはビューを照会しようとすると、失敗します。

例1

すべてのコンタクトとそのプロパティーを取得します。

クエリー：

戻り値：

例2

最大3つの取引の取引名とステージを取得します。

クエリー：

戻り値：

objects

このデータベースオブジェクトは、object_with_object_properties データベースオブジェクトのデータのサブセットである。返される各行には、各レコードのオブジェクトIDが含まれています。このデータベースオブジェクトは、既存のレコードのみを返します。HubSpotでレコードが削除されると、このデータベースオブジェクトから削除されます。このデータベースオブジェクトは、object_with_object_propertiesテーブルのデータのサブセットである。返される各行には、各レコードのオブジェクトIDが含まれています。このビューでは、既存のレコードのみが返されます。HubSpotでレコードが削除されると、そのレコードはこのビューから除去されます。 

このデータベースオブジェクトは、アカウントに大量のデータがあり、object_with_object_propertiesやobject_xビューのパフォーマンスが低下している場合に有効でしょう。このデータベース・オブジェクトを object_properties データベース・オブジェクトと一緒に使うことで、 object_with_object_properties のデータを複製しつつ、どのプロパティーが返されるかを 制御することが可能になります。

このデータベースオブジェクトは、以下の列を返すことができる。

例1

すべてのコンタクトレコードを取得します。

クエリー：

戻り値：

object_properties

このデータベースオブジェクトはobject_with_object_propertiesデータベースオブジェクトのサブセットである。各行には、与えられたレコードに設定されている現在のプロパティー値が含まれています。例えば、コンタクトの場合は「First name」プロパティーと「Last name」プロパティーに対してそれぞれ1行ずつがあります。レコードがプロパティーの値を持っていない場合、その行は空の文字列で表示されるか、まったく表示されません。

このデータベースオブジェクトは、以下の列を返すことができる。

例1

すべてのコンタクトの名前、姓、市町村のプロパティーを取得します。

クエリー：

戻り値：

例2

すべてのコンタクトの名前、姓、ライフサイクルステージを取得し、結合してコンタクトごとに1行にまとめます。この例では、SQLのPIVOT構文を使用しています。

クエリー：

戻り値：

object_properties_history

このデータベースオブジェクトは、過去のプロパティー値を含む。コンタクトの場合、最新の45個の値が含まれています。その他のすべてのオブジェクトでは、最新の20個の値が含まれています。過去のプロパティー値ごとに1行ずつ表示されます。プロパティーの現在の値は、プロパティーの履歴における最新の「UPDATEDAT」タイムスタンプによって決まります。

このデータベースオブジェクトは、以下の列を返すことができる。

例1

1つのコンタクトの1つのプロパティーの履歴を取得します。

クエリー：

 
戻り値：

例2

ライフサイクルステージが「登録読者」であったことがあるすべてのコンタクトの現在の名前を取得します。

クエリー：

戻り値：

関連付けのクエリー

オブジェクトデータと同様に、関連付けデータも2つの方法で整理される。

• 個別です。各関連付けタイプは独自のビューに保存され、そのタイプのレコードのみが含まれます。例えば、associations_contacts_to_dealsには、コンタクトオブジェクトと取引オブジェクトの間の関連レコードのみが格納されます。これにより、問い合わせの際にassociationtypeidを指定する必要がなくなります。これらのビューは、CRMのデータモデルに精通している必要がないため、問い合わせが非常に簡単です。また、objects_xビューとの結合で簡単に使用できるように、2つのオブジェクト間の関連レコードの拡張された説明を返します。クエリーが遅くならない限り、これらのビューを使用して関連データを取得することをお勧めします。詳しくは下記のassociations_x_to_y viewsをご覧ください。 
• 結合される。すべての関連付けタイプのすべてのレコードが1つのデータベースオブジェクトに結合されます。したがって、問い合わせの際には、「WHERE combinedassociationtypeid='0-32' 」のようなフィルターを指定する必要があるのです。詳しくは、下記のassociationとassociation_definitionsをご覧ください。

associations_x_to_y views

各関連付けのタイプは、associations_ <association type name>（例：associations_contacts_to_deals）とラベル付けされた独自のビューを持っています。各ビューは、associationデータベースオブジェクトのデータのサブセットであり、特定のcombinedassociationtypeidのレコードのみを含んでいます。

各データベースオブジェクトは、以下の列を返す。

例1

特定のコンタクトに関連付けされたすべての取引を取得します。

クエリー：

リターンです。

例2

ボゴタのタイムゾーンにある全てのコンタクトとその案件を取得します。

例3

全コンタクトと各コンタクトの成約金額の合計を取得します。

戻り値：

association_definitions

このデータベースオブジェクトには、HubSpotオブジェクト間で利用可能なすべての関連タイプに関する情報が含まれており、関連タイプごとに1行ずつあります。このデータベースオブジェクトとassociationsデータベースオブジェクトを結合して、レコード固有の関連情報を取得することができます。

同じオブジェクトの間に複数のタイプの関連付けを設定できます。メインの関連付けタイプは、レコードが関連付けされたときにHubSpotに表示されるタイプで、以下のような関連付けを使用します。ISMAINASSOCIATIONDEFINITIONですtrue .

このデータベースオブジェクトは、以下の列を返すことができる。

例1 

アカウントで利用可能な関連付けのタイプを取得します。

クエリー：

 
戻り値：

例2

取引と会社の間で利用可能な関連付けタイプを取得します。

クエリー：

戻り値：

associations

このデータベースオブジェクトは、特定のレコード間の関連付けに関する情報を含んでいます。各行は、オブジェクト間の関連付けを表します。参照されたレコードが削除されても、このデータベースオブジェクトに行が存在する場合があります。レコードが存在しているかどうかは、objectsテーブルと結合することで確認できます。

このデータベースオブジェクトは、アカウントに大量のデータがあり、associations_x_to_yビューのパフォーマンスが低下している場合に有効です。

このデータベースオブジェクトは、以下の列を返すことができる。

例1

関連付けられている取引とコンタクトをすべて取得します。

クエリー：

 
戻り値：

例2 

特定のコンタクト（コンタクトID：「3005」）に関連付けられているチケットをすべて取得します。

クエリー：

戻り値：

例3 

特定のコンタクト（コンタクトID：「4464」）に関連付けられている取引をすべて取得します。この例では「combinedAssociationTypeId」をハードコーディングする代わりに、association_definitionsと結合しています。

クエリー：

戻り値：

担当者からの問い合わせ

owners

このデータベースオブジェクトには、HubSpot アカウントのユーザーに関する情報が含まれています。ユーザーはレコード所有者として設定できます。ユーザーには、そのコンテキストに応じてユーザーIDと所有者IDの両方が含まれます。どちらのIDも同じユーザーを識別するために使用できます。 

このデータベースオブジェクトは、以下の列を返すことができる。

例1 

すべてのユーザーを取得します。のことです。WHERE archived = falseフィルターは、返されたデータから削除されたユーザーを削除します。

クエリー：

 
戻り値：

例2

所有者IDで特定の所有者を取得します。

クエリー：

戻り値：

例3

すべてのコンタクトとその担当者を取得します。このクエリーは、object_with_object_propertiesとコンタクトプロパティー「hubspot_owner_id」を使用して担当者にレコードを結合します。

戻り値：

チームへの問い合わせ

チーム

HubSpotのチームを使用して、組織の目的やレポートの目的に合わせてユーザーをグループに分けることができます。メインチームと追加チームを設定できます。

このデータベースオブジェクトには、HubSpotアカウントのチームに関する情報が含まれています。 

このデータベースオブジェクトは、以下の列を返すことができる。

例1

全てのチームを取得します。

クエリー：

戻り値：

owner_team

このデータベースオブジェクトには、担当者とHubSpotアカウントのチームの対応付けに関する情報が含まれています。 

このデータベースオブジェクトは、以下の列を返すことができる。

例1

指定したチームのすべての担当者を取得します。

クエリー：

SELECT teamId, ownerId, isTeamPrimary
FROM teams
WHERE teamId = 29584574

返されるデータ

パイプラインのクエリー

以下では、取引とチケットのパイプラインのデータ（アカウントで利用可能なパイプラインとそのステージなど）を照会する方法を説明します。

このデータをオブジェクトデータと結合することで、パイプラインの全体像を把握できます。例えば、objects_deals_view やobject_with_object_propertiesデータとpipelinesデータを結合することで、取引とそのパイプラインを照会することができます。

pipelines

このデータベースオブジェクトは、アカウント内の取引およびチケットパイプラインに関する情報を含んでいます。返される各行はそれぞれ1つのパイプラインを表しています。

このテーブルでは、以下の列が返されます。

例1

利用可能なすべての取引パイプラインを、HubSpotでの順序で取得します。

クエリー：

 
戻り値：

例2

特定のパイプライン内の取引を取得します。object_with_object_propertiesとpipelinesを結合します。

クエリー：

戻り値：

例3

上記例2と同様に、特定のパイプライン内の案件を取得する。しかし、joinでobjects_dealsを使用する代わりに、object_with_object_propertiesを使用する。

戻り値： 

pipeline_stages

このビューには、パイプライン内の個々のステージに関する情報が含まれています。オブジェクトタイプID、パイプラインID、ステージIDの組み合わせによりステージを識別します。pipelinesとの結合には、オブジェクトタイプIDとパイプラインIDを使用します。

このデータベースオブジェクトは、以下の列を返すことができる。

例1 

「Sales pipeline」という名前の取引パイプラインのパイプラインステージを取得します。

クエリー：

 
戻り値：

例2

すべての取引とそれぞれのパイプラインステージを取得します。

クエリー：

戻り値：

プロパティーに関するお問い合わせ

property_definitions

このデータベースオブジェクトには、HubSpotアカウントのオブジェクトプロパティーとイベントプロパティーに関する情報が含まれています。イベントプロパティーには、メールの開封やクリックなどの標準イベントと、カスタム行動イベントのプロパティーがあります。この情報は、object_propertiesおよびeventsのデータにある値を定義する際に役立ちます。

オブジェクトタイプIDと名前を組み合わせることで、特定のプロパティーを識別できます。同様の情報をproperties APIで取得できます。

このデータベースオブジェクトは、以下の列を返すことができる。

例1

すべてのコンタクトプロパティーの名前と説明を取得します。

クエリー：

 
戻り値：

イベントクエリー

イベントには、標準的なHubSpotイベントとカスタム行動イベントがあります。各イベントには、それぞれデータベース・オブジェクトがあり、ラベルは次のようになっています。events_eventname .

イベントタイプIDとIDを組み合わせることで、イベントを識別できます。返される列はイベントによって異なります。イベントのプロパティーごとに1つの列が返されます。すべてのイベントで返される列を以下に示します。

例1

最新の50件のEメールのクリックイベントを取得します。

クエリー：

戻り値：

例2

クリックしたコンタクトのEメールのクリックイベントをすべて取得します。このクエリーは、object_with_object_propertiesと結合することでコンタクトデータを取得します。

クエリー：

戻り値：

オブジェクトとイベントタイプのクエリ

object_and_event_type_definitions

このデータベースオブジェクトには、HubSpotアカウントで利用可能なすべてのオブジェクトとイベントの定義が含まれています。

このデータベースオブジェクトは、以下の列を返すことができる。

例1

HubSpotアカウントで利用可能なすべてのオブジェクトとイベントを取得します。

クエリー：

 
戻り値：

リストクエリ

以下では、利用可能なコンタクトリストと会社リスト、それらのリストに含まれるレコードなど、リストを照会する方法について説明します。

lists

このデータベースオブジェクトには、HubSpotのコンタクトおよび会社リストに関する情報が含まれています。1つのリストにつき1つの行を返します。列にはリストの詳細（リストの名前、サイズ、含まれるレコードのオブジェクトタイプなど）が含まれます。各リスト内の個々のレコードに関する情報は含まれません（list_membershipを参照）。 

このデータベースオブジェクトは、以下の列を返すことができる。

例1

すべてのコンタクトリストを取得します。

クエリー：

 
戻り値：

例2

「Top subscribers 2021」という名前の特定のコンタクトリストを取得します。 

クエリー：

戻り値：

list_membership

このデータベースオブジェクトは、どのレコードがどのリストのメンバーであるかの情報を持ち、リスト内のレコードごとに1行が存在する。例えば、500人のコンタクトを持つ「ブログ」登録読者リストがある場合、データベースオブジェクトは500行を返します。 

含まれるのはリストIDとオブジェクトIDのみです。詳しくは、listsデータベース・オブジェクトと結合してください。

このデータベースオブジェクトは、以下の列を返すことができる。

例1

「Top subscribers 2021」リストに含まれているすべてのコンタクトのIDを取得します。

クエリー：

 
戻り値：

例2

Top subscribers 2021リストに登録されているコンタクトの詳細の姓と名を取得します。

クエリー：

戻り値：

よくある質問

HubSpotアプリからレポートと同様のデータを作成したいのですが、どのようにすればよいですか？

一般的には、比較対象のレポートに存在する列を確認することになるでしょう。レポートのグラフ化が表形式でない場合、表に変換すると、レポートに含まれる列が表示されます。これらの列は通常、オブジェクト・タイプまたはイベント・タイプのプロパティーである。次のステップは、列が対応するオブジェクトタイプのプロパティーを把握することです。property_definitionsに問い合わせることで可能です。

一部のプロパティー名は、通常、アプリ上でより説明的な名前に解決されるため、必ずしも完全に一致しない場合があります。このような場合、property_definitionsのlabel（あるいはdescription）列でLIKE演算子を使ったあいまい検索が有効です。

列がどのオブジェクトタイプに属するかを決定した後、何を問い合わせるかを決定するのは簡単なことです。その型に対応するobject_xビューを検索すればよいのです。

このデータ型を別のデータ型にリンクさせるにはどうすればよいですか（例：キャンペーン用のフォームを取得する方法）？

2つ以上の異なるレコードを互いにリンクさせる必要がある場合は、関連付けをご覧ください。関連付けは、HubSpotのCRM上のさまざまなオブジェクトの間の関係を表します。2つの型の間で可能なすべての異なる関連付けはassociation_definitionsにリストされている。上記の例では、キャンペーンがリンクされている全てのフォームを知るために、ASSOCIATIONS_CAMPAIGNS_TO_FORMSをクエリーする必要があります。

HubSpotとSnowflakeの連携状況を知るにはどうすればよいですか？

HubSpotとSnowflakeの連携の障害や問題についてのリアルタイムのステータスアップデートを受け取るには、data_share_statusビューにクエリーします：

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

と表示されます：

このビューでは、連携ステータスの更新を逆時系列で提供します。このクエリーの結果をダッシュボードに連携することで、連携のパフォーマンスを追跡し、ダウンタイムや停止を検出することができます。