In today’s data-driven world, effective data governance is paramount to ensure data quality, security, and compliance. Unity Catalog offers a robust solution for organizations seeking to streamline their data management practices. This comprehensive guide will walk you through the process of installing and configuring UCX on Databricks, empowering you to simplify data governance and unlock the full potential of your data, The companion for upgrading to Unity Catalog.
Requirements:
- Python Version: 3.6 or higher
- Databricks CLI: Installed and configured on your local machine
- It is Mandatory to use Databricks Premium or Enterprise Workspace.
- Attach your Databricks Workspace to Metastore
- Find More here
Installing Databricks CLI (Windows):
We will use `winget` to install the Databricks CLI. Make sure `winget` is available on your machine.

winget search databricks
winget install Databricks.DatabricksCLI
Installing Databricks CLI For macOS using Homebrew:
If you’re a Mac user, installing tools via Homebrew is a no-brainer. It’s a package manager that simplifies the installation of software on macOS, making your life easier. Here’s a quick and painless guide to get the Databricks CLI set up using Homebrew.
Step 1: Check Homebrew Installation:
brew -v
Step 2: Tap Databricks Homebrew Repository:
Next, you’ll need to add the official Databricks Homebrew tap. A “tap” is essentially a repository for Homebrew packages that aren’t included by default.
brew tap Databricks/tap
Step 3: Install Databricks CLI:
With the tap added, you can now install the Databricks CLI:
brew install Databricks
This step pulls down the Databricks CLI and installs it for you. Homebrew handles the dependencies and takes care of the installation process.
Verify Installation:
After installation, verify that Databricks CLI is correctly set up by running the following command:

Authenticate Databricks CLI:
Once the CLI is installed, authenticate it with your Databricks workspace by running:

Replace `<WORKSPACE_HOST>` with the actual URL of your Databricks workspace. You will be prompted to authenticate using your default browser to the Databricks authentication window.
Install UCX:
After successful authentication, you can now install UCX using the Databricks Labs extension:

UCX Configuration:


During the installation, you will be asked a series of questions about how to configure UCX. You can choose to keep the default settings for a basic setup. However, you can configure it based on your requirements
Verify the Installation:
Once the UCX command Databricks labs install UCX has completed successfully, the installation can be verified with the following steps:
- Go to the Databricks Catalog Explorer and check if a new schema for UCX is available in Hive Metastore with all empty tables.
- Check that the UCX jobs are visible under Workflows.
Running Workflows:
Run the assessment. This will start the UCX clusters, crawl through the workspace, and display results in the UCX dashboards. In the case of external HMS, verify from the results that the assessment has analyzed the external HMS tables. This will generate the desired dashboards, providing you with insights and visualizations based on the data processed.
The UCX assessment workflow is intended to only run once; re-running it is not supported. If the inventory and findings for a workspace need to be updated then first reinstall UCX by uninstalling and installing it again.
Workflows:

Dashboards:

Assessment Overview Dashboard:

Congratulations 🎉 on successfully installing Databricks Labs UCX!
By completing this installation, you’ve laid the foundation for leveraging the powerful capabilities of UCX to enhance your data management and governance practices.
Next Steps:
- Explore UCX Features: Delve deeper into UCX’s functionalities to discover how it can address your specific data management challenges.
- Implement Governance Policies: Define and enforce data governance policies using UCX’s capabilities.
- Monitor and Optimize: Continuously monitor UCX performance and usage to identify opportunities for optimization.
Conclusion:
You can find the GitHub page of the official UCX here
If you have trouble logging in to UCX, check the Databricks documentation for help. here
For More Details, Diggibyte Technologies Pvt Ltd has all the experts you need. Contact us Today to embed intelligence into your organization.
Author: Basheer Ahmed