ベータHubSpotのデータをAmazon S3に同期する

Amazon S3 連携機能を使用して、HubSpot CRM のデータを、ご自身が所有する Amazon S3 バケットに同期します。HubSpot 内から、同期するオブジェクト、関連付け、イベントを選択したり、定期的な同期スケジュールを設定したり、同期状況を監視したりすることができます。

同期を行うたびに、選択されたデータの完全なスナップショットがParquet形式でAmazon S3バケットにエクスポートされます。同期されたデータは、AWS Glue、Amazon Athena、Amazon EMR、Spark、Databricks、Pythonノートブックなどの分析ツールやデータ処理ツールで利用できます。

ご注意： Amazon S3 との連携機能は、を利用している新規の Amazon S3 ユーザーのみが利用可能です。を利用しているユーザーは、の旧式の Amazon S3 連携機能をご利用ください。のスーパー管理者（）の方は、の新しいAmazon S3連携ベータ版（）にアカウントを登録することができます。

始める前に

Amazon S3 へのデータ同期を開始する前に、以下の要件と制限事項を確認してください。

要件を理解する

• のスーパー管理者の方は、のAmazon S3連携ベータ版にアカウントを登録してください。
• にアクセスし、HubSpot アカウントに関連付けられた AWS Identity and Access Management (IAM) ロールを作成する必要があります。

制限事項と考慮事項について

• ベータ版では、データはParquet形式でのみ同期されます。
• 同期を行うたびに、選択されたデータの完全なスナップショットが作成されます。
• HubSpot は同期ごとに新しいフォルダを作成し、S3 バケットから以前の同期データを削除することはありません。
• 機密データは同期の対象外です。

AWSでIAM役割を作成する

AWS Management Console で HubSpot のアクセス権限を設定するには：

1. AWS Management Console にログインします。
2. ホームダッシュボードで、[ Services] > [ Security, Identity, & Compliance] > [ IAM]をクリックします。
3. 左側のサイドバーで、「の役割」をクリックします。
4. 「」をクリックし、「」でロールを作成します。
5. 「」の「Trusted entity type」セクションで、のAWSアカウントを選択してください。
6. 「」のAWSアカウントの「」セクションで、「Another AWS account」を選択し、ご自身ののAWSアカウントID「」を入力してください。後で信頼関係を変更して、HubSpotへのアクセス権を付与します。
7. 「」を選択し、「外部IDが必要（）」にチェックを入れ、0000のようなプレースホルダーIDを入力します。後でIAM役割の信頼関係を変更し、ストレージ連携の外部IDを指定する。外部IDは、HubSpotのようなサードパーティーアプリにAWSリソースへのアクセスを許可するために使用されます。

8. ［次へ］をクリックします。
9. 「」の「Role details」セクションで、の「Role name」および「」を入力し、そのロールを識別できるようにします。
10. 「」をクリックし、「」でロールを作成します。
11. 「」の概要ページ（）で、「」のARN値（）をコピーします。この値は次のステップで使用する。

HubSpotとAWS S3を連携する

1. HubSpotアカウントにて、上部のナビゲーションバーに表示されるマーケットプレイスアイコン をクリックし、［HubSpotマーケットプレイス］を選択します。
2. 検索バーで「Amazon S3」を検索し、選択してください。
3. ［インストール］をクリックします。
4. 「」のAWS IAM「」ロールを指定し、「」をクリックして、「」をインストールします。
5. ［次へ］をクリックします。
6. 「Role ARN」フィールド（）に、AWS IAMロール「」のARN値「」を入力してください。
7. 「」をクリックし、Amazon S3（）に接続します。

バケットのアクセス権を設定する

HubSpotがフォルダーとサブフォルダー内のファイルにアクセスするには、AWS S3バケットとフォルダーに以下の権限が必要です：

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:リストバケット
• s3:PutObject
• s3:DeleteObject

アプリを連携したら、HubSpotがS3バケットにデータを同期できるよう、権限を付与してください。

