Connect to an Autonomous Data Warehouse

NetSuite Analytics Warehouse provides three ways to connect to an Autonomous Data Warehouse: Oracle Analytics Cloud Connector, Database Actions (SQL Developer Web), and SQL Developer desktop client.

The Oracle Analytics Cloud connector provides a way to query database objects for analysis, visualization, and reporting. You can query database objects by configuring Oracle Analytics Cloud datasets or writing SQL manually.

Database Actions (SQL Developer Web) and SQL Developer desktop client allow you to create, edit, and query database objects. You can also use them to perform administrative tasks such as creating users and database schemas and resetting passwords. These tools help you investigate, debug, and validate data.

Oracle recommends using Database Actions (SQL Developer Web) to leverage the modern cloud interface and its additional features.

Configure Autonomous Data Warehouse Credentials

You need to configure credentials of the OAX_USER and ADMIN users and download a wallet file to connect to an Autonomous Data Warehouse.

All connection methods initially require credentials for ADMIN and OAX_USER. You must reset these credentials annually, or configure them if you're performing this task for the first time.

The ADMIN can perform certain important tasks, such as changing OAX_USER's password, but can't see pipeline objects or data. The OAX_USER can browse and query pipeline objects and data. The following steps ensure that both users have correct credentials that you can use for connecting to an Autonomous Data Warehouse.

About Autonomous Data Warehouse Wallet and Administrator Credentials

The Autonomous Data Warehouse Wallet contains certificate keys for accessing your Autonomous Data Warehouse instance.

The client credentials .zip that you download contains the following files:

  • cwallet.sso - Oracle auto-login wallet.
  • ewallet.p12 - PKCS #12 wallet file associated with the auto-login wallet.
  • sqlnet.ora - SQL*Net profile configuration file that includes the wallet location and TNSNAMES naming method.
  • tnsnames.ora - The SQL*Net configuration file that contains network service names mapped to connect descriptors for the local naming method.
  • Java Key Store (JKS) files - Key store files for use with JDBC Thin connections.
  • README - Contains information about database tools and resources.

Note:

Wallet files, along with the database user ID and password, provide access to data in your Autonomous Data Warehouse. Store wallet files in a secure location. Share wallet files only with authorized users. If wallet files are transmitted in a way that might be accessed by unauthorized users (for example, over public email), transmit the wallet password separately and securely.

Reset the ADMIN User Password

Administrator credentials allow you to access and manage your Autonomous Data Warehouse. You can reset the ADMIN user's credentials, but if you reset the password, that might affect other users who log in as ADMIN.

  1. Sign in to NetSuite Analytics Warehouse.
  2. In Oracle NetSuite Analytics Warehouse Console, click Warehouse.
  3. On the Warehouse page, under Reset Autonomous Data Warehouse Credentials, click Reset Credentials.
  4. In Reset Credentials, select ADMIN in Username, provide and confirm the new password, and click Update.

    Reset Credentials dialog

Download the Autonomous Data Warehouse Wallet

The Autonomous Data Warehouse Wallet contains certificate keys for accessing your Autonomous Data Warehouse instance.

  1. Sign in to NetSuite Analytics Warehouse.
  2. Click Warehouse on the Console.
  3. On the Warehouse page, under ADW Wallet, click Download Wallet.
  4. In the Set Wallet Password dialog, provide a password to encrypt the keys inside the wallet, then click Download.
    For more information about wallet contents, see About Autonomous Data Warehouse Wallet and Administrator Credentials.

    Note:

    Wallet files, along with the database user ID and password, provide access to data in your Autonomous Data Warehouse. Store wallet files and the wallet password in a secure location. Share wallet files only with authorized users. If wallet files are transmitted in a way that might be accessed by unauthorized users (for example, over public email), then transmit the wallet password separately and securely.

Get the Database Actions URL

You need to locate the URL for Database Actions to be able to reset the OAX_USER's password.

  1. Unzip the downloaded wallet file, and open the README file in a text editor.
  2. Find and copy the URL ending with /sql-developer listed in the Database Actions section of the README file.
  3. Paste the URL in a browser, then sign in to the Database Actions web page.

Reset the OAX_USER Password

You need to reset the password for the OAX_USER before creating a connection to an Autonomous Data Warehouse.

  1. Sign in to NetSuite Analytics Warehouse.
  2. In Oracle NetSuite Analytics Warehouse Console, click Warehouse.
  3. On the Warehouse page, under Reset Autonomous Data Warehouse Credentials, click Reset Credentials.
  4. In Reset Credentials, select OAX_USER in Username, provide and confirm the new password, and click Update.

    Reset Credentials dialog displaying OAX_USER

Connect to an Autonomous Data Warehouse with Database Actions (SQL Developer Web)

Follow these steps to connect to Autonomous Data Warehouse with Database Actions (SQL Developer Web).

Query Tables for NetSuite Analytics Warehouse from Autonomous Data Warehouse as OAX_USER

Verify proper configuration of your Autonomous Data Warehouse connection by running a sample query.

  1. Sign in to Database Actions as OAX_USER.
  2. On the Development tab, click the SQL label to open SQL Developer Web. Select All Objects in the Objects dropdown.
    You should see all objects for OAX USER in the Navigator.
  3. Run this query to verify proper configuration:
    select * from DW_NS_ACCOUNT_D

Query the Autonomous Data Warehouse System Tables as ADMIN

