クエリサービスへの RStudio の接続

このドキュメントでは、RStudio とAdobe Experience Platform Query Service を接続する手順について説明します。

NOTE
RStudio は現在、Posit としてリブランドされています。 RStudio 製品の名前は、Posit Connect、Posit Workbench、Posit Package Manager、Posit Cloud、Posit Academy に変更されました。
このガイドは、RStudio へのアクセス権を既に持ち、使用方法に精通していることを前提としています。 RStudio について詳しくは、official RStudio documentation を参照してください。
さらに、クエリサービスで RStudio を使用するには、PostgreSQL JDBC 4.2 ドライバーをインストールする必要があります。 JDBC ドライバーは、PostgreSQL 公式サイトからダウンロードできます。

RStudio インターフェイスでの Query Service 接続の作成

RStudio をインストールしたら、RJDBC パッケージをインストールする必要があります。 コマンドラインを使用してデータベースを接続する方法については、公式の Post ドキュメントを参照してください。

Mac OS を使用している場合は、メニューバーから ツール を選択し、その後ドロップダウンメニューから パッケージをインストール を選択できます。 または、RStudio UI から「Packages」タブを選択し、「Install」を選択します。

ポップアップが表示され、Install Packages 画面が表示されます。 Install from セクションに Repository (CRAN) が選択されていることを確認します。 Packages の値は RJDBC にしてください。 「Install dependencies」が選択されていることを確認します。 すべての値が正しいことを確認したら、「Install」を選択してパッケージをインストールします。 RJDBC パッケージがインストールされたので、RStudio を再起動してインストールプロセスを完了します。

再起動 RStudio たら、クエリサービスに接続できます。 Packages ペインで RJDBC パッケージを選択し、コンソールに次のコマンドを入力します。

pgsql <- JDBC("org.postgresql.Driver", "{PATH TO THE POSTGRESQL JDBC JAR}", "`")

{PATH TO THE POSTGRESQL JDBC JAR} は、コンピューターにインストールされた PostgreSQL JDBC JAR へのパスを表します。

これで、クエリサービスへの接続を作成できます。 コンソールに次のコマンドを入力します。

qsconnection <- dbConnect(pgsql, "jdbc:postgresql://{HOSTNAME}:{PORT}/{DATABASE_NAME}?user={USERNAME}&password={PASSWORD}&sslmode=require")
IMPORTANT
Adobe Experience Platform クエリサービスへのサードパーティ接続での SSL サポートと、SSL モードを使用した接続方法については、Query Service SSL ドキュメントを参照し verify-full ください。

データベース名、ホスト、ポートおよびログイン資格情報の検索について詳しくは、 資格情報ガイドを参照してください。 資格情報を見つけるには、Platform にログインし、「クエリ」を選択してから、「資格情報 を選択します。

コンソール出力内のメッセージで、クエリサービスへの接続を確認します。

クエリの記述

Query Service に接続したので、SQL 文を実行および編集するクエリを記述できます。 たとえば、dbGetQuery(con, sql) を使用してクエリを実行できます。ここで、sql は実行する SQL クエリです。

次のクエリでは、 エクスペリエンスイベントを含むデータセットを使用し、デバイスの画面の高さを考慮して、web サイトのページビューのヒストグラムを作成します。

df_pageviews <- dbGetQuery(con,
"SELECT t.range AS buckets,
 Count(*) AS pageviews
FROM (SELECT CASE
 WHEN device.screenheight BETWEEN 0 AND 99 THEN '0 - 99'
 WHEN device.screenheight BETWEEN 100 AND 199 THEN '100-199'
 WHEN device.screenheight BETWEEN 200 AND 299 THEN '200-299'
 WHEN device.screenheight BETWEEN 300 AND 399 THEN '300-399'
 WHEN device.screenheight BETWEEN 400 AND 499 THEN '400-499'
 WHEN device.screenheight BETWEEN 500 AND 599 THEN '500-599'
 ELSE '600-699'
 end AS range
 FROM aa_post_vals_3) t
GROUP BY t.range
ORDER BY buckets
LIMIT 1000000")

成功応答は、クエリの結果を返します。

df_pageviews
 buckets pageviews
1 0 - 99 198985
2 500-599 67138
3 300-399 2147
4 200-299 354
5 400-499 6947
6 100-199 4415
7 600-699 3097040

次の手順

クエリの作成および実行方法について詳しくは、 クエリの実行に関するガイドを参照してください。

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb