Connect your Phoenix account to Experience Platform using the UI

This tutorial provides steps on how to connect your Phoenix account and bring data from your Phoenix database to Experience Platform.

Getting started

This tutorial requires a working understanding of the following components of Adobe Experience Platform:

If you already have an authenticated Phoenix account, then you may skip the remainder of this document and proceed to the tutorial on configuring a dataflow for a database.

Gather required credentials

In order to access your Phoenix account on Experience Platform, you must provide the following values:

The IP address or hostname of the Phoenix server.
The TCP port that the Phoenix server uses to listen for client connections. If you are connecting to Azure HDInsights, then specify the port as 443. If this parameter is unprovided, the value defaults to 8765.
The partial URL corresponding to the Phoenix server. Specify /hbasephoenix0 if you are using the Azure HDInsights cluster.
The username that you use to access the Phoenix server.
The password that corresponds to the user.
Enable SSL
A toggle that specifies whether the connections to the server are encrypted using SSL.

For more information about getting started, refer to this Phoenix document.

Once you have gathered your required credentials, you can follow the steps below to connect your Phoenix account to Experience Platform.

Connect your Phoenix account

In the Platform UI, select Sources from the left navigation to access the sources workspace. The Catalog screen displays a variety of sources available in the Experience Platform sources catalog.

You can select the appropriate category from the catalog on the left-hand side of your screen. Alternatively, you can find a specific source using the search option.

Select Databases from the list of sources categories and then select Add data from the Phoenix card.

Sources in the sources catalog may display different prompts depending on the status of the source.
  • Add data means that there are existing authenticated accounts associated with your selected source.

  • Set up means that you must provide credentials and authenticate a new account in order to use your selected source.

The sources catalog on the Experience Platform UI with the Phoenix source card selected.

The Connect to Phoenix page appears. On this page, you can either use new credentials or existing credentials.

Use an existing Phoenix account

To use an existing account, select Existing account and then select the account that you want to use from the list that appears. When finished, select Next to proceed.

A list of authenticated Phoenix database accounts that already exist in your organization.

Create a new Phoenix account

To use a new account, select New account and provide a name, description, and your Phoenix authentication credentials. When finished, select Connect to source and allow for a few seconds for the new connection to establish.

The new account interface where you can provide authentication credentials and create a Phoenix account.

Next steps

By following this tutorial, you have established a connection to your Phoenix account. You can now continue on to the next tutorial and configure a dataflow to bring data into Experience Platform.