Skip to main content

VeloDB Terraform Provider

Use the VeloDB Terraform provider to provision and manage VeloDB Cloud infrastructure in version-controlled configuration. The provider manages control-plane resources through the VeloDB Cloud Management API. It does not manage SQL databases, tables, or warehouse users.

Choose a guide based on what you need to do:

GoalGuide
Configure credentials and initialize the providerAuthenticate the Terraform provider
Create a SaaS warehouse and its initial compute clusterCreate a SaaS warehouse with Terraform
Create an AWS BYOC warehouse with new or existing AWS infrastructureCreate an AWS BYOC warehouse with Terraform
Import, update, inspect, or delete managed resourcesManage resources with Terraform

Provider reference​

The VeloDB Cloud documentation explains product workflows, prerequisites, security considerations, and limitations. For the complete, versioned list of resources, data sources, arguments, exported attributes, and import formats, see the VeloDB provider reference in the Terraform Registry.

Supported scope​

  • The provider supports SaaS warehouses and, starting with v1.1.10, advanced AWS BYOC warehouses using new or existing AWS infrastructure.
  • AWS is the only cloud provider supported for BYOC warehouse creation with Terraform. Guided/template BYOC setup is not supported.
  • The provider manages physical COMPUTE clusters and virtual clusters. It does not manage SQL or OBSERVER clusters.
  • Terraform state can contain warehouse administrator passwords and other sensitive values. Store state in an encrypted remote backend and restrict access to it.