Marketoドライバがv24で大きく進化しました

by 浦邊信太郎 | October 21, 2024 | Last Updated: October 21, 2024

CData Marketo Drivers は Marketo のデータをBI・ETL ツールやExcel 、データベースとノーコードで連携するドライバです。2024年10月にリリースされたバージョンv24 ではv23 から大きく進化しました。本記事ではその進化した内容を紹介するとともに、v23 以前の旧バージョンから移行する際の注意点を説明します。

1. 進化した内容

v24 ではv23 以前と比較し、より分かりやすく、より高いパフォーマンスで利用頂けるように大きく進化しました。本章ではMarketo Driver v24 の注目ポイントを紹介します。

1.1. RESTスキーマへの一本化

最も大きな変更として、v24 でSOAP スキーマが廃止されREST スキーマに一本化されました。

これまでは使用するAPI によってSOAP スキーマとREST スキーマの二つのスキーマが選択できました。しかしMarketo はSOAP APIの開発がストップし、今後はREST に焦点を当てていくとアナウンスしています。今後SOAP API の廃止が見込まれているため、v24 以降ではCData Drivers もREST のみをサポートする方針となりました。一本化されたことでスキーマ選択に迷う事なくよりシンプルにご利用頂けます。

1.2. カスタムオブジェクトのバルクエクスポートをサポート

カスタムオブジェクトのバルク処理によるデータ取得をサポートしました。カスタムオブジェクトの大量データを取得する時にバルク処理を行うことでパフォーマンスが大きく向上します。

1.3. バルク処理のマルチスレッド化

これまでバルク処理はシングルスレッドで実行されていましたが、これがマルチスレッドで実行されるようになりました。これによりバルク処理自体のパフォーマンスが大きく向上します。

1.4. より多くのカラムでサーバーサイドフィルタリングをサポート

これまでサポートしていなかったカラムでサーバサイドフィルタリングをサポートしました。例えばEmails テーブルのStatus カラム、Folders テーブルのParentId, ParentType カラム、SmartLists テーブルのFolderId, FolderType カラム、Campaigns ビューのProgramName, WorkspaceName カラムなどで新たにサーバサイドフィルタリングがサポートされました。これにより、これらのカラムでフィルタリングした際のパフォーマンスが大きく向上します。

1.5. アクティビティテーブルの命名規則が変更

アクティビティテーブル(Activities*)のテーブル名やカラム名の単語の区切りにアンダースコア(_)が入ります。例えばActivities_NewLead はActivities_New_Lead になります。この規則はカラム名にも適用され、例えばModifyingUser はModifying_User となります。これは長いテーブルに対応するオブジェクトやカラムに対応するフィールドを分かりやすくすることを狙いとし、Activities_ScheduledMeetinginConversationalFlow のような長い名前のテーブルもActivities_Scheduled_Meeting_in_Conversational_Flow となることでテーブルの内容を即座に把握することができます。また、カスタムアクティビティのテーブル名はそれがカスタムアクティビティであることを明確にするために末尾に「_c」が付与されます。

1.6. その他の変更点

詳細な変更点については以下の資料をご覧ください。

ヘルプドキュメント

・v23 ヘルプドキュメント
 ・v24 ヘルプドキュメント

スキーマ比較資料

こちらにv23 とv24 におけるテーブルおよびストアドプロシージャの対応を示したExcelファイルがあります。

2. 旧バージョンからの移行

本章ではドライバとSync でv23 以前の旧バージョンからv24 に移行する際の注意点や手順を説明します。

2.1 ドライバ

SOAP を利用されている場合はREST に移行していただく必要があります。コネクションの主な変更点は以下の2点です。プロパティのラインナップや名称が変わりますので、既存の設定をもとにコネクションの再作成、再設定を行ってください。

SOAPスキーマが廃止となったため、Schema プロパティが削除されました
RESTEndpointURL プロパティの名前がURL に変更となりました。

テーブルなどのスキーマについては、1.6 章で示したヘルプドキュメントをもとにテーブル、カラム等を変更してください。変更する設定項目や内容はご使用のツールにより異なります。移行に関してサポートをご希望の場合はこちらのサポートフォームよりお問い合わせください。

2.2 Sync

CData Sync v24.2 までは CData Driver のv23ドライバー、もしくはそれ以下のバージョンで動作しております。今回のMarketo の大幅変更は、CData Sync v24.3 以降からの適用となります。そのため、今後どこかのタイミングでCData Sync 本体をアップデートされる場合、テーブル名やカラム変更が行われた影響で、正常にレプリケーションが完了しないケースがございます。

つきましては、2.2.1 コネクションの章より対応内容をご確認いただき、レプリケーション設定を更新してください。