Cambia la forma, conserva las filas Change the shape, keep the rows

Binario o herramientaBinary or tool

# herramienta global: instala el comando `sqldiff`global tool: installs the `sqldiff` command
dotnet tool install --global PeopleWorks.SqlSchemaDiff.Cli

sqldiff --version
sqldiff --help

O baja el binario autocontenido para Windows o Linux desde Releases ↗: no hay runtime que instalar al lado, viene incluido.

Or download the self-contained binary for Windows or Linux from Releases ↗: nothing to install alongside it, the runtime is bundled.

Compilar desde el códigoBuild from source

git clone https://github.com/peopleworks/SqlSchemaDiff.git
cd SqlSchemaDiff
dotnet build SqlSchemaDiff.csproj -c Release
dotnet bin/Release/net9.0/sqldiff.dll --help

.NET 9

SDK para compilar; el binario del release no lo necesitaSDK to build; the release binary needs none

SQL Server

2016+ — Developer, Express, Azure SQL

SO / OS

Windows · Linux · macOS

Tres formas más segurasThree safer forms

# un archivo cuyos permisos controlasa file whose permissions you control
sqldiff extract --conn-file ./prod.conn

# indirección por variable nombradaindirection through a named variable
sqldiff extract --conn env:MY_CONN

# la variable por defectothe default variable
SQLDIFF_CONN="Server=…" sqldiff extract

Los dos lados tienen las mismas tres formas.

Both sides have the same three forms.

Verificar antes de compararVerify before comparing

Imprime servidor, base, login, versión y edición de cada lado. Es el primer comando que conviene correr en una máquina nueva.

Prints server, database, login, version and edition for each side. It is the first command worth running on a new machine.

sqldiff check-conn --source-conn "$DEV" --target-conn "$PROD"

En Windows, sin contraseñaOn Windows, no password at all

Server=SQL1;Database=App;Integrated Security=True;
Encrypt=True;TrustServerCertificate=True

extract

sqldiff extract --conn "$DEV" `
  --out schema.sql `
  --json schema.snapshot.json

--out por defecto es schema.sql. --json es opcional y es lo que habilita comparar sin las dos bases en línea.

--out defaults to schema.sql. --json is optional, and it is what makes comparing without both databases online possible.

apply

sqldiff apply --conn "$PROD" `
  --script changes.sql `
  --log apply.log `
  --timeout-seconds 600

El timeout por defecto es de 120 segundos por lote. Súbalo si la migración crea índices grandes.

The default timeout is 120 seconds per batch. Raise it when the migration builds large indexes.

Una transacciónOne transaction

apply, sync y deploy corren cada lote en una sola transacción. Si un lote falla, el cambio entero se revierte y el destino queda exactamente como estaba. --no-transaction se sale de eso.

apply, sync and deploy run every batch in a single transaction. If any batch fails, the whole change rolls back and the target is left exactly as it was. --no-transaction opts out.

Nada se borra si no lo pideNothing is dropped unless you ask

Una columna, constraint o índice que solo existe en el destino se reporta como comentario -- WARNING: y se deja en su lugar.

A column, constraint or index that exists only on the target is reported as a -- WARNING: comment and left in place.

--include-drops

habilita borrar esos objetosenables dropping those objects

--include-table-drops

borrar tablas enteras necesita esto encimadropping whole tables needs this on top

--allow-table-rebuild

permite reconstruir una tabla cuando un ALTER no alcanzaallows rebuilding a table when an ALTER cannot do it

GitHub Actions

- name: Fail if production drifted
  run: |
    sqldiff drift \
      --source-snapshot schema.snapshot.json \
      --target-conn "$PROD_CONN" \
      --out drift.sql
  env:
    PROD_CONN: ${{ secrets.PROD_CONN }}

Códigos de salidaExit codes