接続と検証

1. Experience Platform Query Service UIから必要な資格情報とパラメーターにアクセスします。

   1. Experience Platform サンドボックスに移動します。

   2. 左側のパネルから「 クエリ」を選択します。

   3. クエリ インターフェイスで「資格情報」タブを選択します。

   4. 「データベース」ドロップダウンメニューから「prod:cja」を選択します。

      

2. Power BI Desktopを起動します。

   1. メインインターフェイスから、他のソースからデータを取得​を選択します。

   2. データを取得 ダイアログで、次の操作を行います。
      

      1. PostgreSQL データベース​を検索して選択します。
      2. Connect​を選択します。

   3. PostgreSQL データベース ダイアログで、次の操作を行います。
      

      1. を使用して、Host​および​ Port ​の値をExperience Platform Query 期限切れ資格情報 パネルからコピーして貼り付けます。このパネルは、Server​の値として:で区切られています。 例：examplecompany.platform-query.adobe.io:80。
      2. を使用して、Experience Platform Query 期限切れの資格情報 パネルから​ Database ​値をコピーして貼り付けます。 貼り付ける値に?FLATTENを追加します。 例：prod:cja?FLATTEN。
      3. DirectQuery​を​ データ接続モード ​として選択します。
      4. OK​を選択します。

   4. PostgreSQL データベース - データベース ダイアログで、次の操作を行います。
      

      1. を使用して、ユーザー名​および​パスワード フィールドのExperience Platform クエリ 期限切れ資格情報 パネルから​ ユーザー名 ​および​ パスワード ​の値をコピーします。 有効期限のない資格情報を使用している場合は、有効期限のない資格情報のパスワードを使用します。
      2. これらの設定を​に適用するレベルを選択するドロップダウンメニューが、前に定義した​ サーバー ​に設定されていることを確認します。
      3. Connect​を選択します。

   5. ナビゲーター ダイアログで、データビューが取得されます。この取得には時間がかかる場合があります。取得すると、Power BI デスクトップに次が表示されます。
      

      1. 左側のパネルのリストから​ public.cc_data_view ​を選択します。

      2. 選択肢は次の2つです。

         1. 「読み込み」を選択して続行し、設定を完了します。
         2. 「データを変換」を選択します。オプションで設定の一部として変換を適用できるダイアログが表示されます。
            
            • 閉じて適用​を選択します。

   6. しばらくすると、public.cc_data_view​が​Data ペインに表示されます。 を選択して、ディメンションと指標を表示します。
      

平らにするか否か

Power BI Desktopは、FLATTEN パラメーターに対して次のシナリオをサポートしています。 詳しくは、​ ネストされたデータの統合を参照してください。

table 0-row-4 1-row-4 2-row-4 3-row-4 3-align-center 8-align-center 13-align-center 18-align-center
FLATTEN パラメーター	例	サポート	備考
なし	prod:cja
?FLATTEN	prod:cja?FLATTEN		使用する推奨オプション！
%3FFLATTEN	prod:cja%3FFLATTEN		Power BI デスクトップにエラーが表示されます：指定された資格情報で認証できませんでした。 もう一度やり直してください。

詳細情報

• 前提条件
• 資格情報ガイド
• Power BIをQuery Serviceに接続。

1. Experience Platform Query Service UIから必要な資格情報とパラメーターにアクセスします。

   1. Experience Platform サンドボックスに移動します。

   2. 左側のパネルから「 クエリ」を選択します。

   3. クエリ インターフェイスで「資格情報」タブを選択します。

   4. 「データベース」ドロップダウンメニューから「prod:cja」を選択します。

      

2. Tableauを起動します。

   1. の下の左側のパネルから​​ PostgreSQL ​​ を選択して、サーバー ​に移動します。利用できない場合は、その他…​を選択し、インストール済みコネクタ​から​ PostgreSQL ​を選択します。
      

   2. PostgreSQL ダイアログの「一般」タブ：
      

      1. を使用して、ホスト​をExperience Platform クエリ 期限切れ資格情報 パネルから​ サーバー ​にコピーして貼り付けます。
      2. を使用して、ポート​をExperience Platform クエリ 期限切れ資格情報 パネルから​ ポート ​にコピーして貼り付けます。
      3. を使用して、データベース​をExperience Platform クエリ 期限切れ資格情報 パネルから​ データベース ​にコピーして貼り付けます。 貼り付ける値に%3FFLATTENを追加します。 例：prod:cja%3FFLATTEN。
      4. 「認証」ドロップダウンメニューから「ユーザー名とパスワード」を選択します。
      5. を使用して、ユーザー名​をExperience Platform クエリ 期限切れ資格情報 パネルから​ ユーザー名 ​にコピーして貼り付けます。
      6. を使用して、パスワード​をExperience Platform クエリ 期限切れ資格情報 パネルから​ パスワード ​にコピーして貼り付けます。 有効期限のない資格情報を使用している場合は、有効期限のない資格情報のパスワードを使用します。
      7. 「SSLを必要とする」がオンになっていることを確認します。
      8. 「ログイン」を選択します。

      Tableau Desktopが接続を検証する間、進行状況リクエスト ダイアログが表示されます。

   3. メインウィンドウの左側のペインに​Data Source ページが表示されます。

      • Connections​の下にある接続の名前。
      • データベース名（Database​の下）。
      • Table​の下にあるテーブルのリスト。
        
      1. cc_data_view エントリをドラッグし、テーブルをドラッグ​と読み取れるメインビューにエントリをここにドロップします。

   4. メインウィンドウには、cc_data_view データビューの詳細が表示されます。
      

平らにするか否か

Tableau Desktopは、FLATTEN パラメーターに対して次のシナリオをサポートしています。 詳しくは、​ ネストされたデータの統合を参照してください。

table 0-row-4 1-row-4 2-row-4 3-row-4 3-align-center 8-align-center 13-align-center 18-align-center
FLATTEN パラメーター	例	サポート	備考
なし	prod:cja
?FLATTEN	prod:cja?FLATTEN
%3FFLATTEN	prod:cja%3FFLATTEN		使用するオプションをお勧めします。 注意：%3FFLATTENは?FLATTENのURL エンコード版です。

詳細情報

• 前提条件
• 資格情報ガイド
• Tableau Desktopをクエリ サービスに接続。

1. Experience Platform Query Service UIから必要な資格情報とパラメーターにアクセスします。

   1. Experience Platform サンドボックスに移動します。

   2. 左側のパネルから「 クエリ」を選択します。

   3. クエリ インターフェイスで「資格情報」タブを選択します。

   4. 「データベース」ドロップダウンメニューから「prod:cja」を選択します。

      

2. Lookerにログイン

   1. 左側のパネルから「管理」を選択します。

   2. 「接続」を選択します。

   3. 「接続を追加」を選択します。

   4. Looker画面にデータベースを接続​します。

      

      1. 接続の​ 名前 ​を入力します（例：Example Looker Connection）。
      2. すべてのプロジェクト​が​ 接続スコープ ​として選択されていることを確認します。
      3. ダイアレクトとして​ PostgreSQL 9.5+ ​を選択します。
      4. を使用して、Experience Platform Query 資格情報の有効期限 パネルから​ Host ​値を​ Host ​の値としてコピーして貼り付けます。 例：examplecompany.platform-query.adobe.io。
      5. を使用して、Experience Platform Query 資格情報の有効期限 パネルから​ Port ​値を​ Port ​の値としてコピーして貼り付けます。 例：80。
      6. を使用して、Experience Platform Query 期限切れ資格情報 パネルから​ Database ​値を​ Database ​の値としてコピーして貼り付けます。 貼り付ける値に%3FFLATTENを追加します。 例：prod:cja%3FFLATTEN。
      7. を使用して、Experience Platform Query 期限切れ資格情報 パネルから​ Username ​値を​ Username ​の値としてコピーして貼り付けます。
      8. を使用して、Experience Platform Query 期限切れ資格情報 パネルの​ Password ​値を​ Password ​の値としてコピーして貼り付けます。
      9. すべて展開​を​ オプション設定 ​で選択します。
      10. ノードごとの​ 最大接続 ​を5に設定します。
      11. SSL​が有効になっていることを確認します。
      12. 接続をテストするには、テスト​を選択します。 「成功、JDBCを接続できます」などのメッセージが表示されたバナーが画面の上部に表示さ…ます。
      13. 接続を確立して保存するには、接続​を選択します。

   5. 新しい接続が​Connections インターフェイスに表示されます。

   6. 管理者​から​ ← ​を選択して、左側のパネルのメインナビゲーションに移動します。

   7. 現像​を選択します。

   8. プロジェクト​を選択します。

   9. LookML プロジェクトで「新しいモデル」を選択します。

   10. ほかのユーザーに影響を与えないようにすることができます。 プロンプトが表示されたら、「開発モードに入る」を選択します。

   11. Create Model エクスペリエンス：

       1. ➊で「データベース接続」を選択します。

          1. データベース接続を選択​します。 例：example_looker_connection。
          2. でプロジェクトに名前を付けます。このモデル用に新しいLookML プロジェクトを作成します。 example: example_looker_projectの場合。
          3. 「次へ」を選択します。

       2. ➋でテーブルを選択:

          1. public​を選択し、Customer Journey Analytics データビューが選択されていることを確認します。 例： cc_data_view。
          2. 「次へ」を選択します。

       3. ➌でプライマリキーを選択:

          1. 「次へ」を選択します。

       4. ➍で「作成するエクスプローラー」を選択:

          1. ビューを選択します。 例：cc_data_view.view。
          2. 「次へ」を選択します。

       5. ➎にモデル名​と入力します。

          1. モデルに名前を付けます。 例：example_looker_model。

       6. 「完了してデータを探索」を選択します。

   Lookerの​Explore インターフェイスにリダイレクトされ、データを探索する準備が整います。