Verify proper configuration of your Autonomous Data Warehouse connection by running a sample query.

  1. Sign in to Database Actions as ADMIN.
  2. On the Development tab, click the SQL label to open SQL Developer Web.
  3. Run this query to verify proper configuration:
    select sum(bytes)/1024/1024/1024/1024 as USED_STORAGE_TB from dba_segments
          where owner not in ('SSB', 'SH');

Connect to an Autonomous Data Warehouse with Oracle Analytics Cloud

Follow these steps to connect to an Autonomous Data Warehouse with Oracle Analytics Cloud.

Configure the Connection for OAX_USER in Oracle Analytics Cloud

You can connect to an Autonomous Data Warehouse with Oracle Analytics Cloud.

When you configure the connection, select the service name with the "low" prefix in its name. Connecting with the "high" or "medium" service might lead to performance issues in reports in NetSuite Analytics Warehouse and delays in completion of daily incremental data pipeline loads. See Database Service Names for Autonomous Transaction Processing and Autonomous JSON Database for more information.

  1. Sign in to your NetSuite Analytics Warehouse instance.
  2. Click Go to Home Page.
  3. Click Navigator and then Data.
  4. Click the Connections tab.
  5. On the Oracle Analytics page, click Create, click Connection, then click Oracle Autonomous Data Warehouse.
  6. Enter these values and then click Save:
    1. Connection Name: ADW - OAX_USER
    2. Description: ADW - OAX_USER
    3. Client Credentials: Click Select, then browse to select the wallet.zip file.
    4. Username: OAX_USER (default)
    5. Password: The OAX_USER password.
    6. Service Name: Select <service name>-low. Using low prevents pipeline conflicts.
  7. In the Connections tab, click the ellipsis icon to the right of the name of the connection you just created to open the Actions menu and click Inspect.
  8. Click Access and then Roles.
  9. Type ServiceAdmin in the Search By Name field, then click to add it.
  10. Click the Full Control radio button for the ServiceAdmin user.
  11. Click Save and then Close.

Create an Oracle Analytics Cloud Dataset

Verify proper configuration of your Oracle Analytics Cloud connection to the Autonomous Data Warehouse by creating a basic dataset.

Connect to an Autonomous Data Warehouse with SQL Developer Desktop Client

You can optionally use the SQL Developer desktop client to connect to Autonomous Data Warehouse. You need to configure credentials, and then set up connections for both ADMIN and OAX_USER.

Note:

Oracle recommends using Database Actions (SQL Developer Web) to leverage the modern cloud interface and its additional features.

Configure the Connection to Autonomous Data Warehouse for ADMIN with SQL Developer Desktop Client

You can use the SQL Developer desktop client to connect to Autonomous Data Warehouse. However, this connection method is optional, and using Database Actions (SQL Developer Web) is the preferred method.

When you configure the connection, select the service name with the "low" prefix in its name. Connecting with the "high" or "medium" service might lead to performance issues in reports in NetSuite Analytics Warehouse and delays in completion of daily incremental data pipeline loads. See Database Service Names for Autonomous Transaction Processing and Autonomous JSON Database for more information.

  1. Launch SQL Developer.
  2. In the Connections pane, click New Connection.
  3. Create an SQL Developer connection for the ADMIN user by setting the following values in the New/Select Database Connection dialog:
    1. Define a Name for the connection, such as PROD_ADMIN.
    2. Set the Username to ADMIN.
    3. Enter the password for the ADMIN user.
    4. Set the Connection Type to Cloud Wallet.
    5. For the Configuration file, click Browse and select the wallet.zip file.
    6. Service: Select <service name>-low. Using low prevents pipeline conflicts.
    7. When connecting with a virtual private network (VPN), enter details in the Proxy tab.
    8. Click Test to validate the connection.
    9. Click Save.
    10. Click Connect.
  4. Run this query to verify proper configuration:
    select sum(bytes)/1024/1024/1024/1024 as USED_STORAGE_TB from dba_segments
          where owner not in ('SSB', 'SH');

Configure the Connection to Autonomous Data Warehouse for OAX_USER with SQL Developer Desktop Client

You can use the SQL Developer desktop client to connect to Autonomous Data Warehouse.

When you configure the connection, select the service name with the "low" prefix in its name. Connecting with the "high" or "medium" service might lead to performance issues in reports in NetSuite Analytics Warehouse and delays in completion of daily incremental data pipeline loads. See Database Service Names for Autonomous Transaction Processing and Autonomous JSON Database for more information.

  1. Launch SQL Developer.
  2. In the Connections pane, click New Connection.
  3. Create an SQL Developer connection for OAX_USER. Set the following values in the New/Select Database Connection dialog:
    1. Define a Name for the connection, such as PROD_OAX_USER.
    2. Set the Username to OAX_USER.
    3. Enter the password for OAX_USER.
    4. Set the Connection Type to Cloud Wallet.
    5. For the Configuration file, click Browse and select the wallet.zip file.
    6. Service Name: Select <service name>-low. Using low prevents pipeline conflicts.
    7. When connecting with a virtual private network (VPN), enter details in the Proxy tab.
    8. Click Test.
    9. Click Save.
    10. Click Connect.
  4. Expand Synonyms to see all of the prebuilt synonyms for OAX_USER.
  5. Run this query to verify proper configuration:
    SELECT * FROM DW_CUSTOMER_LOCATION_D