最終更新日 2023年03月30日(木)

データベーステーブルの構造

オブジェクトをマッピングする​と、Heroku Connect は、そのマッピングされたオブジェクトのデータを保存するために使用されるデータベーステーブルを作成または更新します。

• マッピングテーブルでは、Salesforce オブジェクト名の小文字のバージョンが使用されます。たとえば、Account​ Salesforce オブジェクトは account​ データベーステーブルにマッピングされます。

• 列名では、Salesforce フィールド名の小文字のバージョンが使用されます。たとえば、AccountNumber​ Salesforce フィールドは accountnumber​ データベース列にマッピングされます。

• 新しいマッピングを作成すると、Heroku Connect が Salesforce からのデータを自動的に入力するための新しいデータベーステーブルが作成されます。

• 既存のマッピングを編集すると、ALTER TABLE​ SQL コマンドを使用して既存のデータベーステーブルが変更されます。Heroku Connect は、新しくマッピングされたすべてのフィールドに Salesforce からのデータを入力します。

システム列

データベース列にマッピングするように選択された Salesforce フィールドに加えて、Heroku Connect は、マッピングされたテーブルに次のシステム列を自動的に追加します。

システムフィールド: 読み取り専用の列

Heroku Connect で書き込みを Salesforce に同期するときに、読み取り専用である一部の列への書き込みは無視されます。これらの列は、ほとんどの Salesforce オブジェクトにあるシステムフィールドに対応しています。詳細は、システムフィールド​に関するページを参照してください。

新しいレコードの書き込みを Salesforce に同期するときに、次の列は設定できません。

• CreatedDate
• Id
• IsDeleted
• LastModifiedDate
• SystemModstamp

更新を Salesforce に同期するときに、次の列は更新できません。

• CreatedById
• CreatedDate
• IsDeleted
• LastModifiedById
• LastModifiedDate
• SystemModstamp

ステータス情報

_hc_lastop​ および _hc_err​ 列を使用すると、デバッグを支援したり、アプリケーションで同期ステータス情報を表示したりできます。

_hc_lastop​ 列は、最初は空白になり、その後に同期プロセスの一部として次のいずれかのステータスに更新されます。

• 'PENDING'​ - データベース内の新しい行が Salesforce との同期を待っています。

• 'INSERTED'​ - データベース内の新しい行が Salesforce に挿入されました。この時点で、sfid​ も設定されます。

• 'UPDATED'​ - データベース内の既存の行が Salesforce で正常に更新されました。

• 'SYNCED'​ - 新しい行が Salesforce から​同期されました。

• 'FAILED'​ - Salesforce の同期が失敗しました。

• NULL​ - この行は初期ロードから変更されていません。

失敗が発生した場合は、次のプロパティが含まれた JSON オブジェクトが _hc_err​ 列に含まれます。

マッピングされるデータ型

次の表は、Salesforce フィールド型がデータベース内の列にどのようにマッピングされるかを示しています。

空の文字列/空白文字列/NULL 文字列

Salesforce のデータモデルには、空の文字列の概念はありません。このため、空の文字列または空白文字列の値を示すには、すべての文字列型が DB で NULL の値を使用する必要があります。 Connect によって管理されているテーブルに空の文字列が書き込まれた場合、その値は NULL に自動的に変換されます。

暗号化された文字列

Heroku Connect での暗号化された文字列の処理方法は、Salesforce 組織が Shield Platform Encryption または従来の暗号化​のどちらを使用しているかによって異なります。

Shield Platform Encryption

Shield Platform Encryption が有効になっているフィールドまたはレコードは、Salesforce で保存時に暗号化されます。Salesforce で Heroku Connect を認証するために使用されるユーザー資格情報に暗号化されたフィールドまたはレコードに対する読み取りアクセス権がある場合、暗号化されていない値は Salesforce から受信され、暗号化されずにデータベースに保存されます。ユーザーに読み取りアクセス権がない場合、そのユーザーはデータを表示できません。"暗号化されたデータの表示" アクセス許可は Shield Platform Encryption には適用されません。

従来の暗号化

Salesforce で Heroku Connect を認証するために使用されるユーザー資格情報に暗号化されたデータの表示​アクセス許可がない場合、暗号化された文字列はマスクされた形式で Salesforce から受信されます。

データベースが新しいプレーンテキスト値で更新される可能性があり、Salesforce は、その新しいデータがデータベースからプッシュされたときに暗号化を処理します。そのレコードが次回 Salesforce からのデータで更新されると、データベース内のプレーンテキスト値はマスクされた形式で上書きされます。

クロスオブジェクト数式およびロールアップサマリーフィールド

数式フィールド​は、クエリ時に Salesforce によって計算され、他のフィールド、関数、リテラル値を使用できます。また、マスターの詳細またはルックアップ関係を使用して、親オブジェクト内のフィールドを参照することもできます。ただし、これにより、Heroku Connect がデータを同期しているときに問題が発生する場合があります。

次に例を示します。

• Contact​ オブジェクトには、関連する親 Account​ オブジェクトの Name​ フィールドを参照する name_formula__c​ という名前の数式フィールドがあります。
• Account​ レコードの Name​ フィールドが更新されます。
• name_formula__c​ の更新された値は、関連 Contact​ レコードのクエリが実行されたときに返されます。
• Contact​ レコードの SystemModStamp​ は更新されない​ため、新しい name_formula__c​ 値は Heroku Postgres データベースと同期されません​。

