databrickssqlalert Resource

June 12, 2026 ยท View on GitHub

API Documentation

!> This resource is deprecated! Please switch to databricks_alert.

This resource allows you to manage Databricks SQL Alerts.

-> To manage SQLA resources you must have databricks_sql_access on your databricks_group or databricks_user.

Example Usage

resource "databricks_directory" "shared_dir" {
  path = "/Shared/Queries"
}

resource "databricks_sql_query" "this" {
  data_source_id = databricks_sql_endpoint.example.data_source_id
  name           = "My Query Name"
  query          = "SELECT 1 AS p1, 2 as p2"
  parent         = "folders/${databricks_directory.shared_dir.object_id}"
}

resource "databricks_sql_alert" "alert" {
  query_id = databricks_sql_query.this.id
  name     = "My Alert"
  parent   = "folders/${databricks_directory.shared_dir.object_id}"
  rearm    = 1
  options {
    column = "p1"
    op     = "=="
    value  = "2"
    muted  = false
  }
}

Argument Reference

The following arguments are available:

  • query_id - (Required, String) ID of the query evaluated by the alert.
  • name - (Required, String) Name of the alert.
  • options - (Required) Alert configuration options.
    • column - (Required, String) Name of column in the query result to compare in alert evaluation.
    • op - (Required, String Enum) Operator used to compare in alert evaluation. (Enum: >, >=, <, <=, ==, !=)
    • value - (Required, String) Value used to compare in alert evaluation.
    • muted - (Optional, bool) Whether or not the alert is muted. If an alert is muted, it will not notify users and alert destinations when triggered.
    • custom_subject - (Optional, String) Custom subject of alert notification, if it exists. This includes email subject, Slack notification header, etc. See Alerts API reference for custom templating instructions.
    • custom_body - (Optional, String) Custom body of alert notification, if it exists. See Alerts API reference for custom templating instructions.
    • empty_result_state - (Optional, String) State that alert evaluates to when query result is empty. Currently supported values are unknown, triggered, ok - check API documentation for full list of supported values.
  • parent - (Optional, String) The identifier of the workspace folder containing the alert. The default is ther user's home folder. The folder identifier is formatted as folder/<folder_id>.
  • rearm - (Optional, Integer) Number of seconds after being triggered before the alert rearms itself and can be triggered again. If not defined, alert will never be triggered again.

Attribute Reference

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

  • id - unique ID of the SQL Alert.

Access Control

databricks_permissions can control which groups or individual users can Manage, Edit, Run or View individual alerts.

Import

This resource can be imported using alert ID:

import {
  to = databricks_sql_alert.this
  id = "<alert-id>"
}

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

terraform import databricks_sql_alert.this "<alert-id>"

The following resources are often used in the same context: