接続と検証

このユースケースでは、BI ツールからCustomer Journey Analyticsへの接続を設定し、使用可能なデータビューを一覧表示して、使用するデータビューを選択します。

Customer Journey Analytics

この手順では、次のオブジェクトを持つ環境例を参照しています。

  • データビュー:C&C - データビュー 🅐。
  • ディメンション:製品名 🅑 および 製品カテゴリ 🅒。
  • 指標:購入売上高🅓 および 購入 🅔。
  • フィルター:釣り製品 🅕。

Customer Journey Analytics ベースのセットアップ

ユースケースを確認したら、これらのサンプルオブジェクトを特定の環境に適したオブジェクトに置き換えます。

BI ツール
tabs
Power BI デスクトップ
  1. Experience Platform クエリサービス UI から必要な資格情報とパラメーターにアクセスします。

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

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

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

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

      クエリサービス資格情報

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

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

    2. データを取得 ダイアログで、次の手順を実行します。
      PowerBI PostgreSQL データベース

      1. PostgreSQL データベース を検索して選択します。
      2. 接続 を選択します。
    3. PostgreSQL データベース ダイアログで、次の手順を実行します。
      PowerBI デスクトップサーバーとデータベースの設定

      1. コピー を使用して、Experience Platformの クエリ有効期限が切れる資格情報 パネルの HostPort の値をコピーして貼り付け、:Server の値として で区切ります。 例:examplecompany.platform-query.adobe.io:80
      2. コピー を使用して、Experience Platformの クエリ有効期限が切れる資格情報 パネルから Database 値をコピー&ペーストします。 貼り付ける値に ?FLATTEN を追加します。 例:prod:cja?FLATTEN
      3. Data connectivity mode として DirectQuery を選択します。
      4. OK を選択します。
    4. PostgreSQL データベース - データベース ダイアログで、
      PowerBI デスクトップユーザーとパスワード

      1. コピー を使用して、ユーザー名 および パスワード フィールドのExperience Platform クエリ有効期限が切れる資格情報 パネルから ユーザー名 および パスワード の値をコピーします。 ​ 有効期限のない認証情報 ​ を使用している場合は、有効期限のない認証情報のパスワードを使用します。
      2. これらの設定を適用するレベルを選択 のドロップダウンメニューが、前に定義した サーバー に設定されていることを確認します。
      3. 接続 を選択します。
    5. ナビゲーター ダイアログで、データビューが取得されます。 この取得には時間がかかる場合があります。 取得すると、Power BI Desktop に以下が表示されます。
      Power BI Destkop 読み込みデータ

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

      2. 次の 2 つのオプションがあります。

        1. 読み込み を選択して続行し、設定を完了します。
        2. データを変換 を選択します。 オプションで設定の一部として変換を適用できるダイアログが表示されます。
          Power BI デスクトップ変換データ
          • 閉じて適用 を選択します。
    6. しばらくすると、public.cc_data_viewData ペインに表示されます。 ChevronRight を選択して、ディメンションと指標を表示します。
      Power BI Destkop サーバーのデータが読み込まれました

FLATTEN か NOT か

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 CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle 推奨されるオプションは次のとおりです。
%3FFLATTEN prod:cja%3FFLATTEN CloseCircle Power BI デスクトップに「指定された資格情報では認証できませんでした。 もう一度やり直してください。

詳細情報

Tableau Desktop
  1. Experience Platform クエリサービス UI から必要な資格情報とパラメーターにアクセスします。

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

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

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

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

      クエリサービス資格情報

  2. Tableau の起動

    1. To a Server の下の左パネルから「PostgreSQL」を選択します。 使用できない場合は、「その他…」を選択し、「インストールされているコネクタ」から「PostgreSQL」を選択します。
      Tableau コネクタ

    2. PostgreSQL ダイアログの 一般 タブで、次の操作を行います。
      Tableau へのログインダイアログ

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

      Tableau Desktop が接続を検証している間、要求の進行状況 ダイアログが表示されます。

    3. メインウィンドウの左側のペインには、「データSource」ページが表示されます。

      • 接続 の下の接続名。
      • Database の下のデータベースの名前。
      • Table の下のテーブルのリスト。
        Tableau Connected
      1. cc_data_view エントリをドラッグし、「テーブルをドラッグ」と表示されるメインビューにここにエントリをドロップします。
    4. メインウィンドウに、cc_data_view データビューの詳細が表示されます。
      Tableau Connected

FLATTEN か NOT か

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 CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle
%3FFLATTEN prod:cja%3FFLATTEN CheckmarkCircle 推奨されるオプション%3FFLATTEN は URL エンコードされたバージョンの ?FLATTEN であることに注意してください。

詳細情報

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

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

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

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

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

      クエリサービス資格情報

  2. Looker へのログイン

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

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

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

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

      Looker データベースへの接続

      1. 接続の 名前 を入力(例:Example Looker Connection
      2. 接続範囲 として「すべてのプロジェクト が選択されていることを確認 ます。
      3. ダイアレクトとして PostgreSQL 9.5 以上 を選択します。
      4. コピー を使用して、Experience Platformの クエリ有効期限が切れる資格情報 パネルの ホスト 値をコピーし、ホスト の値として貼り付けます。 例:examplecompany.platform-query.adobe.io
      5. コピー を使用して、Experience Platformの クエリ有効期限が切れる資格情報 パネルの Port 値をコピーして Port に貼り付けます。 例:80
      6. コピー を使用して、Experience Platformの クエリ有効期限が切れる資格情報 パネルの データベース 値をコピーして データベース に貼り付けます。 貼り付ける値に %3FFLATTEN を追加します。 例:prod:cja%3FFLATTEN
      7. コピー を使用して、Experience Platform クエリ有効期限が切れる資格情報 パネルの ユーザー名 値をコピーして ユーザー名 に貼り付けます。
      8. コピー を使用して、Experience Platform クエリ有効期限が切れる資格情報 パネルの パスワード 値をコピーして パスワード に貼り付けます。
      9. オプション設定すべて展開 を選択します。
      10. ノードごとの 最大接続数5 に設定します。
      11. SSL が有効になっていることを確認します。
      12. テスト」を選択して、接続をテストします。 画面の上部にバナーが表示され、「Success, can connect JDBC …のようなメッセージが表示されます
      13. 接続」を選択し、接続を確立して保存します。
    5. Connections インターフェイスに新しい接続が表示されます。

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

    7. 開発 を選択します。

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

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

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

    11. モデルを作成 エクスペリエンスで、次の操作を行います。

      1. データベース接続 ➊選択します

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

        1. 公開 を選択し、Customer Journey Analytics データビューが選択されていることを確認します。 例: SelectBox cc_data_view
        2. 次へ」を選択します。
      3. ➌でプライマリキーを選択し す。

        1. 次へ」を選択します。
      4. で、作成 ➍る探索を選択します

        1. 必ずビューを選択してください。 例:cc_data_view.view
        2. 次へ」を選択します。
      5. モデル名 ➎入力し す。

        1. モデルに名前を付けます。 例:example_looker_model
      6. データを入力して調査」を選択します。

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

FLATTEN か NOT か

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 CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle
%3FFLATTEN prod:cja%3FFLATTEN CheckmarkCircle 推奨されるオプション%3FFLATTEN は URL エンコードされたバージョンの ?FLATTEN であることに注意してください。

詳細情報

Jupyter Notebook
  1. Experience Platform クエリサービス 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 の パスワード フィールドにパスワードをコピー&ペーストします。

    Jupter Notebook 設定の手順 1

  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
    

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

    Jupyer Notebook 設定手順 4

  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;
    

    シェルを実行します。 以下のスクリーンショットに同様に出力が表示されます。

    Jupyter Notebook 設定の手順 5

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

FLATTEN か NOT か

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 CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CloseCircle
%3FFLATTEN prod:cja%3FFLATTEN CheckmarkCircle 推奨されるオプション%3FFLATTEN は URL エンコードされたバージョンの ?FLATTEN であることに注意してください。

詳細情報

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

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

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

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

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

      クエリサービス資格情報

  2. RStudio を起動します。

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

  4. 最初のチャンクでは、```{r}````の間に次のステートメントを入力します。 ![コピー][image5] を使用して、Experience Platform **クエリ** **資格情報の有効期限** パネルからhostdbnameuser` などの様々なパラメーターに必要な値にコピー&ペーストします。 次に例を示します。

    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. チャンクを実行します。 「Host」、「Database」、「User」の入力を求められます。 前の手順の一部として指定した値をそのまま使用します。

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

    RStudio 設定手順 1

  7. 新しいチャンクを作成し、``` {r} ~ ` の間に次のステートメントを入力してください。

    code language-r
    con <- dbConnect(
       RPostgres::Postgres(),
       host = host,
       port = 80,
       dbname = dbname,
       user = user,
       password = password,
       sslmode = 'require'
    )
    
  8. チャンクを実行します。 接続に成功した場合は、出力は表示されません。

  9. 新しいチャンクを作成し、``` {r} ~ ` の間に次のステートメントを入力してください。

    code language-r
    views <- dbListTables(con)
    print(views)
    
  10. チャンクを実行します。 character(0) が唯一の出力として表示されます。

  11. 新しいチャンクを作成し、``` {r} ~ ` の間に次のステートメントを入力してください。

    code language-r
    glimpse(dv)
    
  12. チャンクを実行します。 以下のスクリーンショットに同様に出力が表示されます。

    RStudio 構成の手順 2

FLATTEN か NOT か

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 CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle 推奨されるオプション
%3FFLATTEN prod:cja%3FFLATTEN CloseCircle

詳細情報

recommendation-more-help
080e5213-7aa2-40d6-9dba-18945e892f79