databricksregisteredmodel Resource

June 12, 2026 ยท View on GitHub

API Documentation

This resource allows you to create Models in Unity Catalog in Databricks.

-> This resource can only be used with a workspace-level provider!

Example Usage

resource "databricks_registered_model" "this" {
  name         = "my_model"
  catalog_name = "main"
  schema_name  = "default"
}

Argument Reference

The following arguments are supported:

  • name - (Required) The name of the registered model. Change of this parameter forces recreation of the resource.
  • catalog_name - (Required) The name of the catalog where the schema and the registered model reside. Change of this parameter forces recreation of the resource.
  • schema_name - (Required) The name of the schema where the registered model resides. Change of this parameter forces recreation of the resource.
  • owner - (Optional) Name of the registered model owner.
  • comment - (Optional) The comment attached to the registered model.
  • storage_location - (Optional) The storage location under which model version data files are stored. If the URL contains special characters, such as space, &, etc., they should be percent-encoded (space -> %20, etc.). Change of this parameter forces recreation of the resource.
  • provider_config - (Optional) Configure the provider for management through account provider. This block consists of the following fields:
    • workspace_id - (Required) Workspace ID which the resource belongs to. This workspace must be part of the account which the provider is configured with.

Attribute Reference

In addition to all arguments above, the following attributes are exported:

  • id - Equal to the full name of the model (catalog_name.schema_name.name) and used to identify the model uniquely across the metastore.

Access Control

  • databricks_grants can be used to grant principals ALL_PRIVILEGES, APPLY_TAG, and EXECUTE privileges.

Import

The registered model resource can be imported using the full (3-level) name of the model.

import {
  to = databricks_registered_model.this
  id = "<catalog_name>.<schema_name>.<model_name>"
}

Alternatively, when using terraform version 1.4 or earlier, import using the terraform import command:

terraform import databricks_registered_model.this <catalog_name>.<schema_name>.<model_name>

The following resources are often used in the same context: