DbVisualizer
This section shows how to establish a connection to data in DbVisualizer, use the table editor to edit and save data, and execute SQL.
Add the JDBC Driver for Azure Data Catalog
Complete the following steps to add the driver .jar file in a driver definition:
- In the DbVisualizer toolbar, select Tools > Driver Manager.
- Click the "+" button in the top-left corner of the Driver Manager window and select Custom.
- Enter a name for the driver.
- Enter the following in the URL Format box:
jdbc:azuredatacatalog:
- In the Driver artifacts and jar files section, click the "+" button on the right and select Add Files... to browse for the driver .jar file, cdata.jdbc.azuredatacatalog.jar. By default, this is located in the lib subfolder of the installation directory. Note that the .lic file in this folder must be located in the same folder as the .jar file.
- In the Driver Class menu, select the AzureDataCatalogDriver class, cdata.jdbc.azuredatacatalog.AzureDataCatalogDriver.
Create a Database Connection for Azure Data Catalog
Complete the following steps to select the Azure Data Catalog driver and build the JDBC URL to create the JDBC data source:
-
In the DbVisualizer toolbar, select Database > Create Database Connection. The Driver Name selector will then appear.
Note: If this option is greyed out, you may need to first select the Connections root element of the tree view, found in the Databases tab of the left-hand pane.
- Double-click the name of the JDBC driver you defined in the section above.
- Set Settings Format to Database URL if it isn't already set to that value.
- Set Driver Type to the name you defined for your JDBC driver, if it doesn't default to that name.
- Set Database URL to the full JDBC URL. The syntax of the JDBC URL is jdbc:azuredatacatalog: followed by the connection properties in a semicolon-separated list of name-value pairs.
A typical connection string is below:
jdbc:azuredatacatalog:InitiateOAuth=GETANDREFRESH;
- Click Connect.
- If the connection succeeds, set the Database Type to Generic.
Discover Schemas and Query Azure Data Catalog Data
You can now browse data and execute SQL in the following ways:
- To access the available tables, from the Databases tab, expand the nodes for the connection, database, schema, and table or view.
- To browse through table data and metadata, right-click a table and click Open in Tab or Open in New Tab.
- To execute SQL queries, select SQL Commander > New SQL Commander. Select the Database Connection, Database, and Schema from the available menus.
See Data Model for information on querying specific tables. See SQL Compliance for more information on the SQL syntax.