Connect Aqua Data Studio to Query Service

This document covers the steps for connecting Aqua Data Studio with Adobe Experience Platform Query Service.

Getting started

This guide requires you to already have access to Aqua Data Studio and be familiar with how to navigate its interface. More information about Aqua Data Studio can be found in the official Aqua Data Studio documentation.

NOTE

There are Windows and macOS versions of Aqua Data Studio. Screenshots in this guide were taken using the macOS desktop app. There may be minor discrepancies in the UI between the versions.

To acquire the necessary credentials for connecting Aqua Data Studio to Experience Platform, you must have access to the Queries workspace in the Platform UI. Please contact your IMS Organization administrator if you do not currently have access to the Queries workspace.

Register the server

After installing Aqua Data Studio, you must first register the server. From the main menu, select Server, followed by Register Server.

The Server dropdown menu with Register Server highlighted.

The Register Server dialog appears. Under the General tab, select PostgreSQL from the list on the left-hand side. In the dialog that appears, provide the following details for the server settings.

Name: The name of your connection. You are recommended to provide a friendly name to recognize the connection.
Login Name: The login name is your Platform Organization ID. It takes the form of ORG_ID@AdobeOrg.
Password: This is an alphanumeric string found on the Query Service credentials dashboard.
Host and Port: The host endpoint and its port for Query Service. You must use port 80 to connect with Query Service.
Database: The database that will be used. Use the value for the Platform UI credential dbname: prod:all.

The Aqua Data Studio General tab with the required input fields highlighted.

Query Service credentials

To find your credentials, log in to the Platform UI and select Queries from the left navigation, followed by Credentials. For complete directions to find your login credentials, host, port, and database name, please read the credentials guide.

Query Service also offers non-expiring credentials to allow for a one-time setup with third-party clients. See the documentation for full instructions on how to generate and use non-expiring credentials.

Setting SSL mode

Next, select the Driver tab. Under Parameters, set the value as ?sslmode=require

IMPORTANT

See the Query Service SSL documentation to learn about SSL support for third-party connections to Adobe Experience Platform Query Service, and how to connect using verify-full SSL mode.

The Aqua Data Studio Driver tab with the Parameters field highlighted.

After inputting your connection details, select Test Connection to ensure your credentials work properly. If your connection test is successful, select Save to register your server. A confirmation dialog appears confirming connection and the connection appears on the dashboard. You can now connect to the server and view its schema objects.

Next steps

Now that you have connected to Query Service, you can use the Query Analyzer within Aqua Data Studio to execute and edit SQL statements. For more information on how to write and run queries, please read the running queries guide.