「クイックスタート: Heroku Connect」

最終更新日 2024年05月08日(水)

低料金プラン​を使用してこのチュートリアルを完了することをお勧めします。資格のある学生の皆様は、新しい Heroku for GitHub Students プログラム​を通じてプラットフォームクレジットを申請できます。

このガイドは、Heroku および Heroku Connect ダッシュボードを使用して Heroku Connect アドオンを設定するのに役立ちます。このアドオンの詳細は、Heroku Connect​を参照してください。

設定の推奨事項と考慮事項については、Setting Up Heroku Connect​(Heroku Connect の設定) を参照してください。

ダッシュボードの代わりにこれらのツールを使用して設定する場合は、クイックスタート: Heroku Connect CLI​およびHeroku Connect API​を参照してください。

前提条件

手順 1: Heroku アプリと Heroku Postgres データベースを作成する

Heroku Connect では、Salesforce からデータを同期するために Heroku Postgres​ が必要です。Heroku Connect と Heroku Postgres はどちらもアドオンであり、Heroku アプリにアタッチする必要があります。空のアプリにアドオンをアタッチすることができ、コードのデプロイは必要ありません。

データベースを使用してこのチュートリアルを完了した場合、使用量のカウントに入ります。コストを抑制するために、完了したらすぐにデータベースを削除してください。低料金プラン​について確認してください。資格のある学生の皆様は、Heroku for GitHub Students プログラム​を通じてプラットフォームクレジットを申請できます。

次のようにして、空のアプリを作成して Heroku Postgres をアタッチします。

  1. Heroku Dashboard​ を開きます。
  2. 右上隅にある New​ (新規) をクリックし、Create new app​ (新規アプリの作成) を選択します。
  3. アプリ名を入力し、アプリのリージョンを選択して、Create app​ (アプリの作成) をクリックします。
  4. アプリが作成されると、アプリビューがロードされます。Resources​ (リソース) タブをクリックします。
  5. Add-ons​ (アドオン) セクションで Heroku Postgres を検索します。
  6. プランを選択し、Submit Order Form​ (注文フォームの送信) ボタンをクリックします。本番稼働のユースケースでは -4​ 以上のプランを選択してください。詳細は、Heroku Connect​を参照してください。チュートリアルの目的に限り、費用を最小限に抑えるために essential-0​ プランを選択できます。

手順 2: Heroku Connect アドオンをプロビジョニングする

  1. Heroku Dashboard​ を開きます。
  2. Heroku Connect を接続するアプリをクリックします。
  3. Resources​ (リソース) タブをクリックします。
  4. Add-ons​ (アドオン) セクションで Heroku Connect を検索します。
  5. プランを選択し、Submit Order Form​ (注文フォームの送信) ボタンをクリックします。詳細は、Available Plans​(使用可能なプラン) を参照してください。

プロビジョニングされると、Resources​ (リソース) タブの Add-ons​ (アドオン) セクションに Heroku Connect が表示されます。

手順 3: ログ記録アドオンをプロビジョニングする

Heroku Connect は、その同期アクティビティのログを生成し、このログにはログドレイン​からアクセスできます。アプリケーション用のこれらのログ記録アドオン​のいずれかをプロビジョニングします。

  1. Heroku Dashboard​ を開きます。
  2. Heroku Connect を接続するアプリをクリックします。
  3. Resources​ (リソース) タブをクリックします。
  4. Add-ons​ (アドオン) セクションでアドオンを検索します。
  5. プランを選択し、Submit Order Form​ (注文フォームの送信) ボタンをクリックします。

手順 4: 接続を設定する

  1. Heroku Dashboard​ Resources​ (リソース) タブからアドオンをクリックして、Heroku Connect ダッシュボードを開きます。
  2. ダッシュボードの Setup Connection​ (接続の設定) ボタンをクリックします。
  3. アプリケーションにアタッチされている Heroku Postgres データベースを選択します。アプリケーションに複数のデータベースがアタッチされている場合は、Heroku Connect で使用するデータベースを選択できます。DATABASE_URL​環境設定で指定されたデータベースがデフォルトで選択されています。
  4. Heroku Connect によって作成されたテーブルに使用する Postgres スキーマを選択します。デフォルトは salesforce​ です。スキーマにテーブルが存在しない限り、public​ を含む既存のスキーマにテーブルを配置することを選択できます。
  5. Next​ (次へ) をクリックして、データベースを設定します。
  6. 本番環境またはサンドボックス Salesforce 組織への認証を選択します。カスタムのログインドメインを使用できます。
  7. Heroku Connect で使用する Salesforce API バージョンを選択します。接続の設定後は、API バージョンを変更することはできません。接続を再作成して、API バージョンを変更します。
  8. Authorize​ (認証) ボタンをクリックすると、ブラウザが開くので、Salesforce のログイン資格情報を入力して Heroku Connect を認証できます。View All Data​ (すべてのデータの表示) 権限を持つ専用の統合ユーザーを使用することをお勧めします。詳細は、Heroku Connect​を参照してください。

手順 5: マッピングを設定する

Salesforce 組織への認証が完了したら、オブジェクトのマッピング​を開始できます。プロセスを開始するには、Heroku Connect ダッシュボード​の Overview​ (概要) タブで Create Mapping​ (マッピングの作成) をクリックします。詳細は、Managing Heroku Connect のマッピング​を参照してください。

(オプション) 手順 6: 設定を確認する

以下をチェックして、データが同期していることを確認します。

  1. Mapping​ (マッピング) タブをクリックします。
  2. Status​ (ステータス) 列は、マッピングの同期状態を示します。マッピング状態のリファレンス​をチェックして、すべてのマッピングがエラー以外の状態にあることを確認します。

Explorer tab​ タブを使用して、データが同期されていることを確認することもできます。Salesforce とマッピングされたデータベーステーブルに保持されているデータを並べて比較して表示できます。

次のステップ

このチュートリアルでは、空の Heroku アプリを設定します。このアプリにコードをデプロイするには、デプロイ​に関する記事を参照してください。ほとんどのユーザーは Git​ を使用してコードをデプロイします。

Heroku アプリから Heroku Postgres データベースに接続するには、「Heroku Postgres​」を参照してください。

外部接続から Heroku Postgres に接続するには、「外部接続 (ingress)​」および「Private Space と Shield Space での Heroku Postgres​」を参照してください。