MetricSign
EN|NLRequest Access
High severityconnection

Power BI Refresh Error:
JDBC_CONNECTION_REFUSED

What does this error mean?

The Databricks JDBC driver cannot establish a TCP connection to the specified host and port, usually because the cluster or SQL warehouse is not running, a firewall blocks the connection, or the JDBC URL is malformed.

Common causes

  • 1The target SQL warehouse is suspended and has not auto-started
  • 2A firewall rule blocks outbound traffic on port 443 from the JDBC client host
  • 3The JDBC URL contains an incorrect host, HTTP path, or port
  • 4The personal access token or OAuth credential in the JDBC connection string is expired

How to fix it

  1. 1Step 1: Confirm the SQL warehouse is running — start it manually if it is suspended.
  2. 2Step 2: Copy the JDBC URL directly from the Databricks UI: SQL Warehouses > Connection Details > JDBC URL.
  3. 3Step 3: Test TCP connectivity from the client machine: telnet <workspace>.azuredatabricks.net 443.
  4. 4Step 4: Regenerate the personal access token and update the JDBC connection string.
  5. 5Step 5: If using IP allowlisting, add the client machine IP to the workspace network policy.

Frequently asked questions

Which port does the Databricks JDBC driver use?

The Databricks JDBC driver uses port 443 (HTTPS) for all connections, regardless of cluster or warehouse type.

Can I use OAuth instead of a personal access token with JDBC?

Yes — Databricks JDBC driver version 2.6.25+ supports OAuth M2M authentication using a service principal client ID and secret.

Other connection errors