ロールアップサマリーフィールド​には親レコードの関連子レコードからの値が要約され、マスターの詳細関係の親レコードの値が表示されます。Salesforce では、ロールアップサマリーフィールドで参照されている子オブジェクトのフィールドが更新されると、ロールアップサマリーフィールドが計算されます。

次に例を示します。

• 親 Account​ オブジェクトに、関連の子 Opportunity​ レコードの Amount​ フィールドの合計を計算する amount_rollup__c​ というロールアップサマリーフィールドがあります。
• Opportunity​ レコードの Amount​ フィールドが更新されます。
• 関連 Opportunity​ レコードの Amount​ フィールドが更新されると、Account​ レコードの amount_rollup__c​ の値が更新されます。
• Account​ オブジェクトの SystemModStamp​ は最後に更新される​ため、新しい amount_rollup__c​ 値は最後に Heroku Postgres データベースと同期されます​。

サポートされていないデータ型

次の型はサポートされていないため、マッピングを作成または編集するときに Mapped Fields​ (マッピングされたフィールド) 一覧に表示されません。

Base64 バイナリフィールド

Attachment​、ContentVersion​、Document​、Scontrol​ などに保存されたバイナリファイルは、Base64 でエンコードされたバイナリデータ型を使用します。Base64 フィールドは Bulk API​ クエリでサポートされていないため、Heroku Connect ではサポートされません。したがって、画像やその他の種類のバイナリデータはサポートされません。代わりの方法として、Amazon S3 に画像を保存し、画像の URI を含む単純なテキストフィールドを Salesforce とデータベースの間で同期することができます。

複合フィールド

Address および Geolocation 複合フィールド型​は直接マッピングできませんが、そのコンポーネントのフィールドをマッピングに追加することは可能です。

たとえば、Contact​ オブジェクトには、次のフィールドを使用してマッピングできる MailingAddress​ Address フィールドがあります。

同様に、OfficeLocation​ という名前のカスタム Geolocation フィールドは、次のフィールドを使用してマッピングされます。

サポートされていないオブジェクト型

次のオブジェクト型は、現在サポートされていません。

Big Objects

この型のオブジェクトの API 名には __b​ のサフィックスが付いています。Salesforce には、Heroku Connect が Big Objects を同期できない SOQL クエリの制限​があります。

Platform Events

この型のオブジェクトの API 名には __e​ のサフィックスが付いています。

External Objects

この型のオブジェクトの API 名には __x​ のサフィックスが付いています。

マッピングされたテーブルのクエリ

マッピングされたテーブルは、Postgres データベース内の他のテーブルと同様にクエリできます。アドオンをプロビジョニングするときに選択したスキーマ名で (たとえば、デフォルトの salesforce​ スキーマ名を使用して) テーブル名を修飾する必要があります。

SELECT * FROM salesforce.account;

完全修飾名を指定しなくてもテーブルをクエリできるように、そのスキーマを Postgres のスキーマ検索パス​に追加することもできます。次に例を示します。

SET search_path TO salesforce,public;
SELECT * FROM account;

システムテーブル

Heroku Connect は、スキーマ内に次のいくつかのシステムテーブルを作成します。

• _hcmeta

  This table contains metadata that allows Connect to ensure the database is properly initialized and configured.

• _trigger_log

  The _trigger_log table is used to record updates that must be written to Salesforce. Data remains in this table for up to one day allowing you to track updates that are pending, in progress or have already completed. If an error occurs while writing to Salesforce it’s logged in this table.

• _trigger_log_archive

_trigger_log​ テーブル内のデータが 1 日を過ぎると、データは最大 31 日間利用できるこのアーカイブテーブルに移されます。注意:​ アーカイブはデモプラン​では 7 日間のみ利用できます。

Salesforce のスキーマの変更

フィールドの追加

Salesforce 内のオブジェクトに新しいフィールドを追加しても、Heroku Connect の同期操作には影響を与えません。既存のマッピングに新しいフィールドを追加することを選択した場合、Heroku Connect はマッピングされたデータベーステーブル内に自動的に列を作成し、Salesforce からフィールドのデータを取得し、そのデータを使用してデータベース内の既存のレコードを設定します。

• 単一列をマッピングに追加する場合、そのフィールドの値が NULL であるレコードを除いて、そのオブジェクトのデータが Heroku Connect によって Salesforce から取得されます。
• 複数列を追加する場合、Salesforce からデータを取得するクエリで NULL 値は除外されません。

フィールドの変更

フィールド定義を変更する必要がある場合は、次のようにする必要があります。

1. マッピングを編集​し、変更しようとしているフィールドを削除します。
2. Salesforce でフィールド定義を変更します。
3. マッピングを編集​し、手順 1 で削除したフィールドを戻します。これにより、そのフィールドのデータ型に手順 2 で行った変更が反映されます。

フィールドの削除

Salesforce オブジェクトからフィールドを削除する場合は、まず Heroku Connect でそのフィールドをマッピングから削除することがベストプラクティスです。フィールドをマッピングから削除する前に Salesforce オブジェクトから削除することを選択した場合、Heroku Connect は次回、変更がないかどうかマッピングがポーリングされたときにエラーを報告します。このエラーを解決するには、マッピングを編集​し、なくなっているフィールドを削除します。これらは赤色で強調表示されます。変更を保存すると、Heroku Connect はマッピングされたテーブルから列を削除し、それにより同期操作が再開されます。