クエリサービスへの Aqua Data Studio の接続

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

はじめに

このガイドでは、既にAqua Data Studioへのアクセス権があり、そのインターフェイスを操作する方法に精通している必要があります。 Aqua Data Studioの詳細については、公式 Aqua Data Studio ドキュメント ​を参照してください。

NOTE
Aqua Data StudioにはWindowsとmacOSのバージョンがあります。 このガイドのスクリーンショットは、macOS デスクトップアプリを使用して撮影されました。 バージョン間でUIにわずかな相違がある場合があります。

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

サーバーの登録 register-server

Aqua Data Studioをインストールした後、まずサーバーを登録する必要があります。 ​ ダイアログを起動 Register Server しおよび​ サーバーを登録する方法については、Aqua Data Studioの公式ドキュメントを参照してください。

PostgresSQL サーバーの​Register Server ダイアログが表示されたら、サーバー設定に次の詳細を入力します。

  • Name:接続の名前。 接続を認識するためのわかりやすい名前を指定することをお勧めします。
  • Login Name: ログイン名はExperience Platform Organization IDです。 ORG_ID@AdobeOrgの形式になります。
  • Password:これは、Query Service資格情報ダッシュボードで見つかった英数字の文字列です。
  • Host and Port: Query Serviceのホストエンドポイントとそのポート。 Query Serviceに接続するには、ポート 80を使用する必要があります。
  • Database:​使用されるデータベース。 Experience Platform UI資格情報dbnameの値を使用:prod:all

Query Service資格情報

資格情報を見つけるには、Experience Platform UIにログインし、左側のナビゲーションから​ クエリ ​を選択し、次に​ 資格情報 ​を選択します。 ログイン資格情報、ホスト、ポート、データベース名を見つけるための完全な手順については、資格情報ガイド ​を参照してください。

Query Serviceは、サードパーティのクライアントとの1回限りのセットアップを可能にするために、有効期限のない資格情報も提供しています。 有効期限のない資格情報を生成して使用する方法については、完全な手順のドキュメントを参照してください。

SSL モードの設定

次に、SSL モードの値を?sslmode=requireに設定する必要があります。 これは、Edit Server Properties ダイアログの「Driver」タブから行います。 ドライバーのプロパティを編集およびSSLを PostgreSQLに設定する方法については、Aqua Data Studioの公式ドキュメントを参照してください。 検索バーを使用して、sslmode プロパティを検索します。

IMPORTANT
Adobe Experience Platform Query Serviceへのサードパーティ接続のSSL サポートと、verify-full SSL モードを使用した接続方法については、Query Service SSL ドキュメント ​を参照してください。

接続の詳細を入力した後、同じタブから​ Test Connection ​を選択して、資格情報が正しく機能することを確認します。 接続テストが成功した場合は、Save​を選択してサーバーを登録します。 接続を確認する確認ダイアログが表示され、接続アイコンがダッシュボードに表示されます。 サーバーに接続し、そのスキーマオブジェクトを表示できるようになりました。

次の手順

Query Serviceに接続したので、Aqua Data Studio内の​ Query Analyzer ​を使用してSQL ステートメントを実行および編集できます。 クエリの書き込みおよび実行方法について詳しくは、『クエリ実行ガイド』を参照してください。

recommendation-more-help
experience-platform-help-query-service