平らにするか否か

Lookerは、FLATTEN パラメーターに対して次のシナリオをサポートしています。 詳しくは、​ ネストされたデータの統合を参照してください。

table 0-row-4 1-row-4 2-row-4 3-row-4 3-align-center 8-align-center 13-align-center 18-align-center
FLATTEN パラメーター	例	サポート	備考
なし	prod:cja
?FLATTEN	prod:cja?FLATTEN
%3FFLATTEN	prod:cja%3FFLATTEN		使用するオプションをお勧めします。 注意：%3FFLATTENは?FLATTENのURL エンコード版です。

詳細情報

• 前提条件
• 資格情報ガイド

1. Experience Platform Query Service UIから必要な資格情報とパラメーターにアクセスします。

   1. Experience Platform サンドボックスに移動します。

   2. 左側のパネルから「 クエリ」を選択します。

   3. クエリ インターフェイスで「資格情報」タブを選択します。

   4. 「データベース」ドロップダウンメニューから「prod:cja」を選択します。

      

2. Jupyter Notebook環境を実行するための専用のPython仮想環境を設定していることを確認します。

3. 必要なライブラリが仮想環境にインストールされていることを確認します。

   • ipython-sql: pip install ipython-sql。
   • psycopg2-binary: pip install psycopg-binary。
   • sqlalchemy: pip install sqlalchemy。

4. 仮想環境からJupyter Notebookを開始：jupyter notebook。

5. 新しいノートブックを作成するか、このサンプル ノートブック ​をダウンロードします。

6. 最初のセルに、次のように入力して実行します。

   code language-none
   %config SqlMagic.style = '_DEPRECATED_DEFAULT'

7. 新しいセルに、接続の設定パラメーターを入力します。 を使用して、Experience Platform クエリ 期限切れ資格情報 パネルから設定パラメーターに必要な値をコピーして貼り付けます。 次に例を示します。

   code language-none

   import ipywidgets as widgets from IPython.display import display config_host = widgets.Text(description='Host:', value='example.platform-query-stage.adobe.io', layout=widgets.Layout(width="600px")) display(config_host) config_port = widgets.IntText(description='Port:', value=80, layout=widgets.Layout(width="200px")) display(config_port) config_db = widgets.Text(description='Database:', value='prod:cja', layout=widgets.Layout(width="300px")) display(config_db) config_username = widgets.Text(description='Username:', value='EC582F955C8A79F70A49420E@AdobeOrg', layout=widgets.Layout(width="600px")) display(config_username) config_password = widgets.Password(description='Password:', value='***', layout=widgets.Layout(width="600px")) display(config_password)

8. セルを実行します。

9. を使用して、Experience Platform クエリ 期限切れ資格情報 パネルからJupyter Notebookの​Password フィールドにパスワードをコピーして貼り付けます。

   

10. 新しいセルにステートメントを入力して、SQL拡張機能、必要なライブラリを読み込み、Customer Journey Analyticsに接続します。

    code language-python
    %load_ext sql from sqlalchemy import create_engine %sql postgresql://{config_username.value}:{config_password.value}@{config_host.value}:{config_port.value}/{config_db.value}?sslmode=require

    シェルを実行します。 出力は表示されませんが、セルは警告なしで実行されます。

    

