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 e5d5504ae docs(csharp/src/Drivers/Databricks): add mitm proxy
instruction (#3486)
e5d5504ae is described below
commit e5d5504aec0ec3e3e19ccd30cf01612d5f794d3d
Author: eric-wang-1990 <[email protected]>
AuthorDate: Thu Sep 25 11:12:00 2025 -0700
docs(csharp/src/Drivers/Databricks): add mitm proxy instruction (#3486)
Add instruction of setting up mitm proxy for debugging purpose.
---
csharp/src/Drivers/Databricks/readme.md | 20 ++++++++++++++++++++
1 file changed, 20 insertions(+)
diff --git a/csharp/src/Drivers/Databricks/readme.md
b/csharp/src/Drivers/Databricks/readme.md
index 3250ef8e4..cb8536228 100644
--- a/csharp/src/Drivers/Databricks/readme.md
+++ b/csharp/src/Drivers/Databricks/readme.md
@@ -48,6 +48,26 @@ Configure properties using a JSON file loaded via
environment variables:
"adbc.connection.db_schema": "my_schema"
}
```
+## Note
+
+All values in the JSON configuration file **must be strings** (including
numbers, booleans, and file paths). For example, use `"true"` instead of
`true`, and `"4443"` instead of `4443`.
+
+### Example: Using mitmproxy to Inspect Thrift Traffic
+
+To inspect Thrift traffic using [mitmproxy](https://mitmproxy.org/), you can
configure the Databricks driver to use a local proxy with TLS interception.
Below is an example JSON configuration:
+```json
+{
+ "adbc.databricks.driver_config_take_precedence": "true",
+ "adbc.proxy_options.use_proxy" : "true",
+ "adbc.proxy_options.proxy_host" : "localhost",
+ "adbc.proxy_options.proxy_port" : "4443",
+ "adbc.http_options.tls.enabled": "true",
+ "adbc.http_options.tls.allow_self_signed" : "true",
+ "adbc.http_options.tls.disable_server_certificate_validation" : "true",
+ "adbc.http_options.tls.allow_hostname_mismatch" : "true",
+ "adbc.http_options.tls.trusted_certificate_path" :
"C:\\your-path-to\\mitmproxy-ca-cert.pem"
+}
+```
2. **Set the system environment variable** `DATABRICKS_CONFIG_FILE` to point
to your JSON file:
1. Open System Properties → Advanced → Environment Variables
