DbVisualizerをQuery Serviceに接続 connect-dbvisualizer

このドキュメントでは、DbVisualizer データベースツールをAdobe Experience Platform Query Serviceに接続する手順について説明します。

はじめに

このガイドでは、DbVisualizer Desktop アプリに既にアクセスしており、そのインターフェイスの操作方法に精通している必要があります。DbVisualizer デスクトップアプリをダウンロードするか、詳細については、公式 DbVisualizer ドキュメント ​を参照してください。

​ DbVisualizerをExperience Platformに接続するために必要な資格情報を取得するには、Experience Platform UIのQueries ワークスペースにアクセスする必要があります。 現在クエリワークスペースにアクセスできない場合は、組織管理者にお問い合わせください。

データベース接続の作成 connect-database

デスクトップアプリケーションをローカルマシンにインストールしたら、BDVisualizerの公式な手順に従って新しいデータベース接続を作成します

PostgreSQL リストからConnectionsを選択すると、新しいObject View接続のPostgreSQL タブが表示されます。

接続のドライバープロパティの設定 properties

「PostgreSQL オブジェクト表示」タブから、「Properties」タブを選択し、ナビゲーションサイドバーから「Driver Properties」を選択します。 ​ ドライバーのプロパティ ​の詳細については、公式ドキュメントを参照してください。

次に、以下の表に記載されているドライバプロパティを入力します。

IMPORTANT
DBVisualizerとAdobe Experience Platformを接続するには、SSLの使用を有効にする必要があります。 Adobe Experience Platform Query Serviceへのサードパーティ接続に対するSSL サポートと、​ SSL モードを使用して接続する方法については、SSL モードのドキュメント verify-fullを参照してください。
プロパティ
説明
PGHOST
PostgreSQL サーバーのホスト名。 この値は、Experience Platform Host資格情報​です。
ssl
SSLの使用を有効にするには、SSL値1を定義します。
sslmode
これにより、SSL保護のレベルが制御されます。 サードパーティのクライアントをAdobe Experience Platformに接続する場合は、require SSL モードを使用することをお勧めします。 require モードでは、すべての通信で暗号化が必要であり、ネットワークが正しいサーバーに接続するように信頼されていることを確認します。 サーバーSSL証明書の検証は必要ありません。
user
データベースに接続されているユーザー名は、組織IDです。 @Adobe.Orgで終わる英数字の文字列です。 この値は、Experience Platform Username資格情報​です。

検索バーを使用して各プロパティを検索し、パラメーターの値に対応するセルを選択します。 セルが青色でハイライトされます。 値フィールドにExperience Platform資格情報を入力し、Apply​を選択してドライバープロパティを追加します。

NOTE
2番目のuser プロファイルを追加するには、パラメーター列からuserを選択し、青い+(プラス)アイコンを選択して各ユーザーの資格情報を追加します。 ドライバーのプロパティを追加するには、Apply​を選択します。

Edited列には、パラメーター値が更新されたことを示すチェックマークが表示されます。

入力クエリサービス資格情報 query-service-credentials

BBVisualizerとQuery Serviceの接続に必要な資格情報を見つけるには、Experience Platform UIにログインし、左側のナビゲーションから「Queries」を選択し、その後「Credentials」を選択します。 ホストポートデータベースユーザー名​および​ パスワード ​の資格情報の検索について詳しくは、資格情報ガイド ​を参照してください。

資格情報と期限切れの資格情報がハイライト表示されたExperience Platform Queries ワークスペースの資格情報ページ。

IMPORTANT
Query Serviceは、サードパーティのクライアントとの1回限りのセットアップを可能にするために、有効期限のない資格情報も提供しています。 有効期限のない資格情報を生成して使用する方法については、完全な手順のドキュメントを参照してください。 BDVisualizerを1回限りのセットアップとして接続する場合は、このプロセスを完了する必要があります。 取得したcredentialおよびtechnicalAccountId値は、DBVisualizer password パラメーターの値を含みます。

認証 authentication

接続が確立されるたびにユーザーIDとパスワードベースの認証を要求するには、Properties タブに移動し、Authentication​の下にあるナビゲーションサイドバーからPostgreSQLを選択します。

接続認証パネルで、Require Userid​と​ Require Password ​の両方のチェックボックスをオンにし、Apply​を選択します。 認証オプションの設定の詳細については、公式ドキュメントを参照してください。

Experience Platformに接続

期限切れまたは期限切れでない資格情報を使用して接続を行うことができます。 接続を行うには、「Connection オブジェクト表示」タブから「PostgreSQL」タブを選択し、次の設定にExperience Platformの資格情報を入力します。 手動での接続の設定に関する補足説明は、DBVisualizerの公式web サイトで入手できます。

NOTE
次の表のBDVisualizerで必要なすべての資格情報は、パラメーターの説明に記載されていない限り、期限切れと期限切れでない資格情報に対しては同じです。
接続パラメーター
説明
Name
接続の名前を作成します。 接続を認識するために、わかりやすい名前を付けることをお勧めします。
Database Server
これはExperience Platform Host​の資格情報です。
Database Port
Query Serviceのポート。 に接続するには、ポート 80 または 5432Query Serviceを使用する必要があります。
Database
Experience Platform Database​資格情報の値を使用してください:prod:all
Database Userid
これがExperience Platformの組織IDです。 Experience Platform Username​資格情報の値を使用します。 IDはORG_ID@AdobeOrgの形式になります。
Database Password
この英数字の文字列は、Experience Platform Password​の資格情報です。 期限切れでない資格情報を使用する場合、この値は、構成JSON ファイルにダウンロードされたtechnicalAccountIDcredentialの連鎖引数です。 パスワード値は次の形式になります:{technicalAccountId}:{credential}。 有効期限のない資格情報の設定JSON ファイルは、Adobeがコピーを保持しない初期化中に1回限りのダウンロードです。

関連するすべての資格情報を入力したら、Connect​を選択します。

Connect ダイアログは、セッションの最初の機会に表示されます。 ユーザーIDとパスワードを入力し、Connect​を選択します。 正常な接続を確認するためのメッセージがログに表示されます。

次の手順

DbVisualizerをQuery Serviceに接続したので、DbVisualizerを使用してクエリを作成できます。 クエリの作成方法と実行方法について詳しくは、​ クエリ実行に関するガイド ​を参照してください。

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