This is an automated email from the ASF dual-hosted git repository.
curth pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/arrow-adbc.git
The following commit(s) were added to refs/heads/main by this push:
new 6d17189ab fix(csharp/src/Drivers/Databricks): Add instructions about
driver config setup (#3367)
6d17189ab is described below
commit 6d17189abc187b3f4a7efdbe2d71fc902f449e3a
Author: eric-wang-1990 <[email protected]>
AuthorDate: Thu Aug 28 13:35:38 2025 -0700
fix(csharp/src/Drivers/Databricks): Add instructions about driver config
setup (#3367)
Add instructions about how to setup driver config from env variable.
---
csharp/src/Drivers/Databricks/readme.md | 35 +++++++++++++++++++++++++++++++++
1 file changed, 35 insertions(+)
diff --git a/csharp/src/Drivers/Databricks/readme.md
b/csharp/src/Drivers/Databricks/readme.md
index 1255bf817..49bf2d9d5 100644
--- a/csharp/src/Drivers/Databricks/readme.md
+++ b/csharp/src/Drivers/Databricks/readme.md
@@ -29,6 +29,41 @@ The Databricks ADBC driver is built on top of the Spark ADBC
driver and inherits
**Note**: The Databricks driver inherits all properties from the [Spark
driver](../Apache/Spark/readme.md). The properties below are
Databricks-specific additions.
+## Configuration Methods
+
+The Databricks driver supports multiple ways to configure properties:
+
+### 1. Direct Property Configuration
+Pass properties directly when creating the driver connection (traditional
method).
+
+### 2. Environment Variable Configuration
+Configure properties using a JSON file loaded via environment variables:
+
+1. **Create a JSON configuration file** with standard ADBC parameters:
+```json
+{
+ "adbc.databricks.driver_config_take_precedence": "true",
+ "adbc.databricks.enable_pk_fk": "false",
+ "adbc.connection.catalog": "my_catalog",
+ "adbc.connection.db_schema": "my_schema"
+}
+```
+
+2. **Set the system environment variable** `DATABRICKS_CONFIG_FILE` to point
to your JSON file:
+ 1. Open System Properties → Advanced → Environment Variables
+ 2. Add new system variable: Name=`DATABRICKS_CONFIG_FILE`,
Value=`C:\path\to\your\config.json`
+
+3. **Property Merging Behavior**:
+ - By default: Constructor/code properties **override** environment config
properties
+ - With `"adbc.databricks.driver_config_take_precedence": "true"`:
Environment config properties **override** constructor/code properties
+
+### 3. Hybrid Configuration
+You can combine both methods - the driver will automatically merge environment
config with constructor properties based on the precedence setting.
+
+**Use Cases**:
+- **PowerBI Integration**: Set system-wide defaults via environment config
while allowing connection-specific overrides
+
+
### Authentication Properties
| Property | Description | Default |
