Detección y resolución de la deriva del esquema
El proyecto de base de datos SQL indica que la Customers tabla tiene 12 columnas. La producción tiene 13. Alguien agregó una LoyaltyTier columna directamente a través de SQL Server Management Studio (SSMS) el jueves pasado durante un incidente. La siguiente implementación quitará silenciosamente esa columna porque el proyecto no sabe que existe. Este tipo de situación se conoce como desfase de esquema y es una de las formas en que las canalizaciones de CI/CD interrumpen la producción sin advertencia.
Comprender el desfase del esquema
La desviación del esquema es la diferencia entre lo que define tu proyecto y lo que realmente existe en la base de datos en vivo. Las causas más comunes son:
-
Cambios manuales: alguien abre una ventana de consulta y ejecuta
ALTER TABLEfuera del flujo de trabajo normal. - Parches de emergencia: un problema de producción se soluciona a las 2 a.m. y la corrección nunca se integra nuevamente en el proyecto.
- Herramientas de terceros: agentes de supervisión o marcos de asignación objeto-relacional (ORM, por sus siglas en inglés) que crean o modifican objetos en segundo plano.
El peligro no es el desfase en sí. Es lo que sucede a continuación. La canalización implementa .dacpac, SqlPackage calcula la diferencia y todos los objetos sobre los que el proyecto no tiene conocimiento se quitan. La detección del desfase antes de que se ejecute la implementación es fundamental.
Detección del desfase con comparación de esquemas
Las herramientas de comparación de esquemas permiten contener dos definiciones de base de datos en paralelo. Puede comparar cualquier combinación de una base de datos activa, un proyecto de base de datos SQL o un .dacpac archivo. Al comparar una base de datos activa con el proyecto, los resultados muestran todas las diferencias, agrupadas por tipo de acción (Create, Alter, Delete) con las definiciones de origen y destino que se muestran para cada objeto.
En Visual Studio o Visual Studio Code, inicie la comparación de esquemas desde el menú de SQL Server o la vista Proyectos de base de datos. Apunte el origen a la base de datos activa y el destino al proyecto. La cuadrícula de comparación muestra lo que es diferente y lo que cambiaría si los trajese a la alineación.
Nota:
La dirección es reversible. Compare la base de datos a proyecto para buscar el desfase. Compare project-to-database para obtener una vista previa de lo que cambiaría una implementación. Misma herramienta, perspectiva opuesta.
Opciones de comparación de esquemas
No importan todas las diferencias. Puede ajustar la comparación para centrarse en lo que es significativo:
- Omita el espacio en blanco para omitir las diferencias de solo formato.
- Omita el orden de las columnas cuando la posición de la columna sea irrelevante para la aplicación.
- Bloquee la posible pérdida de datos para marcar operaciones destructivas, como quitar columnas que contienen datos.
Guarde la configuración de comparación como un archivo .scmp y súbalo a su repositorio. Almacena el origen, el destino, las opciones de comparación y los tipos de objeto excluidos, lo que hace que las comprobaciones de desfase se puedan repetir en todo el equipo.
Importación de cambios de la base de datos en el proyecto
Una vez que haya detectado un desfase, debe decidir: ¿la base de datos activa tiene la versión correcta o el proyecto? Si la revisión de producción es correcta, incorpórelo al proyecto para que su origen de la verdad se mantenga preciso.
Uso de la comparación de esquemas para aplicar cambios
En los resultados de la comparación, seleccione las diferencias específicas que desea importar y aplicarlas. La interfaz gráfica de Visual Studio y Visual Studio Code te permite seleccionar cambios específicos. Acepte el índice de la revisión, pero ignore la tabla temporal del agente de supervisión, por ejemplo.
Automatiza con SqlPackage Extract
Para escenarios de CI/CD o comprobaciones de desfase programadas, use SqlPackage Extract para extraer el esquema activo en archivos:
sqlpackage /Action:Extract /SourceConnectionString:"{connection string}" /TargetFile:MyDatabaseProject /p:ExtractTarget=SchemaObjectType
📝 Esto extrae objetos de base de datos en archivos organizados por esquema y tipo de objeto. Con la carpeta del proyecto bajo Git, ejecutar git status después de la extracción revela exactamente cuáles archivos cambiaron. Ese es el informe de desfase automatizado.
Tres comandos proporcionan un recuento de desfases:
rm -rf MyDatabaseProject
sqlpackage /Action:Extract /SourceConnectionString:"{connection string}" /TargetFile:MyDatabaseProject /p:ExtractTarget=SchemaObjectType
git status --porcelain | wc -l
📝 La salida es el número de archivos que han cambiado, lo que le proporciona un recuento de desfases automatizado.
Revisión de los cambios de implementación antes de aplicarlos
Ha visto las acciones Script y DeployReport en la unidad anterior sobre compilación e implementación. En un contexto de detección de desfase, estos mismos comandos le ayudan a comprobar qué haría SqlPackage antes de ejecutarlo en producción.
Generación de un script de implementación
La Script acción genera el T-SQL exacto que se ejecutaría, sin ejecutarlo realmente:
dotnet build MyProject.sqlproj
sqlpackage /Action:Script /SourceFile:bin/Debug/MyProject.dacpac /TargetConnectionString:"{connection string}" /DeployScriptPath:Deployment.sql
Revise Deployment.sql para ver cada ALTER, CREATE, y DROP que la implementación ejecutaría. Almacene el script como un artefacto de canalización para su aprobación antes de ejecutarlo en producción.
Generación de un informe de implementación
La DeployReport acción genera un resumen XML de las operaciones planeadas:
sqlpackage /Action:DeployReport /SourceFile:bin/Debug/MyProject.dacpac /TargetConnectionString:"{connection string}" /OutputPath:report.xml
El informe muestra operaciones como Create, Alter, Dropy TableDataMotion. Analice el XML de la canalización para desencadenar alertas en eventos de alto impacto, como transferencias de datos, recompilaciones de índices agrupados o eliminaciones de columnas.
<DeploymentReport xmlns="http://schemas.microsoft.com/sqlserver/dac/DeployReport/2012/02">
<Alerts />
<Operations>
<Operation Name="Create">
<Item Value="[dbo].[Products].[IX_Products_CategorySlug]" Type="SqlIndex" />
</Operation>
<Operation Name="Alter">
<Item Value="[dbo].[Customers]" Type="SqlTable" />
</Operation>
</Operations>
</DeploymentReport>
Comprobación de la coherencia de .dacpac con DacpacVerify
DacpacVerify compara dos .dacpac archivos e informa de las diferencias entre estos, incluidos los scripts previos a la implementación, scripts posteriores a la implementación, variables SQLCMD, referencias de base de datos, propiedades y objetos de base de datos. Esta comparación es útil al convertir desde un proyecto original de SQL Server Data Tools (SSDT) al estilo del SDK o al validar que una canalización genera el artefacto esperado.
Instálelo como una herramienta global de .NET: ejecútelo contra dos archivos .dacpac.
dotnet tool install -g microsoft.dacpacverify
dacpacverify before.dacpac after.dacpac
Conclusiones clave
La desviación del esquema ocurre cuando la base de datos activa difiere del proyecto SQL, a menudo causado por parches, cambios manuales no planificados o ediciones directas en producción. Las herramientas de comparación de esquemas detectan diferencias entre una base de datos y un proyecto, lo que le permite elegir qué cambios extraer del proyecto o insertar en la base de datos. Guarde la configuración de comparación de esquemas en .scmp archivos para que el equipo use opciones coherentes cada vez. Automatice la detección de desfase ejecutando SqlPackage /Action:Extract según una programación y comparando el proyecto extraído con el repositorio. Use SqlPackage /Action:DeployReport para obtener una vista previa de todos los cambios planeados CREATE, ALTERy DROP antes de aplicar los cambios. El objetivo no es evitar el desfase por completo, sino detectarlo temprano y resolverlo antes de que la siguiente implementación convierta un hotfix en una marcha atrás. A continuación, compilará las canalizaciones de CI/CD que automatizan todo el ciclo de compilación e implementación.