Skip to main content
Version: 2.4.3 (latest)

Databricks target prerequisites

Review the following prerequisites required to migrate to Databricks using a Metastore Agent.


When adding a Databricks Metastore Agent choose either a Unity Catalog or a Workspace Hive Metastore (Legacy) Metastore Type. Find more information on general prerequisites, Workspace Hive Metastore (Legacy) prerequisites, and Unity Catalog prerequisites below.

Workspace Hive Metastore (Legacy) prerequisites

Unity Catalog prerequisites

  • External location created in Databricks. Learn more from Azure, AWS and GCP.

Data formats

To ensure a successful migration to Databricks, the source tables must be in one of the following formats:

  • CSV
  • JSON
  • AVRO
  • ORC
  • Text

Cluster and file system

Ensure you have the following before you start:

Cloud storage mounted

Example: Script to mount ADLS Gen2 or blob storage with Azure Blob File System

configs = {"": "OAuth",
"": "org.apache.hadoop.fs.azurebfs.oauth2.ClientCredsTokenProvider",
"": "<application-id>",
"": dbutils.secrets.get(scope="<scope-name>",key="<service-credential-key-name>"),
"": "<directory-id>/oauth2/token"}

# Optionally, you can add example-directory-name to the source URI of your mount point.
source = "abfss://<container-name>@<storage-account-name>",
mount_point = "/mnt/<mount-name>",
extra_configs = configs)


  • <application-id> with the Application (client) ID for the Azure Active Directory application.
  • <scope-name> with the Databricks secret scope name.
  • <service-credential-key-name> with the name of the key containing the client secret.
  • <directory-id> with the Directory (tenant) ID for the Azure Active Directory application.
  • <container-name> with the name of a container in the ADLS Gen2 storage account.
  • <storage-account-name> with the ADLS Gen2 storage account name.
  • <mount-name> with the name of the intended mount point in DBFS.

Install Databricks driver

To install the JDBC driver:

  1. Download the Databricks JDBC driver.

Data Migrator only supports JDBC driver version 2.6.25 or higher.

  1. Unzip the package and upload the DatabricksJDBC42.jar file to the Data Migrator host machine.

  2. Move the DatabricksJDBC42.jar file to the Data Migrator directory:

  3. Change ownership of the jar file to the Hive Migrator system user and group:

    chown hive:hadoop /opt/wandisco/hivemigrator/agent/databricks/DatabricksJDBC42.jar

Next steps