11. 新しい呼び出しで、ステートメントを入力して、接続に基づいて使用可能なデータビューのリストを取得します。

    code language-python

    %%sql SELECT n.nspname as "Schema", c.relname as "Name", CASE c.relkind WHEN 'r' THEN 'table' WHEN 'v' THEN 'view' WHEN 'm' THEN 'materialized view' WHEN 'i' THEN 'index' WHEN 'S' THEN 'sequence' WHEN 's' THEN 'special' WHEN 't' THEN 'TOAST table' WHEN 'f' THEN 'foreign table' WHEN 'p' THEN 'partitioned table' WHEN 'I' THEN 'partitioned index' END as "Type", pg_catalog.pg_get_userbyid(c.relowner) as "Owner" FROM pg_catalog.pg_class c LEFT JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace WHERE c.relkind IN ('v','') AND n.nspname <> 'pg_catalog' AND n.nspname !~ '^pg_toast' AND n.nspname <> 'information_schema' AND pg_catalog.pg_table_is_visible(c.oid) AND c.relname NOT LIKE '%test%' AND c.relname NOT LIKE '%ajo%' ORDER BY 1,2;

    シェルを実行します。 以下のスクリーンショットに似た出力が表示されるはずです。

    

    データビューのリストに​ cc_data_view ​が表示されます。

平らにするか否か

Jupyter Notebookは、FLATTEN パラメーターに対して次のシナリオをサポートしています。 詳しくは、​ ネストされたデータの統合を参照してください。

table 0-row-4 1-row-4 2-row-4 3-row-4 3-align-center 8-align-center 13-align-center 18-align-center
FLATTEN パラメーター	例	サポート	備考
なし	prod:cja
?FLATTEN	prod:cja?FLATTEN
%3FFLATTEN	prod:cja%3FFLATTEN		使用するオプションをお勧めします。 注意：%3FFLATTENは?FLATTENのURL エンコード版です。

詳細情報

• 前提条件
• 資格情報ガイド

1. Experience Platform Query Service UIから必要な資格情報とパラメーターにアクセスします。

   1. Experience Platform サンドボックスに移動します。

   2. 左側のパネルから「 クエリ」を選択します。

   3. クエリ インターフェイスで「資格情報」タブを選択します。

   4. 「データベース」ドロップダウンメニューから「prod:cja」を選択します。

      

2. RStudioを起動します。

3. 新しいR Markdown ファイルを作成するか、このR Markdown ファイルの例をダウンロードします。

4. 最初のチャンクに、次のステートメントを入力します。 を使用して、Experience Platform クエリ 期限切れ資格情報 パネルから値をコピーして、host、dbname、userなど、様々なパラメーターに必要な値に貼り付けます。 次に例を示します。

   code language-r

   library(rstudioapi) library(DBI) library(dplyr) library(tidyr) library(RPostgres) library(ggplot2) host <- rstudioapi::showPrompt(title = "Host", message = "Host", default = "orangestagingco.platform-query-stage.adobe.io") dbname <- rstudioapi::showPrompt(title = "Database", message = "Database", default = "prod:cja?FLATTEN") user <- rstudioapi::showPrompt(title = "Username", message = "Username", default = "EC582F955C8A79F70A49420E@AdobeOrg") password <- rstudioapi::askForPassword(prompt = "Password")

5. チャンクを実行します。 ホスト、データベース、ユーザー​の入力を求められます。 前の手順で指定した値を受け入れるだけです。

6. を使用して、Experience Platform クエリ 期限切れ資格情報 パネルからRStudioの​パスワード ダイアログプロンプトにパスワードをコピーして貼り付けます。

   

7. 新しいチャンクを作成し、次のステートメントを入力します。

   code language-r
   con <- dbConnect( RPostgres::Postgres(), host = host, port = 80, dbname = dbname, user = user, password = password, sslmode = 'require' )

8. チャンクを実行します。 接続が成功した場合は、出力が表示されません。

9. 新しいチャンクを作成し、次のステートメントを入力します。

   code language-r
   views <- dbListTables(con) print(views)

10. チャンクを実行します。 character(0)が唯一の出力として表示されます。

11. 新しいチャンクを作成し、次のステートメントを入力します。

    code language-r
    glimpse(dv)

12. チャンクを実行します。 以下のスクリーンショットに似た出力が表示されるはずです。

    

平らにするか否か

RStudioは、FLATTEN パラメーターに対して次のシナリオをサポートしています。 詳しくは、​ ネストされたデータの統合を参照してください。

table 0-row-4 1-row-4 2-row-4 3-row-4 3-align-center 8-align-center 13-align-center 18-align-center
FLATTEN パラメーター	例	サポート	備考
なし	prod:cja
?FLATTEN	prod:cja?FLATTEN		使用するオプションをお勧めします。
%3FFLATTEN	prod:cja%3FFLATTEN

詳細情報

• 前提条件
• 資格情報ガイド