Back to changelog
New
2 minute read

Azure HorizonDB Support

Atlas now supports Azure HorizonDB, Microsoft's PostgreSQL-compatible distributed database. Connect with the horizondb:// driver for schema inspect, declarative apply, and versioned migrations, then push schemas or migration directories to Atlas Registry and deploy from CI/CD.

HorizonDB is Azure's managed database service for cloud-native applications, compatible with the standard PostgreSQL API teams already know. Atlas treats it as a first-class target, available on the Pro plan or during a Trial.

Connecting to HorizonDB

Connect to an existing HorizonDB server with the horizondb:// scheme. HorizonDB requires SSL - include sslmode=require in the URL. Inspect an existing database:

atlas schema inspect
atlas schema inspect \
-u "horizondb://user:pass@host:5432/app?sslmode=require" > schema.hcl

Plan a declarative migration against the same database - Atlas compares the current state with the desired schema, defined in HCL or SQL, and generates the migration for approval:

atlas schema apply
atlas schema apply \
-u "horizondb://user:pass@host:5432/app?sslmode=require" \
--to file://schema.hcl \
--dev-url "docker://postgres/17/dev"

Declarative & Versioned Workflows

Both workflows are supported end to end. Manage the schema as code and sync it with atlas schema apply, or plan versioned migration files with atlas migrate diff. Either way, push the schema or migration directory to Atlas Registry (atlas schema push, atlas migrate push) and deploy it to any environment with an atlas:// URL:

atlas.hcl
variable "horizondb_url" {
type = string
default = getenv("DATABASE_URL")
}
env "horizondb" {
url = var.horizondb_url
dev = "docker://postgres/17/dev"
migration {
dir = "atlas://app"
}
}
atlas migrate apply
atlas migrate apply --env horizondb

The same setup runs from CI/CD, with native integrations for GitHub Actions, GitLab CI, Bitbucket Pipelines, Azure DevOps, Terraform, and the Kubernetes Operator.

Next Steps

Read the Automatic HorizonDB Schema Migrations guide to set up Atlas against an Azure HorizonDB cluster, push schemas or migration directories to Atlas Registry, and wire migrations into CI/CD.

featurehorizondbazurepostgresschema