Azure Database

Prerequisites

Azure Database for PostgreSQL instance
Access to Azure Portal
Xata account and project setup with a running main branch
Network access to your Azure database

Install and Configure the Xata CLI

Install the Xata CLI:

curl -fsSL https://xata.io/install.sh | bash

Authenticate with your Xata account:

xata auth login

Find the Azure Database connection string

Azure connection strings typically look like this:

postgresql://your_username:your_password@your-server.postgres.database.azure.com:5432/postgres?sslmode=require

You can find the database endpoint in the Azure console.

Initialize Xata project

Go to a local folder that you want to save the Xata configuration to and initialize it like this:

xata init

Select your organization and project you want to use. For the database name you can either choose a new one (e.g xata) or use the same that you have in Azure. If the database doesn’t exist, it will be created. In case you need to redo this step, you can reset the configuration by deleting the .xata/project.json file and running xata init again.

Start the migration

Begin the data transfer:

xata clone start --validation-mode relaxed --source-url '<<azure-connection-string>>'

Depending on how large the source database is, this step might take a while. A progress bar will show you the progress in the CLI.

Verification

After migration, verify your data:

Connect to Xata Branch:
psql `xata branch url`

Check Data Integrity:

-- List tables
\dt

-- Compare row counts
SELECT COUNT(*) FROM your_table;

-- Check sample data
SELECT * FROM your_table LIMIT 10;

​Prerequisites

​Install and Configure the Xata CLI

​Find the Azure Database connection string

​Initialize Xata project

​Start the migration

​Verification