• Reference
  • Version · 6.0
  • Change Automation Reference

databricks-auth-mechanism

Last updated: August 12, 2026

--databricks-auth-mechanism is a global parameter for the Liquibase Secure Databricks extension. It specifies the authentication mechanism for Liquibase to use with Databricks. Valid values are: OAUTH. If no value is specified, Liquibase tries to connect using a username and password.

Specifying this parameter is required for OAuth authentication. It is available in the Liquibase Secure Databricks extension 1.0.0 and later. For more information, see Databricks: Authenticate access to Databricks resources.

Uses

You can connect Liquibase to your Databricks database using OAuth (Open Authorization). This parameter lets you specify some of your OAuth authentication details. For more guidance on authentication on Databricks, see Using Liquibase with Databricks SQL.

Syntax

You can set this parameter in the following ways:

Option

Syntax

Liquibase properties file (defaults file)

liquibase.databricks.authMechanism: <string>

Global flow file argument (example)

stages: Default: actions: - type: liquibase command: update

globalArgs: { databricks-auth-mechanism: <string>" }

Global CLI parameter

liquibase --databricks-auth-mechanism=<string>update

--changelog-file=example-changelog.xml

JVM system property JAVA_Opts Environment Variable

Unix:

JAVA_OPTS=-Dliquibase.databricks.authMechanism=<string>

Windows:

JAVA_OPTS=-D"liquibase.databricks.authMechanism"=<string>

Liquibase environment variables

LIQUIBASE_DATABRICKS_AUTH_MECHANISM=<string>

For more information, see Working with Command Parameters.

PreviousLiquibase parameters for DatabricksNextDatabricks-catalog