Marketo ドライバーをご利用のお客様へ - 2024年12月リリースに関するお知らせ

本記事は、2024年12月にリリースされた CData Marketo ドライバー（2024バージョン）へのアップグレードをご検討中のすべての Marketo ドライバーユーザー向けのお知らせです。

CData は、Marketo ドライバーの再設計を決定しました。これにはデータモデルの大幅な変更が含まれます。今回の変更は、今後も継続的にドライバーを維持しながら、長期的にお客様の使い勝手を向上させる新機能や拡張を提供するために実施されました。2024 リリースには、REST スキーマへのデータモデルの簡素化、カスタムオブジェクトに対するバルク操作のサポート追加、より多くのテーブルとビューでのサーバーサイドフィルタリング機能など、多くの機能強化が含まれています。

変更は接続プロパティ、テーブル、ビュー、ストアドプロシージャに影響します。以前のバージョンから 2024 Marketo ドライバーへのアップグレードは、破壊的な変更を引き起こす可能性があります。破壊的な変更の完全なリストは以下に記載しています。本番環境をアップグレードする前に、非本番環境で 2024 Marketo ドライバーをテストすることをお勧めします。

本アップグレードについてご質問がある場合は、CData サポートまでお問い合わせください。

影響を受けるエディション：全エディション

• Marketo ADO.NET Provider
• Marketo JDBC Driver
• Marketo ODBC Driver（Windows、Mac、Linux）
• Marketo Excel Add-in
• Marketo Power BI Connector
• Marketo Tableau Connector
• Marketo SSIS Component
• Marketo PowerShell Cmdlets
• Marketo Python Connector

接続プロパティの変更：REST のみへのスキーマ簡素化

Adobe は SOAP API の廃止を発表しました。CData Marketo ドライバーの以前のバージョンでは、SOAP と REST API の両方をサポートしていました。Marketo ドライバー 2024 バージョン以降は、REST API のみをサポートします。この決定に伴い、接続プロパティに以下の変更を加えました。

• 接続プロパティ RESTEndpoint は URL に名称変更されました。
• 接続プロパティ UserID、EncryptionKey、SOAPEndpoint は削除されました。
• 接続プロパティ Schema は 'SOAP' を有効な値として受け付けなくなりました。
• スキーマ REST は Marketo に名称変更されました。

SOAP スキーマを使用していた方は、2024 ドライバーで REST スキーマに切り替えてください。

REST スキーマを使用していた方は、以下の簡易な接続文字列サンプル（JDBC の例）のように接続プロパティが変更されます。

2023 ドライバー以前：

jdbc:marketo:Schema=3DREST;RESTEndpoint=3Dhttps://MyMarketoUrl/rest;OAuthClientId=3DMyOAuthClientId;OAuthClientSecret=3DMyOAuthClientSecret;

2024 ドライバー以降：

jdbc:marketo:URL=3Dhttps://MyMarketoURL.mktorest.com/;OAuthClientId=3DMyOAuthClientId;OAuthClientSecret=3DMyOAuthClientSecret;

データモデルの変更

以下は Marketo 2024 ドライバーにおけるデータモデルの変更の完全なリストです。

テーブル / ビュー

• Tags および Costs の情報は Programs テーブルから削除されました。これらの情報は、専用の子テーブル ProgramTags と ProgramCosts で利用できるようになりました。
• ProgramMembersBulkExports、LeadBulkExports、ActivityBulkExports は 1 つのテーブル BulkExportJobs に統合されました。バルクエクスポートをサポートするすべてのエンティティのエクスポートジョブをクエリするために使用できます。
• ビュー PreviewEmail はストアドプロシージャ GetEmailFullContent に置き換えられました。
• ビュー SnippentContent はストアドプロシージャ GetSnippetContent に置き換えられました。
• ビュー LeadLists は StaticListMembership に置き換えられました。
  • この新しいビューは、リードが含まれるリストと、リストに属するリードの両方でフィルタリングをサポートしています。
