Databricks schema Terraform module

One Unity Catalog schema.

Creates one schema inside an existing catalog and, when grants is not empty, one databricks_grants block on it.

Resources

• databricks_schema.this
• databricks_grants.this[0] (count = 1 only when grants is not empty)

The resource addresses above are part of the DataTF import contract. Do not rename them.

Usage

module "schema" {
  source  = "536tech/schema/databricks"
  version = "0.1.0"

  catalog_name = "sales"
  name         = "bronze"
  comment      = "Raw landing"

  grants = [{
    principal  = "ingest@example.com"
    privileges = ["SELECT", "MODIFY"]
  }]
}

Compatibility

Configure the Databricks provider in the calling root with a workspace endpoint. This resource module is also used by the workspace pattern module. Each repository has its own releases. Consumers select an exact tested module version.

The resource addresses match the original workspace submodule in version 0.1.1. To migrate a direct submodule call, change its source and version. Keep the module block name. Run terraform init and require a plan with no resource changes. DataTF exports continue to use the workspace pattern module and its existing import addresses.

Development

Use Terraform 1.7 or later for the mock tests. The module supports Terraform 1.5 or later.

prek install
terraform init -backend=false -lockfile=readonly
terraform validate
terraform test
tflint --recursive
prek run --all-files

CI tests the committed provider version and the minimum supported provider, 1.128.0. The workspace pattern module checks the complete DataTF contract and its integration behavior.

License

Apache-2.0.

Requirements

The following requirements are needed by this module:

• terraform (>= 1.5.0)

• databricks (>= 1.128.0, < 2.0.0)

Providers

The following providers are used by this module:

• databricks (>= 1.128.0, < 2.0.0)

Resources

The following resources are used by this module:

• databricks_grants.this (resource)
• databricks_schema.this (resource)

Required Inputs

The following input variables are required:

catalog_name

Description: Name of the catalog that holds the schema.

Type: string

name

Description: Schema name.

Type: string

Optional Inputs

The following input variables are optional (have default values):

comment

Description: Schema description.

Type: string

Default: null

force_destroy

Description: Allow Terraform to delete the schema while it still contains tables.

Type: bool

Default: false

grants

Description: Direct schema grants. A list permits computed service principal application IDs.

Type:

list(object({
    principal  = string
    privileges = list(string)
  }))

Default: []

storage_root

Description: Managed storage location for the schema. Changing it replaces the schema.

Type: string

Default: null

Outputs

The following outputs are exported:

id

Description: Schema id, in the form catalog.schema.

name

Description: Schema name.