Getting access

The CARTO Analytics Toolbox for Databricks is installed in your Unity Catalog and works with SQL Warehouses.

The CARTO Analytics Toolbox for Databricks is available for CARTO customers. Contact us to get an installation package.

Requirements

• Unity Catalog enabled in your Databricks workspace

• A SQL Warehouse provisioned in your workspace

• Appropriate permissions to create functions in your catalog

Check your Databricks region before you start

All installation methods below rely on Databricks Unity Catalog HTTP connections (the mechanism behind http_request()) to reach the AT Gateway, which powers every Analytics Toolbox feature that calls out to CARTO's APIs: the Location Data Services (LDS) module (geocoding, isolines, routing), the import and export modules, and the creation of Builder maps from Databricks (used by CARTO Workflows). These connections are only available in Azure regions where Databricks Model Serving is supported — see the Databricks region support tables. If your workspace's region doesn't support Model Serving, none of these features can work regardless of how the Analytics Toolbox or AT Gateway is configured.

Installation

There are different ways to install the Analytics Toolbox for Databricks:

• SQL Warehouse installation guide: This is the most standard and easy way to install the Analytics Toolbox. It provides step-by-step instructions for installing functions in your Unity Catalog.

• Installation in an Azure VNet: This option is only suitable for Self-Hosted deployments of the CARTO platform on Azure that need to access the Analytics Toolbox functions within a VNet using an AT Gateway deployed on Azure Container Apps.

• Installation on a private AKS: For Self-Hosted deployments on AKS where the AT Gateway must remain fully private. Connectivity from Databricks Serverless SQL Warehouses is established over Azure Private Link via a Databricks Network Connectivity Configuration (NCC).

Looking for the legacy cluster-based installation? See the Legacy documentation section.