1. HubSpotアカウントにて、上部のナビゲーションバーに表示される設定アイコンをクリックします。左側のサイドバーメニューで、［連携］＞［接続されたアプリ］の順に進みます。
2. をクリックしてください。Amazon S3。
3. 右側のパネルで、「」をクリックします。データを同期するAmazon S3アカウントの「」を選択します。
4. 「の権限」ページで、「」をクリックします。「」をコピーして、サンプル権限ポリシーをコピーし、先ほど作成したAWS IAMロールに紐付けます。権限ポリシーを更新する際は、ご自身のバケット名に置き換えるようご注意ください。

5. AWS Management Console にログインします。
6. ホームダッシュボードで、[ Services] > [ Security, Identity, & Compliance] > [ IAM]をクリックします。
7. 左側のサイドバーで、「」のアカウント設定（）をクリックします。
8. 「Security Token Service（STS）」のセクションで、ご自身の AWS アカウントが所在するリージョンに対応する AWS リージョンを探してください。クリックしてスイッチを切り替えるで地域をアクティブにする。
9. 左側のサイドパネルで、「ポリシー」をクリックします。
10. 「」をクリックし、「」でポリシーを作成します。
11. 「」の「JSON」タブで、「」の「Add new statement」をクリックします。
12. ステップ4でコピーしたポリシー（）を追加してください。これにより、HubSpotは単一のバケットおよびフォルダパスを使用してデータを読み込んだり書き出したりするために必要な権限を取得できます。

13. ［次へ］をクリックします。
14. 「」の「」セクションで、「」というポリシー名と、任意の「」の説明を追加します。
15. 「」をクリックし、「」でポリシーを作成します。

宛先バケットを設定する

1. HubSpotの「の権限」ページに戻り、「」フィールドに、「」というバケット名を入力します。
2. をクリックし、で接続を確認してください。

3. 接続テストが成功したら、「」をクリックし、次に「」をクリックします。

同期を設定

1. 「」のデータソース「」ページで、同期したいデータを選択します。
2. HubSpot から Amazon S3 へ同期したいオブジェクト、アソシエーション、およびイベントについて、「」のチェックボックスを選択してください。

3. ［次へ］をクリックします。
4. 「」の詳細ページ（）で、「」の「Sync frequency」（）ドロップダウンメニューをクリックし、HubSpotからAmazon S3へデータを同期させたい「」の頻度（）を選択します。

5. をクリックし、の同期を開始してください。

同期を管理する

同期を設定し、HubSpotからAmazon S3へのデータの同期が開始された後は、そのステータスを確認したり、エラーを特定したり、設定を更新したり、同期をアーカイブしたりすることができます。

同期を確認および管理するには、次の手順に従います。

1. HubSpotアカウントで、［その他］をクリックし、［データ管理］＞［データ連携］に移動します。アカウントに［その他］が表示されない場合は、［データ管理］＞［データ連携］に直接移動します。
2. 「」アプリの「」タブに移動し、テーブル内でAmazon S3の同期設定を探してください。
3. 同期ステータスを次のように確認します。

• • 同期中:同期の実行が進行中です。
  • 同期済み:前回の同期が正常に完了しました。
  • 失敗:前回の同期でエラーが発生しました。
  • アーカイブ済み:同期設定が削除されました。

4. 同期名 をクリックすると、正常に同期されたレコードや失敗したレコードなどの詳細が表示されます。

同期を編集または削除するには：

1. 表の中で、「」のAmazon S3「」同期をクリックします。
2. 右上にある [アクション ]ドロップダウンメニューをクリックし、次のいずれかを選択します。

• • 同期を編集:同期設定を更新します。
  • アーカイブ同期:同期設定を削除します。

HubSpotとAmazon S3間の同期におけるデータ形式

同期できるデータ

以下のデータをHubSpotからAWS S3に同期できます：

