更新日時 2026年9月5日
サマリー
HubSpot CRMのオブジェクト、関連付け、およびイベントをAmazon Redshiftにエクスポートします。HubSpot MarketplaceのAmazon Redshiftアプリを使用して。HubSpot から、エクスポートするデータの選択、同期スケジュールの設定、および同期アクティビティーを確認することができます。
この記事では、アプリのインストールと接続方法、データエクスポートの同期設定、および同期の監視や管理方法について解説します。
ご注意：もしあなたがスーパー管理者の場合は、アカウントを「Amazon Redshift 連携機能の改良版（ベータ版）」に参加することができます。
始める前に
要件を理解する
あらかじめ以下の4つを準備しておきましょう。
- HubSpotアカウントに連携され、AWSアカウントにアクセスできるよう設定されたAWS Identity and Access Management（IAM）ロール。
- HubSpot からアクセス可能な、Amazon Redshift によってプロビジョニングされたクラスターまたはサーバーレスワークグループ。
- 一時的なParquetファイルを格納するためのAmazon S3バケット。バケットは、Redshiftクラスターまたはサーバーレスワークグループと同じAWSリージョンにある必要があります。
- HubSpot は、一時的な Parquet ファイルを設定済みの Amazon S3 ステージングバケットにコピーしますが、それらを削除することはありません。古いファイルを削除し、ストレージコストを管理するには、AWSアカウントでS3ライフサイクルルールを作成してください。
- 宛先データベースに対して、1回限りのSQL権限付与を実行できるRedshift管理者。
- HubSpotおよびAWSのコンソールへのアクセス権限。それぞれを別のタブで開くことをお勧めします。
制限事項と考慮事項を理解する
- 同期が行われるたびに、選択されたデータの完全なスナップショットが生成されます。
- 同期が行われるたびに、宛先テーブルの内容が上書きされます。Redshift で追加されたテーブルレベルの権限や設定は、同期のたびに保持されません。
- エクスポートするデータ量は、対象とするオブジェクト、関連付け、およびイベントを選択することで制御できます。
- 同期に失敗した場合、次に予定されている同期で自動的にフル同期が再試行されます。
Amazon Redshift アプリをインストールして接続する
- HubSpot アプリマーケットプレイスで、Amazon Redshift アプリ掲載情報を開きます。
- HubSpotアカウントに連携されているAWSロールを選択してください。
- ［インストール］をクリックします。
- ［次へ］をクリックします。
- HubSpotアカウントに連携され、AWSアカウントにアクセスできるよう設定されたAWS IAMロールを作成します。
- ロールのAmazonリソース名（ARN）を入力してください。
- 「Amazon Redshift に接続」をクリックします。
AWSロールを設定する
HubSpotは、連携されたAWSロールを使用して、一時的なParquetファイルをS3のステージングバケットに書き込み、そのファイルをRedshiftに読み込みます。
- 「S3 バケットの URL」フィールドに、HubSpot が一時的な Parquet ファイルをステージングするために使用する S3 バケットの URL を入力してください。
URLにプレフィックスを含めることで、バケット内の特定のパスへのアクセスを制限することができます。バケットは、Redshift クラスターまたはサーバーレスワークグループと同じ AWS リージョンにある必要があります。
ご注意： HubSpotは、設計上、Parquetファイルを設定済みのS3ステージングバケットにコピーしますが、それらを削除することはありません。AWSでS3ライフサイクルルールを作成し、古いファイルを自動的に削除するように設定します。
- ドロップダウンメニューからRedshiftのデプロイメントタイプを選択してください：
- Redshift Serverless
- プロビジョニング済みのクラスター
- 接続済みの AWS ロールについて、デプロイメントの種類に応じた権限ポリシーで更新してください：
- Redshift Serverless：ワークグループの ARN を入力してください。HubSpot は、ARN を含むポリシーを生成します。ポリシーをコピーし、関連付けられているAWSロールに紐付けます。
- プロビジョニング済みのクラスター：ポリシーテンプレートをコピーします。置き換える
YOUR_REGION、YOUR_ACCOUNT_ID、YOUR_CLUSTER_ID、およびYOUR_DATABASEを、ご自身のAWSアカウントの値に置き換え、そのポリシーを関連付けられたAWSロールに紐付けます。
- AWS IAM で、HubSpot に紐付けられているロールを開きます。
- 生成された権限ポリシーをロールに割り当てるか、そのポリシー内容を使用してインラインポリシーを作成します。
- 同じ AWS IAM ロール内で、HubSpot によって生成されたステートメントを使用して、トラストポリシーを更新します。
HubSpot は、選択した Redshift のデプロイメントタイプに応じて、異なる信頼ポリシー声明を生成します。
AWSロールをRedshiftに関連付ける
Amazon Redshift では、前のセクションで更新したのと同じ AWS ロールを、Redshift の設定に関連付けます。
- Redshift Serverless： HubSpot で使用しているネームスペースのネームスペース設定ページを開きます。[ セキュリティと暗号化 ] タブで、[IAM ロールの管理 ] をクリックし、[ IAM ロールの関連付け ] を選択します。
- プロビジョニング済みのクラスター：クラスターを開き、「アクション」をクリックして、「IAMロールの管理」 > を選択し、IAMロールを関連付けます。
Redshift の権限を付与する
- HubSpotで、宛先データベースを選択します。
- Redshiftの管理者に依頼して、選択したデータベースでSQLスクリプトを実行してもらってください。
HubSpot は、この権限を使用して、同期中に宛先用のスキーマを作成します。
- [ 接続テスト ] をクリックします。
- 接続テストが成功した場合は、「次へ」をクリックしてください。
データエクスポートの同期を設定する
- エクスポートするデータソースを選択してください。
- 含めるオブジェクト、関連付け、およびイベントのテーブルを選択してください。
- 同期の頻度と開始時刻を設定します。
- 「同期を開始」をクリックしてください。
同期処理が実行されるたびに、選択されたデータの完全なスナップショットがAmazon Redshiftにエクスポートされます。
同期の監視と管理
同期の詳細ページでは、以下の情報を確認できます：
- 同期状況。
- 最終同期日時。
- エラー。
- アクティビティーの同期の進捗状況。
- 同期履歴。
同期の詳細ページを開くには：
- HubSpotアカウントで、「データ管理」> 「連携」の順に移動します。
- [ アプリ同期 ] タブで、「Amazon Redshift アプリ同期」を検索します。
- 確認したいAmazon Redshiftの同期をクリックしてください。
同期の詳細ページからは、以下の操作を行うこともできます：
- 「一時停止」をクリックすると、同期が一時停止されます。
- 「アーカイブ」をクリックして、同期データをアーカイブします。
- 「今すぐ同期」をクリックして、手動で同期を開始してください。
同期ステータス
| ステータス | 説明 |
|---|---|
| 同期 | 同期処理が実行中です。 |
| 同期済み | 最新の同期実行が正常に完了しました。 |
| 失敗しました | 直近の同期実行でエラーが発生しました。 |
| アーカイブ済み | 同期設定がアーカイブされたか、削除されました。 |
同期の失敗を解決する
同期に失敗した場合：
- HubSpotでは、同期の状態が「失敗」と表示されています。
- テーブルごとの詳細には、どのテーブルが成功し、どのテーブルが失敗したかが表示されます。
- 次回の予定された同期では、自動的に再度完全同期が試行されます。
- 「今すぐ同期」をクリックすると、手動で別の同期を開始できます。
