To use the driver to access data with DbVisualizer:

  1. Open DbVisualizer.
  2. From the menu, select Database>New Connection. When prompted to use the Connection Wizard, click OK.
  3. Provide the following information when prompted; then, click Next to proceed:
    • Connection alias: Type the name to be used when referring to this connection.
    • Driver: Select the alias that you provided for your driver from the drop-down menu.
  4. Provide values for the following fields; then, click Finish.
    • Database URL: Copy and paste your connection URL into this field. The following examples show how to connect using either URL parameter authentication or OAuth 2.0 authorization grant authentication.
      Note: You can also generate connection strings using Aha! Configuration Manager. For more information, see Generating connection URLs with the Configuration Manager.

      URL parameter (API key) authentication

      jdbc:datadirect:aha://example.org;authenticationMethod=UrlParameter;
      securitytoken=api_key;

      OAuth 2.0 authorization code grant

      jdbc:datadirect:aha://example.org;authenticationMethod=OAuth2;
      oauthCode=auth_code;clientId=client_id;clientSecret=client_secret;
      redirectUri=https://lvh.me/app_callback.html
      Note: See Authorization code grant for details on this and other supported grant types.
  5. To execute SQL statements, select SQL Commander>New SQL Commander. A SQL Commander tab opens.
  6. Select values for the following fields:
    • Database Connection: Select connection alias you provided for the connection from the drop-down menu.
    • Schema: Select the schema you want to execute queries against from the drop-down menu.
  7. In the SQL Commander tab, enter SQL commands you want to execute; then select SQL Commander>Execute. For example:

    To select all of the rows from the FEATURES table:

    SELECT * FROM FEATURES 
    To select the comments for a specified user :
    SELECT BODY FROM ISSUES WHERE USER_ID = <user_id> 

    See "Supported SQL statements and extensions" for the supported syntax used to execute SQL statements.

    Note: If you are fetching large sets of data, you may want to limit the results using the Max Rows and Max Chars fields.
You have successfully accessed your data with DbVisualizer.