• オブジェクト：標準オブジェクトとカスタムオブジェクト（コンタクト、会社、チケット、製品など）。
• レコード：個々のオブジェクトレコード。
• プロパティー：オブジェクトレコードのプロパティーとそれぞれの値（プロパティー履歴を含む）。
• 関連付け：全ての関連付けタイプと、関連付けられているレコード。
• イベント：HubSpotの標準イベントおよびカスタム行動イベントのうち、指定されたもの。これには、指定されたイベントプロパティも含まれます。

各種のオブジェクトデータは、次の2つの方法で整理されて使用可能になります。

• 個別の：各オブジェクトタイプは独自のテーブルに格納され、そのテーブルには同じオブジェクトタイプのレコードのみが含まれます。たとえば、objects_contactsには、連絡先レコードのみが含まれています。
• の統合：すべてのオブジェクトタイプのレコードが、1つのデータベースオブジェクトに統合されます。したがって、クエリーを実行するときには、「WHERE objectTypeId='0-1'」のようなフィルターを指定する必要があります。

カスタムオブジェクト ` ` には、作成時に ID が割り当てられ、` 2-unique_ID ` として識別されます。例えば、2-12345。

S3のフォルダ構造

HubSpot は、正常に同期された各データを、以下の構造に従って、Amazon S3 バケット内の HubSpot が管理するプレフィックスに書き込みます。

s3://<bucket-name>/hubspot-dataout/<account-id>/<run-id>/<table-name>/<file-name>

例えば、次のような使い方が考えられます。

s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/OBJECT_WITH_OBJECT_PROPERTIES/part-000.parquet

s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/EVENTS_VISITED_PAGE/part-000.parquet

s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/ASSOCIATIONS_CONTACTS_TO_COMPANIES/part-000.parquet

同期を行うたびに、新しい「 run-id」フォルダが作成されます。HubSpotでは、過去の同期実行で取得されたデータは削除されません。

古い同期データを自動的に削除したい場合は、バケットまたはプレフィックスに対してAmazon S3のライフサイクルポリシーを設定してください。

HubSpot は同期の実行ごとにファイル名を生成するため、同期の実行ごとにファイル名が異なる場合があります。下流のプロセスを、特定のファイル名に依存するように設定しないでください。その代わりに、処理したいエクスポート実行に対応する「table-name」フォルダ内のすべてのファイルを読み込んでください。

オブジェクトファイル

オブジェクトデータを選択すると、HubSpotは以下のフォルダをエクスポートします。

オブジェクトのプロパティ

オブジェクトのプロパティ値ごとに1行ずつ。

OBJECT_WITH_OBJECT_PROPERTIES

オブジェクトレコードごとに1行ずつ表示され、選択されたプロパティ値は「PROPERTIES」という単一の列にまとめられます。

このフォルダから特定のオブジェクトタイプを読み取るには、OBJECTTYPEIDでフィルタリングしてください。

協会関連ファイル

関連データを選択すると、HubSpotは関連レコードと関連定義を同期します。

協会

2つのオブジェクトレコード間の選択された関連ごとに1行ずつ表示されます。

ASSOCIATION_DEFINITIONS

選択した関連付け定義ごとに1行ずつ。

ASSOCIATIONS_ <FROM_OBJECT_TYPE>_TO_ <TO_OBJECT_TYPE>

選択された関連付けのペアについては、HubSpotは特定の関連付けのペア（、ASSOCIATIONS_CONTACTS_TO_COMPANIES、など）に対応するフォルダも同期します。これらのフォルダには、関連付けレコードと、それに関連する定義メタデータが含まれています。

イベントファイル

イベントデータを選択すると、HubSpotはイベントタイプごとに1つのフォルダをエクスポートします。フォルダ名は、「EVENTS_ <EVENT_NAME>」という形式を採用しています。例えば、「EVENTS_VISITED_PAGE」などです。

各イベントフォルダには、標準のイベント列に加え、セットアップ時に選択された各イベントプロパティに対応する列が含まれています。