• ビュー SmartListRuleFilters は SmartListFilters と SmartListFilterConditions に分割されました。
• ビュー Tags は Tags と TagAllowableValues に分割されました。

カラム

• 各種テーブルのカラム順序が変更されました。
• Activities では、カラム Id が削除され、MarketoGUID は ActivityID に名称変更されました。
• LeadPrograms では、カラム Id が ProgramId に置き換えられました。
• すべての 'Assets' テーブルには新しい複合キー Status があります。有効な値は Draft、Approved です。
• EmailTemplates では、カラム Content が削除されました（更新時にのみ使用可能でした）。UpdateEmailTemplateContent ストアドプロシージャを使用して更新できるようになりました。
• Files では、カラム File、FileName、InsertOnly が削除されました（書き込み操作にのみ使用可能でした）。ストアドプロシージャ CreateFiles / UpdateFiles でそれぞれ作成または更新できるようになりました。
• ビュー Emails、SmartCampaigns、SmartLists では、擬似カラム LatestUpdatedAt、EarliestUpdatedAt が削除されました。カラム UpdatedAt で直接フィルタリングがサポートされるようになったためです。
• Folders では、擬似カラム RootFolderId と RootFolderType が削除されました。カラム ParentId と ParentType でフィルタリングがサポートされるようになりました。
• LandingPageContentSections では、擬似カラム LandingPageId と Status が複合主キーカラムに変換されました。
• Channels では、API から返されなくなったため、カラム Description が削除されました。
• Tags の AllowableValues カラムは、ビュー TagAllowableValues に置き換えられました。以前はドライバーが API から値を取得できなかったためです。
• Leads では、StaticListId が ListId に名称変更され、主キーに更新されました。
• ProgramMembers では、カラム Id（LeadId の重複）が削除されました。
• アセット関連のテーブルでは、カラム Workspace が WorkspaceName または WorkspaceId に名称変更されました。ワークスペースの名前と識別子のどちらを参照しているかを明確にするためです。
• ビュー DailyErrorStastistics、DailyUsageStatistics、WeeklyErrorStatistics、WeeklyUsageStatistics では、計算カラム Total が削除されました。SUM() 関数で計算できるためです。
• ビュー DailyUsaegStatistics、WeeklyErrorStatistics、WeeklyUsageStatistics では、カラム APICount が Count に名称変更されました。

ストアドプロシージャ

多くのストアドプロシージャが削除されました。複数のアクションを単一のプロシージャに統合したため、またはテーブルやビューの操作で同等のアクションが実行可能なためです。

• AddLeadsToList、RemoveLeadsFromList、ListMembersOfList、IsMemberOfList
  • 代わりに StaticListMembership で Insert、Delete、Select ステートメントを使用してください。
• AddLandingPageContentSection、DeleteLandingPageContentSection、UpdateLandingPageContentSection
  • LandingPageContentSections で Insert/Delete/Update ステートメントを使用してください。
• GetImportCustomObjectsFailures、GetImportLeadsFailures、GetImportProgramMembersFailures

  • GetImportJobFailures を使用し、属性
    Table=<Leads|ProgramMembers|CustomObject_{name}> を指定してください。

• GetImportCustomObjectsStatus、GetImportLeadsStatus、GetImportProgramMembersStatus
  • GetImportJobStatus を使用し、属性
    Table=<Leads|ProgramMembers|CustomObject_{name}> を指定してください。
• GetImportCustomObjectsWarnings、GetImportLeadsWarnings、GetImportProgramMembersWarnings
  • GetImportJobWarnings を使用し、属性
    Table=<Leads|ProgramMembers|CustomObject_{name}> を指定してください。
• ImportLeadsFromFile、ImportCustomObjectsFromFile、ImportProgramMembersFromFile
  • それぞれ BulkImportLeads、BulkImportCustomObjects、BulkImportProgramMembers に名称変更されました。
