This repository contains a Terraform provider for managing resources in a Materialize account.

• Materialize >= 0.27
• Terraform >= 1.0.3
• (Development) Go >= 1.22

The materialize provider is published to the Terraform Registry. To use it, add the following configuration to your Terraform settings:

terraform {
  required_providers {
    materialize = {
      source = "MaterializeInc/materialize"
    }
  }
}

Configure the provider by adding the following block to your Terraform project:

provider "materialize" {
  password       = "materialize_password"
  default_region = "aws/us-east-1"
  database       = "materialize"
}

Once you have configured the provider, you can start defining resources using Terraform. You can find examples on how to define resources in the examples directory.

You can manage resources using the terraform apply command. For example, to create a new connection named kafka_connection, add the following resource definition to your Terraform project:

# main.tf
resource "materialize_connection_kafka" "kafka_connection" {
  name = "kafka_connection"
  kafka_broker {
    broker = "b-1.hostname-1:9096"
  }
  sasl_username {
    text = "user"
  }
  sasl_password {
    name          = "kafka_password"
    database_name = "materialize"
    schema_name   = "public"
  }
  sasl_mechanisms = "SCRAM-SHA-256"
  progress_topic  = "example"
}

You can use data sources to retrieve information about existing resources. For example, to retrieve information about the existing sinks in your Materialize region, add the following data source definition to your Terraform project:

# main.tf
data "materialize_connection" "all" {}

output name {
  value       = data.materialize_connection.all
}

You can import existing resources into your Terraform state using the terraform import command. For this, you will need the id of the resource from the respective mz_catalog system table.

For example, to import an existing connection named kafka_connection, first add the resource definition to your Terraform project:

# main.tf
resource "materialize_connection_kafka" "kafka_connection" {
  name = "kafka_connection"
  kafka_broker {
    broker = "b-1.hostname-1:9096"
  }
}

Then, look up the connection id (connection_id) in mz_connections and run:

terraform import materialize_connection_kafka.kafka_connection <connection_id>

After the import, you can check the state of the resource by running:

terraform state show materialize_connection_kafka.kafka_connection

Please see CONTRIBUTING.md for instructions on how to contribute to this provider.

This provider is distributed under the Apache License, Version 2.0.