Databricks（AWS）でAdobe Target のデータを処理・分析

Databricks は、Apache Spark を通じたデータ処理機能を提供するクラウドベースのサービスです。CData JDBC Driver と組み合わせることで、Databricks を使用してリアルタイムAdobe Target のデータに対してデータエンジニアリングとデータサイエンスを実行できます。この記事では、AWS でCData JDBC Driver をホストし、Databricks でリアルタイムAdobe Target のデータに接続して処理する方法を説明します。

最適化されたデータ処理が組み込まれたCData JDBC Driver は、リアルタイムAdobe Target のデータを扱う上で比類のないパフォーマンスを提供します。Adobe Target に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作をAdobe Target に直接プッシュし、サポートされていない操作（主にSQL 関数やJOIN 操作）は組み込みSQL エンジンを利用してクライアント側で処理します。組み込みの動的メタデータクエリを使用すると、ネイティブデータ型を使ってAdobe Target のデータを操作・分析できます。

CData JDBC Driver をDatabricks にインストール

Databricks でリアルタイムAdobe Target のデータを操作するには、Databricks クラスターにドライバーをインストールします。

1. Databricks の管理画面に移動し、対象のクラスターを選択します。
2. Libraries タブで「Install New」をクリックします。
3. Library Source として「Upload」を選択し、Library Type として「Jar」を選択します。
4. インストール場所（通常はC:\Program Files\CData[product_name]\lib）からJDBC JAR ファイル（cdata.jdbc.adobetarget.jar）をアップロードします。

ノートブックでAdobe Target のデータにアクセス：Python

JAR ファイルをインストールしたら、Databricks でリアルタイムAdobe Target のデータを操作する準備が整いました。ワークスペースに新しいノートブックを作成します。ノートブックに名前を付け、言語としてPython を選択し（Scala も利用可能）、JDBC ドライバーをインストールしたクラスターを選択します。ノートブックが起動したら、接続を設定し、Adobe Target をクエリして、基本的なレポートを作成できます。

Adobe Target への接続を設定

JDBC Driver クラスを参照し、JDBC URL で使用する接続文字列を構築してAdobe Target に接続します。また、JDBC URL でRTK プロパティを設定する必要があります（Beta ドライバーを使用している場合を除く）。このプロパティの設定方法については、インストールに含まれるライセンスファイルを参照してください。

ステップ1：接続情報

driver = "cdata.jdbc.adobetarget.AdobeTargetDriver"
url = "jdbc:adobetarget:RTK=5246...;Tenant=mycompanyname;"

組み込みの接続文字列デザイナー

JDBC URL の作成をサポートするために、Adobe Target JDBC Driver に組み込まれている接続文字列デザイナーが使用できます。JAR ファイルをダブルクリックするか、コマンドラインからJAR ファイルを実行します。

java -jar cdata.jdbc.adobetarget.jar

接続プロパティを入力し、接続文字列をクリップボードにコピーします。

Adobe Target に接続するには、以下に記載されているOAuth 接続プロパティとともにTenant プロパティを指定する必要があります。他の接続プロパティは処理動作に影響を与える可能性がありますが、接続には影響しません。

以下のステップでTenant 名を確認できます。

1. Adobe Experience にログインします。URL は「https://experience.adobe.com/#/@mycompanyname/preferences/general-section」です。
2. 「/#/@」の後の値を抽出します。この例では「mycompanyname」です。
3. Tenant 接続プロパティをその値に設定します。

ユーザーアカウント（OAuth）

すべてのユーザーアカウントフローでAuthScheme をOAuthClient に設定する必要があります。

注意：OAuth を介したAdobe 認証では、2週間ごとにトークンを更新する必要があります。

すべてのアプリケーション

OAuth アクセストークンの取得

接続するには以下のプロパティを設定します：

• InitiateOAuth：GETANDREFRESH に設定して、OAuth 交換を自動的に実行し、必要に応じてOAuthAccessToken を更新します。
• OAuthClientId：アプリを登録した際に割り当てられたクライアントID に設定します。
• OAuthClientSecret：アプリを登録した際に割り当てられたクライアントシークレットに設定します。
• CallbackURL：アプリを登録した際に定義されたリダイレクトURI に設定します。例：https://localhost:3333

これらの設定により、プロバイダーはAdobe Target からアクセストークンを取得し、それを使用してデータを要求します。OAuth値はOAuthSettingsLocation で指定された場所に保存され、接続間で確実に保持されます。

Adobe Target のデータをロード

接続を設定したら、CData JDBC Driver と接続情報を使用して、Adobe Target のデータをDataFrame としてロードできます。

ステップ2：データの読み取り

remote_table = spark.read.format ( "jdbc" ) \
	.option ( "driver" , driver) \
	.option ( "url" , url) \
	.option ( "dbtable" , "Activities") \
	.load ()

Adobe Target のデータを表示

ロードしたAdobe Target のデータをdisplay 関数を呼び出して確認します。

ステップ3：結果の確認

display (remote_table.select ("Id"))

Databricks でAdobe Target のデータを分析

Databricks SparkSQL でデータを処理するには、ロードしたデータをTemp View として登録します。

ステップ4：ビューまたはテーブルを作成

remote_table.createOrReplaceTempView ( "SAMPLE_VIEW" )

Temp View を作成したら、SparkSQL を使用してAdobe Target のデータをレポート、ビジュアライゼーション、分析用に取得できます。

% sql

SELECT Id, Name FROM SAMPLE_VIEW ORDER BY Name DESC LIMIT 5

Adobe Target からのデータは、対象のノートブックでのみ利用可能です。他のユーザーと共有したい場合は、テーブルとして保存します。

remote_table.write.format ( "parquet" ) .saveAsTable ( "SAMPLE_TABLE" )

CData JDBC Driver for Adobe Target の30日間無償トライアルをダウンロードして、Databricks でリアルタイムAdobe Target のデータの操作をはじめましょう。ご不明な点があれば、サポートチームにお問い合わせください。