From 313fde98793fa2e390e3b534ea7cb7d7e15a8cec Mon Sep 17 00:00:00 2001
From: Jeff Bruemmer <jeff.bruemmer@gmail.com>
Date: Fri, 4 Oct 2024 14:36:24 -0400
Subject: [PATCH] docs - databricks (#48365)

---
 docs/databases/connecting.md             |  1 +
 docs/databases/connections/databricks.md | 60 ++++++++++++++++++++++++
 2 files changed, 61 insertions(+)
 create mode 100644 docs/databases/connections/databricks.md

diff --git a/docs/databases/connecting.md b/docs/databases/connecting.md
index 378ed8fb8a1..60c4cd1a14f 100644
--- a/docs/databases/connecting.md
+++ b/docs/databases/connecting.md
@@ -25,6 +25,7 @@ The databases listed below have official drivers maintained by the Metabase team
 
 - [Amazon Athena](./connections/athena.md)
 - [BigQuery](./connections/bigquery.md) (Google Cloud Platform)
+- [Databricks](./connections/databricks.md)
 - [Druid](./connections/druid.md)
 - [MongoDB (recommend version 4.2 or higher)](./connections/mongodb.md)
 - [MariaDB](./connections/mariadb.md)
diff --git a/docs/databases/connections/databricks.md b/docs/databases/connections/databricks.md
new file mode 100644
index 00000000000..ef149d3fc3e
--- /dev/null
+++ b/docs/databases/connections/databricks.md
@@ -0,0 +1,60 @@
+---
+title: Databricks
+---
+
+To add a database connection, click on the **gear** icon in the top right, and navigate to **Admin settings** > **Databases** > **Add a database**. Then select **Databricks**.
+
+You can edit these settings at any time. Just remember to save your changes.
+
+## Display name
+
+The display name for the database in the Metabase interface.
+
+## Host
+
+Your database's IP address, or its domain name (e.g., esc.mydatabase.com). This is the value of your Databrick's compute resource's Server Hostname.
+
+See [Compute settings for the Databricks JDBC Driver](https://docs.databricks.com/en/integrations/jdbc/compute.html).
+
+## HTTP path
+
+This is the Databrick's compute resources HTTP Path value.
+
+See [Compute settings for the Databricks JDBC Driver](https://docs.databricks.com/en/integrations/jdbc/compute.html).
+
+## Personal access token
+
+See [Personal Access Token (PAT)](https://docs.databricks.com/en/dev-tools/auth/pat.html).
+
+## Catalog
+
+For now, you can only select one catalog. Metabase doesn't support multi-catalog connections.
+
+## Schemas
+
+You can specify which schemas you want to sync and scan. Options are:
+
+- All
+- Only these...
+- All except...
+
+For the **Only these** and **All except** options, you can input a comma-separated list of values to tell Metabase which schemas you want to include (or exclude). For example:
+
+```
+foo,bar,baz
+```
+
+You can use the `*` wildcard to match multiple schemas.
+
+Let's say you have three schemas: foo, bar, and baz.
+
+- If you have **Only these...** set, and enter the string `b*`, you'll sync with bar and baz.
+- If you have **All except...** set, and enter the string `b*`, you'll just sync foo.
+
+Note that only the `*` wildcard is supported; you can't use other special characters or regexes.
+
+## Additional JDBC connection string options
+
+You can append options to the connection string that Metabase uses to connect to your database. E.g., `IgnoreTransactions=0`.
+
+See [Compute settings for the Databricks JDBC Driver](https://docs.databricks.com/en/integrations/jdbc/compute.html).
-- 
GitLab