Salesforce マーケティングクラウド コネクタのリファレンス

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。

このページでは、Salesforce Marketing Cloud コネクタの技術的なリファレンス情報を提供します。

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

Salesforce マーケティングクラウド コネクタは、以下のデフォルトテーブルをサポートしています（source_schema が default に設定されている場合）。

テーブル名	アップデートのタイプ
journeys	インクリメンタル
campaigns	インクリメンタル
emails	インクリメンタル
automations	バッチ（非増分）
push_messages	インクリメンタル
subscribers	バッチ（非増分）
audit_events	インクリメンタル
security_events	インクリメンタル
click_events	インクリメンタル
sent_events	インクリメンタル
open_events	インクリメンタル
not_sent_events	インクリメンタル
bounce_events	インクリメンタル
unsubscribe_events	インクリメンタル

データ拡張の場合、外部キー（顧客キー）をsource_table名として提供する必要があります。データ拡張はバッチのみです（増分なし）。

自動データ型変換

コネクターは、データ拡張内のSalesforce マーケティングクラウドデータ型を以下のようにDelta互換データ型に変換します。

Salesforce マーケティング クラウド 型	Delta 型
テキスト	string
メール	string
メールアドレス	string
Phone	string
ローカル	string
Number	整数
ロングナンバー	long
Decimal(p, s)	decimal(min(p, 38), min(s, 18))
Boolean	boolean
Date	timestamp_ntz
Byte	Byte

注記

マーケティング クラウド APIsは、タイムスタンプのタイムゾーンに関する情報を提供しません。したがって、コネクタはタイムゾーンなしでタイムスタンプを保存します（TimestampNTZ）。

必須認証フィールド

Salesforce Marketing Cloud用のUnity Catalog接続を作成する際は、以下のパラメーターを指定してください。

フィールド	説明
サブドメイン	認証ベースURIからのmcで始まる、マーケティングクラウドインスタンスの28文字のサブドメイン（例：mc1234abcdzz9t0k5l7m8n9p0q）
マーケティングID（MID）	Salesforce マーケティングクラウド インターフェースの右上隅に表示される、ビジネスアカウントのマーケティングID。
クライアントID	API 統合パッケージからのクライアント ID
クライアントのシークレット	API統合パッケージのクライアントシークレット

デフォルトテーブルのスキーマ

サポートされているすべてのデフォルトテーブルの詳細なスキーマ（フィールド名とデータ型を含む）については、次のセクションをご覧ください。

ジャーニー

主キー (複合)：(id, version)。

フィールド	データ型
id	string
version	整数
キー	string
name	string
最終公開日	timestamp
ステータス	string
説明	string
作成日	timestamp
変更日	timestamp
workflowApiVersion	整数
アクティビティ	array<struct>
トリガー	array<struct>
目標	array<string>
終了	array<string>
通知機能	array<string>
統計	struct
healthStatus	struct
エントリモード	string
definitionType	string
チャンネル	string
デフォルト	struct
メタデータ	string
実行 モード	string
categoryId	整数
定義ID	string
スケジュール済みステータス	string
キャンペーン	array<string>

キャンペーン

フィールド	データ型
id	string
作成日	timestamp
変更日	timestamp
name	string
説明	string
campaignCode	string
色	string
お気に入り	boolean

Eメール

フィールド	データ型
id	long
カスタマーキー	string
objectID	string
contentType	string
assetTypeId	整数
assetTypeName	string
アセットタイプ表示名	string
name	string
所有者	struct
作成者	struct
作成日	timestamp
modifiedBy	struct
変更日	timestamp
エンタープライズID	long
ステータス	string
thumbnailUrl	string
コンテンツ	string
preheaderViewContent	string
subjectlineViewContent	string
htmlViewContent	string
characterEncoding	string

自動化

主キー (複合)：(id, view)。

view 列は、コネクタによって追加される合成列です。同じ自動化エントリ内でレコードタイプを区別します（normal vs. targetdes）。

フィールド	データ型
id	string
ビュー	string
キー	string
name	string
説明	string
categoryId	整数
タイプ	string
タイプID	整数
ステータス	string
statusId	整数
スケジュール	struct<typeId: integer, startDate: timestamp_ntz, endDate: timestamp_ntz, scheduledTime: timestamp_ntz>
lastRunTime	timestamp_ntz
lastRunInstanceId	string
automationTrigger	struct
ファイルトリガー	struct
ターゲットデータ拡張機能	array<struct>

イベントテーブル

すべてのイベント テーブル (click_events、sent_events、open_events、bounce_events、unsubscribe_events、not_sent_events) は、次のようなフィールドを含む同様のスキーマを共有しています。

• BatchID (整数)
• EventDate (タイムスタンプ)
• SendID (整数)
• SubscriberKey (文字列)
• TriggeredSendDefinitionObjectID (文字列)

追加フィールドはイベントタイプによって異なります。完全なスキーマについては、Salesforce マーケティング クラウド API ドキュメントを参照してください。