Marketo コネクタ リファレンス

備考

ベータ版

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

サポートされているテーブル、コネクタオプション、送信先スキーマなど、Marketo コネクタのリファレンス情報をご覧ください。

サポートされているソーステーブル

Marketoコネクタは、以下のソーステーブルをサポートしています：

ソーステーブル	プライマリーキー	説明	同期モード	カーソルフィールド
leads	id	Adobe Marketo Engageインスタンス内の個人レコード（ID、属性、リードスコアリングフィールドを含む）。Bulk Extract APIを介して取り込まれます。	インクリメンタル	updatedAt
static_lists	id	オーディエンスターゲティングおよびセグメンテーションに使用される静的リスト。REST API を介して取り込まれました。	フル更新のみ
activity_<typeId>	marketoGUID	Adobe Marketo Engage アクティビティタイプごとに 1 つのテーブル。<typeId> は数値のアクティビティタイプ ID です (例: activity_1)。各テーブルは一連の固定列を共有し、タイプ固有の属性列を追加します。Bulk Extract API を介して取り込まれます。	インクリメンタル	activityDate
<customObjectApiName>	marketoGUID	カスタムオブジェクトごとに1つのテーブルが作成され、Adobe Marketo Engage API 名によって命名されます。スキーマはランタイムに検出されます。Bulk Extract API を介して取り込まれます。	インクリメンタル	updatedAt

ソーステーブル	プライマリーキー	説明	同期モード	カーソルフィールド
leads	id	Adobe Marketo Engageインスタンス内の個人レコード（ID、属性、リードスコアリングフィールドを含む）。Bulk Extract APIを介して取り込まれます。	インクリメンタル	updatedAt
static_lists	id	オーディエンスターゲティングおよびセグメンテーションに使用される静的リスト。REST API を介して取り込まれました。	フル更新のみ
activity_<typeId>	marketoGUID	Adobe Marketo Engage アクティビティタイプごとに 1 つのテーブル。<typeId> は数値のアクティビティタイプ ID です (例: activity_1)。各テーブルは一連の固定列を共有し、タイプ固有の属性列を追加します。Bulk Extract API を介して取り込まれます。	インクリメンタル	activityDate
<customObjectApiName>	marketoGUID	カスタムオブジェクトごとに1つのテーブルが作成され、Adobe Marketo Engage API 名によって命名されます。スキーマはランタイムに検出されます。Bulk Extract API を介して取り込まれます。	インクリメンタル	updatedAt

コネクターオプション

パイプライン定義内のテーブルオブジェクトに、次のオプションを設定します。初期同期の開始日を設定するを参照してください。

オプション	説明
sync_start_date	初期同期の開始日（YYYY-MM-DD形式）。これは、ヒストリカルデータを同期する最も早い日付です。設定しない場合、コネクタはdefaultで2年分の履歴を取り込みます。このオプションは初期バックフィルにのみ適用されます。テーブルの最初の同期後、完全更新をランしない限り、変更しても効果はありません。

オプション	説明
sync_start_date	初期同期の開始日（YYYY-MM-DD形式）。これは、ヒストリカルデータを同期する最も早い日付です。設定しない場合、コネクタはdefaultで2年分の履歴を取り込みます。このオプションは初期バックフィルにのみ適用されます。テーブルの最初の同期後、完全更新をランしない限り、変更しても効果はありません。

宛先テーブルのスキーマ

leads

主キー: id カーソルフィールド: updatedAt

フィールド	データ型
id	STRING
firstName	STRING
lastName	STRING
email	STRING
leadScore	BIGINT
unsubscribed	BOOLEAN
leadSource	STRING
company	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP

フィールド	データ型
id	STRING
firstName	STRING
lastName	STRING
email	STRING
leadScore	BIGINT
unsubscribed	BOOLEAN
leadSource	STRING
company	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP

static_lists

主キー: id 同期モード: 完全更新のみ

フィールド	データ型
id	BIGINT
name	STRING
description	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
programName	STRING
workspaceName	STRING

フィールド	データ型
id	BIGINT
name	STRING
description	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
programName	STRING
workspaceName	STRING

activity_<typeId>

主キー: marketoGUID カーソルフィールド: activityDate

すべてのアクティビティテーブルには、次の固定列が含まれます：

フィールド	データ型
marketoGUID	STRING
leadId	STRING
activityDate	TIMESTAMP
activityTypeId	STRING
campaignId	STRING
primaryAttributeValueId	STRING
primaryAttributeValue	STRING

フィールド	データ型
marketoGUID	STRING
leadId	STRING
activityDate	TIMESTAMP
activityTypeId	STRING
campaignId	STRING
primaryAttributeValueId	STRING
primaryAttributeValue	STRING

各アクティビティテーブルには、Adobe Marketo Engage でそのアクティビティタイプに対して定義された属性ごとに 1 つの列も追加されます。コネクタは Adobe Marketo Engage メタデータからこれらの属性を検出し、元の名前を保持し、Adobe Marketo Engage データ型から Spark 型へのマッピングを使用して型をマップします。

<customObjectApiName>

主キー: marketoGUID カーソルフィールド: updatedAt

カスタムオブジェクトスキーマは、実行時に Adobe Marketo Engage から検出され、インスタンスごとに異なります。すべてのカスタムオブジェクトテーブルには marketoGUID、createdAt、および updatedAt が含まれ、その後にサブスクリプションで定義されたオブジェクト固有のフィールドが続きます。フィールドタイプは、Adobe Marketo Engage データ型から Spark 型へのマッピングに従います。

Adobe Marketo Engage データ型から Spark タイプへのマッピング

コネクターは、実行時に発見されたすべてのカラム(アクティビティ属性やカスタムオブジェクトフィールドなど)に対して、Adobe Marketo Engageのデータ型をSparkタイプにマッピングします。マッチングでは大文字と小文字は区別されません。

Adobe Marketo Engage データタイプ	Spark型
integer	BIGINT
string、text、email、url、phone、 reference	STRING
float	DOUBLE
currency	DECIMAL(38, 4)
boolean	BOOLEAN
date	DATE
datetime	TIMESTAMP
array, email_list	ARRAY<STRING>
その他のタイプ	STRING

Adobe Marketo Engage データタイプ	Spark型
integer	BIGINT
string、text、email、url、phone、 reference	STRING
float	DOUBLE
currency	DECIMAL(38, 4)
boolean	BOOLEAN
date	DATE
datetime	TIMESTAMP
array, email_list	ARRAY<STRING>
その他のタイプ	STRING