{"componentChunkName":"component---src-templates-markdown-template-jsx","path":"/guides/data-warehouse/composable-audiences/connections/databricks/","result":{"data":{"pageMetadata":{"title":"Databricks","path":"/guides/data-warehouse/composable-audiences/connections/databricks/","sourceCode":null,"metadataParent":{"title":"Connections","path":"/guides/data-warehouse/composable-audiences/connections/","sourceCode":null,"hasVersionPicker":null,"metadataChildren":[{"title":"Connections Overview","path":"/guides/data-warehouse/composable-audiences/connections/overview/","order":1,"label":null},{"title":"Google BigQuery","path":"/guides/data-warehouse/composable-audiences/connections/bigquery/","order":2,"label":null},{"title":"Databricks","path":"/guides/data-warehouse/composable-audiences/connections/databricks/","order":3,"label":null},{"title":"Amazon Redshift","path":"/guides/data-warehouse/composable-audiences/connections/redshift/","order":4,"label":null},{"title":"Snowflake","path":"/guides/data-warehouse/composable-audiences/connections/snowflake/","order":5,"label":null}],"metadataParent":{"title":"Composable Audiences","path":"/guides/data-warehouse/composable-audiences/","metadataChildren":[{"title":"Warehouse Setup Overview","path":"/guides/data-warehouse/composable-audiences/overview/","order":0.5,"label":null},{"title":"Connections","path":"/guides/data-warehouse/composable-audiences/connections/","order":1,"label":null},{"title":"Data Models","path":"/guides/data-warehouse/composable-audiences/data-models/","order":2,"label":null}],"metadataParent":{"title":"Data Warehouse","path":"/guides/data-warehouse/","metadataChildren":[{"title":"Composable Audiences","path":"/guides/data-warehouse/composable-audiences/","order":1,"label":null},{"title":"Warehouse Sync","path":"/guides/data-warehouse/warehouse-sync/","order":4,"label":null}],"metadataParent":{"title":"Guides","path":"/guides/","metadataChildren":[{"title":"Platform Overview","path":"/guides/platform-overview/","order":0.5,"label":null},{"title":"Getting Started","path":"/guides/getting-started/","order":1,"label":null},{"title":"mParticle Agent","path":"/guides/mparticle-agent/","order":1.5,"label":null},{"title":"Oversight","path":"/guides/oversight/","order":2,"label":null},{"title":"Data Platform","path":"/guides/data-platform/","order":3,"label":null},{"title":"Data Warehouse","path":"/guides/data-warehouse/","order":4,"label":null},{"title":"Customer 360","path":"/guides/customer-360/","order":5,"label":null},{"title":"Analytics","path":"/guides/analytics/","order":6,"label":null},{"title":"Audiences","path":"/guides/audiences/","order":7,"label":null},{"title":"Settings","path":"/guides/settings/","order":8,"label":null},{"title":"Troubleshooting mParticle","path":"/guides/troubleshooting/","order":10,"label":null},{"title":"Default Service Limits","path":"/guides/default-service-limits/","order":11,"label":null},{"title":"Glossary","path":"/guides/glossary/","order":12,"label":null}],"metadataParent":null}}}}},"markdownRemark":{"html":"

This guide explains how to connect your Databricks workspace to mParticle for Composable Audiences. The setup process is interactive: as you enter values in the mParticle UI form, the SQL snippets on the right-hand side will update. You’ll copy those snippets and run them in Databricks to configure the necessary resources.

\n

What you’ll need:

\n\n

What you’ll accomplish:\nA configured connection that allows mParticle to securely query your Databricks data for building and managing Composable Audiences.

\n

\n \n \n \n \n \n \n \n Step 1: Begin creating the connection in mParticle

\n
    \n
  1. In the mParticle UI, go to Data Warehouse > Connections.
    2. \n
  2. Click + Add Connection and select Databricks.
    3. \n
  3. \n

    Start filling out the required fields on the connection form:

    \n\n
    4. \n
\n

As you enter these values, the SQL snippets on the right-hand side of the UI will update with the correct details for your environment.

\n

\n \n \n \n \n \n \n \n Step 2: Apply the generated SQL snippets in Databricks

\n

Follow the numbered instructions displayed in the mParticle UI. For each step:

\n
    \n
  1. Configure the Storage Credential\nIn your Databricks Catalog Explorer, create a new storage credential using the AWS IAM role provided in the mParticle UI for your specific mParticle org. You will find the AWS IAM role under “1. Configure the Storage Credential for S3 Access” in the Setting up Databricks instructions in the mParticle UI.
    2. \n
  2. Configure the External Location\nIn your Databricks Catalog Explorer, create a new external location using the storage credential you created in Step 1 and the S3 bucket URL provided in the mParticle UI. Click Force Create when prompted. You will find the S3 bucket URL under “2. Configure the External Location based on the new Storage Credential for S3 Access” in the Setting up Databricks instructions in the mParticle UI.
    3. \n
  3. Configure a Service Principal and Secret\nIf not already created, set up a service principal in Databricks and generate a secret. Enter the Client ID and Secret under Service Principle Client ID and Service Principle Client Secret in the mParticle UI.
    4. \n
  4. Grant permissions to the Service Principal\nRun the SQL provided in the mParticle UI to grant your service principal the necessary access to the external location.
    5. \n
\n
GRANT READ FILES, WRITE FILES ON EXTERNAL LOCATION `[your_external_location_name]` to `[your_service_principal_client_id]`;
\n
    \n
  1. Configure a SQL Warehouse\nIn the Databricks UI, create a SQL Warehouse with an appropriate size. Grant the service principal Can Use access. Enter its HTTP Path in the mParticle UI under SQL Warehouse HTTP Path in the mParticle UI.
    2. \n
  2. Grant access to Catalog and Schema\nRun the SQL provided in the mParticle UI to grant the service principal permission to use the catalog and schema.
    3. \n
\n
GRANT USE CATALOG ON CATALOG `[your_catalog_name]` TO `[your_service_principal_client_id]`;
\n
GRANT USE SCHEMA ON SCHEMA `[your_catalog_name]`.`[your_schema_name]` TO `[your_service_principal_client_id]`;
\n
    \n
  1. Grant read access to tables\nRun the SQL provided in the mParticle UI to grant the service principal SELECT access to the tables you want to use for Composable Audiences.
    2. \n
\n
GRANT SELECT ON TABLE `[your_catalog_name]`.`[your_schema_name]`.[your table] TO `[your_service_principal_client_id]`;
\n
    \n
  1. Set up the MPARTICLE schema\nFinally, run the SQL provided in the mParticle UI to create a schema named MPARTICLE. This schema stores temporary data and intermediate results. Grant your service principal full DML privileges here.
    2. \n
\n
CREATE SCHEMA IF NOT EXISTS MPARTICLE;\nGRANT USE SCHEMA ON SCHEMA MPARTICLE TO `[your_service_principal_client_id]`;\nGRANT CREATE TABLE, SELECT, MODIFY ON SCHEMA MPARTICLE TO `[your_service_principal_client_id]`;
\n

\n \n \n \n \n \n \n \n Step 3: Complete the connection in mParticle

\n
    \n
  1. Once you’ve run all SQL snippets in Databricks, return to the mParticle UI.
    2. \n
  2. Review the values you entered in the connection form.
    3. \n
  3. Click Create Connection.
    4. \n
\n","frontmatter":{"title":"Databricks","order":3,"seoTitle":null,"seoDescription":null},"parent":{"__typename":"File","modifiedTime":"October 12, 2026"}}},"pageContext":{"slug":"/guides/data-warehouse/composable-audiences/connections/databricks/"}},"staticQueryHashes":["2950460867"]}