• CreateExportJob
  • 代わりに以下のいずれかを使用してください。
    • CreateActivitiesExportJob
    • CreateCustomObjectsExportJob
    • CreateProgramMembersExportJob
    • CreateLeadsExportJob
• RefreshOauthAccessToken
  • 非推奨になりました。Marketo は OAuth-Grant タイプのクライアントを使用するためです。

プロシージャパラメータ

• すべてのストアドプロシージャに、サーバーサイドの実行エラーを返すための Status と Details パラメータが追加されました。
• ScheduleCampaign の TokenAggregate が削除されました。
  • TokenName と TokenValue で置き換えることができます。
• CreateFile の File と Content が削除されました。
  • FileData、LocalPath、または InputStream のいずれかを指定することで置き換えることができます。
• UpdateFile の File が削除されました。
  • FileData、LocalPath、または InputStream のいずれかを指定することで置き換えることができます。
• CreateEmailTemplate の File が削除されました。
  • FileData、LocalPath、または InputStream のいずれかを指定することで置き換えることができます。
• UpdateEmailTemplateContent の File が削除されました。
  • FileData、LocalPath、または InputStream のいずれかを指定することで置き換えることができます。
• UpdateEmailFullContent の File が削除されました。
  • FileData、LocalPath、または InputStream のいずれかを指定することで置き換えることができます。
• UpdateLandingPageTemplateContent の File が削除されました。
  • FileData、LocalPath、または InputStream のいずれかを指定することで置き換えることができます。
• MergeLeads のパラメータが変更されました。
  • LoosingLeadId が LosingLeadId に名称変更されました。
• UpdateLeadProgramStatus のパラメータが変更されました。
  • Status が StatusName に名称変更されました。
• UpdateFile のパラメータが変更されました。
  • FileId が Id に名称変更されました。
• GetExportJobFile のパラメータが変更されました。
  • JobId が Id に、Type が Table に、File が LocalPath に名称変更されました。
  • FileStream が OutputStream に、ResponseData が FileData に名称変更されました。
• GetExportJobStatus のパラメータが変更されました。
  • JobId が Id に、Type が Table に名称変更されました。
• EnqueueExportJob のパラメータが変更されました。
  • JobId が Id に、Type が Table に、JobStatus が Status に名称変更されました。
• CancelExportJob のパラメータが変更されました。
  • JobId が Id に、Type が Table に、JobStatus が Status に名称変更されました。

データ

• REST バルク API は Insert をサポートしなくなりました。Upsert のサポートが追加されました。バルク Insert クエリはバルク Upsert に置き換える必要があります。
• 一部の子テーブル（例：ActivityTypesAttributes）は、親テーブルにデータがあっても子にデータがない場合、行をプッシュしなくなりました。
  例：
  • LeadChangesAttributes：LeadChanges の行に属性のデータがない場合、LeadChangesAttributes に行はプッシュされません。
  • ActivityTypeAttributes：親の ActivityType が存在しても、属性が null の場合、ActivityTypeAttributes は行をプッシュしません。

その他の重要な変更

• Assets テーブルでは、Status が Id とともに複合キーの一部になりました。ステータスでフィルタリングして、Draft または Approved のアセットを取得できます。
  • 同様に、DELETE ステートメントでは、Approved と Draft の両方のバージョンを防ぐために、Id と Status の両方を参照する必要があります。
• FolderId によるアセットのフィルタリングは、'Folder' と 'Program' の両方のタイプでフィルタリングします。特定のタイプのみをフィルタリングするには、folderType でフィルタリングしてください。
• フォルダーテーブルのクエリは、すべてのフォルダーを返すようになりました。デフォルトの MaxDepth=3D2 の制限は削除されました。
• 多くのテーブルに必須条件が追加されました。フィルタが欠落しているとエラーがスローされます。