Skip to main content

workspace_warehouse_config

Creates, updates, deletes, gets or lists a workspace_warehouse_config resource.

Overview

Nameworkspace_warehouse_config
TypeResource
Iddatabricks_workspace.sql.workspace_warehouse_config

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
channelobjectConfigures the channel name and DBSQL version of the warehouse. CHANNEL_NAME_CUSTOM should be<br /> chosen only when `dbsql_version` is specified.
config_paramobjectDeprecated: Use sql_configuration_parameters
data_access_configarraySpark confs for external hive metastore configuration JSON serialized size must be less than &lt;= 512K
enable_serverless_computebooleanEnable Serverless compute for SQL warehouses
enabled_warehouse_typesarrayList of Warehouse Types allowed in this workspace (limits allowed value of the type field in CreateWarehouse and EditWarehouse). Note: Some types cannot be disabled, they don't need to be specified in SetWorkspaceWarehouseConfig. Note: Disabling a type may cause existing warehouses to be converted to another type. Used by frontend to save specific type availability in the warehouse create and edit form UI.
global_paramobjectDeprecated: Use sql_configuration_parameters
google_service_accountstringGCP only: Google Service Account used to pass to cluster to access Google Cloud Storage
instance_profile_arnstringAWS Only: The instance profile used to pass an IAM role to the SQL warehouses. This configuration is also applied to the workspace's serverless compute for notebooks and jobs.
security_policystringSecurity policy for warehouses (DATA_ACCESS_CONTROL, NONE, PASSTHROUGH)
sql_configuration_parametersobjectSQL configuration parameters

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectdeployment_nameGets the workspace level configuration that is shared by all SQL warehouses in a workspace.
setreplacedeployment_nameSets the workspace level configuration that is shared by all SQL warehouses in a workspace.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
deployment_namestringThe Databricks Workspace Deployment Name (default: dbc-abcd0123-a1bc)

SELECT examples

Gets the workspace level configuration that is shared by all SQL warehouses in a workspace.

SELECT
channel,
config_param,
data_access_config,
enable_serverless_compute,
enabled_warehouse_types,
global_param,
google_service_account,
instance_profile_arn,
security_policy,
sql_configuration_parameters
FROM databricks_workspace.sql.workspace_warehouse_config
WHERE deployment_name = '{{ deployment_name }}' -- required
;

REPLACE examples

Sets the workspace level configuration that is shared by all SQL warehouses in a workspace.

REPLACE databricks_workspace.sql.workspace_warehouse_config
SET
channel = '{{ channel }}',
config_param = '{{ config_param }}',
data_access_config = '{{ data_access_config }}',
enable_serverless_compute = {{ enable_serverless_compute }},
enabled_warehouse_types = '{{ enabled_warehouse_types }}',
global_param = '{{ global_param }}',
google_service_account = '{{ google_service_account }}',
instance_profile_arn = '{{ instance_profile_arn }}',
security_policy = '{{ security_policy }}',
sql_configuration_parameters = '{{ sql_configuration_parameters }}'
WHERE
deployment_name = '{{ deployment_name }}' --required;