Implementar una aplicación de capa de datos

Artículo
04/27/2023

Se aplica a:SQL Server Azure SQL Database Azure SQL Managed Instance

Implemente una aplicación de capa de datos (DAC) desde un paquete DAC en una instancia existente del motor de base de datos o de Azure SQL Database mediante un asistente o un script de PowerShell.

El proceso de implementación registra una instancia de DAC almacenando la definición de la DAC en la base de datos del sistema msdb (master en SQL Database), crea una base de datos y, después, rellena la base de datos con todos los objetos de base de datos definidos en la DAC.

Implementación del mismo paquete DAC varias veces

El mismo paquete DAC se puede implementar varias veces en una instancia única del motor de base de datos, sin embargo las implementaciones se deben ejecutar de una en una. El nombre de instancia de DAC que se especificó para cada implementación debe ser único en la instancia del motor de base de datos.

Opciones y configuración de bases de datos

De forma predeterminada, la base de datos que se cree durante la implementación incorporará toda la configuración predeterminada de la instrucción CREATE DATABASE, excepto en lo siguiente:

La intercalación y nivel de compatibilidad de las bases de datos se establecen según los valores definidos en el paquete DAC. Un paquete DAC compilado a partir de un proyecto de base de datos en las Herramientas de Desarrollo de SQL Server usa los valores establecidos en el proyecto de base de datos. Un paquete que se haya extraído de una base de datos existente usará los valores de la base de datos original.
Puede ajustar algunos de los valores de configuración de la base de datos, como por ejemplo el nombre de la base de datos y las rutas de archivo, en la página Actualizar la configuración . No puede establecer las rutas de acceso del archivo al realizar la implementación en SQL Database.

Algunas opciones de base de datos, como TRUSTWORTHY, DB_CHAINING y HONOR_BROKER_PRIORITY, no se pueden ajustar en el proceso de implementación. Las propiedades físicas, como el número de grupos de archivos o el número y tamaño de los archivos no se pueden modificar en el proceso de implementación. Una vez se haya completado la implementación, podrá usar la instrucción ALTER DATABASE, SQL Server Management Studio o SQL Server PowerShell para personalizar la base de datos.

Limitaciones y restricciones

Una DAC puede implementarse en SQL Database o una instancia del motor de base de datos que ejecute SQL Server 2005 (9.x) Service Pack 4 (SP4) o posterior. Si crea una DAC usando una versión posterior, la DAC puede contener objetos no admitidos por SQL Server 2005 (9.x). No se pueden implementar esos DAC en instancias de SQL Server 2005 (9.x).

Seguridad y permisos

Los inicios de sesión de la autenticación están almacenados en un paquete DAC sin ninguna contraseña. Cuando el paquete se implementa o actualiza, el inicio de sesión se crea como un inicio de sesión deshabilitado con una contraseña generada. Para habilitar los inicios de sesión, use un inicio de sesión que disponga del permiso ALTER ANY LOGIN y emplee ALTER LOGIN para habilitar el inicio de sesión y asignar una nueva contraseña que pueda comunicar al usuario. Esto no se necesita para los inicios de sesión de Autenticación de Windows, porque SQL Server no administra sus contraseñas.

Una DAC solo la pueden implementar miembros de los roles fijos de servidor sysadmin o serveradmin , o los inicios de sesión que pertenezcan al rol fijo de servidor dbcreator y dispongan de permisos ALTER ANY LOGIN. La cuenta de administrador integrada del sistema de SQL Server denominada sa también puede implementar una DAC.

Al implementar una DAC con inicios de sesión en SQL Database, se requiere la pertenencia a los roles loginmanager o serveradmin. La implementación de una DAC sin inicios de sesión en SQL Database necesita la pertenencia a los roles dbmanager o serveradmin.

Implementación de una DAC mediante un asistente

En el Explorador de objetos, expanda el nodo de la instancia en la que desee implementar la DAC.
Haga clic con el botón derecho en el nodo Bases de datos y seleccione Implementar aplicación de capa de datos...
Finalice los cuadros de diálogo del Asistente y seleccione Finalizar.

Más información sobre algunas de las páginas del asistente:

Página Seleccionar paquete DAC

Especifique el paquete DAC que contiene la aplicación de capa de datos que se va a implementar. La página pasa por tres estados.

Seleccionar el paquete DAC

Seleccionar el paquete DAC que desee implementar El paquete DAC debe ser un archivo de paquete DAC válido y tener una extensión .dacpac.

Paquete DAC: especifique la ruta de acceso y el nombre del archivo del paquete DAC que contiene la aplicación de capa de datos que se va a implementar. Puede seleccionar el botón Examinar a la derecha del cuadro para ir a la ubicación del paquete DAC.

Nombre de aplicación: cuadro de solo lectura que muestra el nombre de DAC que se asignó cuando la DAC se creó o extrajo de una base de datos.

Versión: cuadro de solo lectura que muestra la versión que se asignó cuando la DAC se creó o extrajo de una base de datos.

Descripción: cuadro de solo lectura que muestra la descripción que se escribió cuando la DAC se creó o extrajo de una base de datos.

Validar el paquete de DAC

Muestra una barra de progreso cuando el asistente confirma que el archivo seleccionado es un paquete DAC válido. Si se valida el paquete DAC, el asistente pasa a la versión final de la página Seleccionar paquete , donde podrá comprobar los resultados de la validación. Si el archivo no es un paquete DAC válido, el asistente se queda en Seleccionar paquete DAC. Seleccione otro paquete DAC válido o cancele el asistente y genere un nuevo paquete DAC.

Página Revisar directiva

Revise los resultados de la evaluación de la directiva de selección de servidores de DAC (en caso de que se utilice). La directiva de selección de servidores de DAC es opcional y está asignada a la DAC cuando se crea en Visual Studio. La directiva se sirve de las facetas de la directiva de selección de servidores para especificar las condiciones que debe cumplir una instancia del motor de base de datos para hospedar la DAC.

Resultados de evaluación de condiciones de directivas: muestra si se han cumplido correctamente las condiciones de la directiva de implementación de DAC. Los resultados de la evaluación de cada condición se notifican en una línea independiente.

Las siguientes directivas de selección de servidor siempre se evalúan como falsas al implementar una DAC en SQL Database: la versión del sistema operativo, el lenguaje, las canalizaciones con nombre habilitadas, las plataforma y tcp habilitado.

Pasar por alto infracciones de directivas: use esta casilla para comenzar con la implementación si se produce un error en una o más de las condiciones de la directiva. Seleccione esta opción solamente si está seguro de que todas las condiciones que produjeron errores no evitarán la correcta operación de la DAC.

Página Actualizar la configuración

Especifique los nombres de la instancia de DAC implementada y la base de datos que ha creado la implementación, así como para establecer las opciones de base de datos.

Nombre de la base de datos: especifica el nombre de la base de datos que se creará en la implementación. El valor predeterminado es el nombre de la base de datos de origen de donde se extrajo la DAC. El nombre debe ser único en la instancia del motor de base de datos y cumplir las normas para los identificadores de motores de base de datos.

Si cambia el nombre de la base de datos, los nombres de los archivos de datos y de registro cambiarán para coincidir con el nuevo valor.

El nombre de la base de datos también se utiliza como nombre de la instancia de DAC. El nombre de la instancia se muestra en el nodo del DAC bajo el nodo Aplicaciones de capa de datos en el Explorador de objetos.

Las siguientes opciones no se aplican a SQL Database y no se muestran al implementar en SQL Database.

Utilizar la ubicación de base de datos predeterminada - seleccione esta opción para crear los archivos de datos de la base de datos y los archivos de registro en la ubicación predeterminada para la instancia de motor de base de datos. Los nombres de archivo se generan utilizando el nombre de la base de datos.

Especificar archivos de base de datos: seleccione esta opción para especificar una ubicación o un nombre diferentes para los archivos de datos y de registro.

Ruta de acceso y nombre del archivo de datos: especifique la ruta completa y el nombre de archivo del archivo de datos. El cuadro se rellena con la ruta de acceso y nombre de archivo predeterminados. Modifique la cadena en el cuadro para cambiar el valor predeterminado o utilice el botón Examinar para navegar hasta la carpeta donde el archivo de datos se va a colocar.

Ruta de acceso y nombre del archivo de registro: especifique la ruta de acceso completa y el nombre de archivo del archivo de registro. El cuadro se rellena con la ruta de acceso y nombre de archivo predeterminados. Modifique la cadena en el cuadro para cambiar el valor predeterminado o utilice el botón Examinar para navegar hasta la carpeta donde se va a colocar el archivo de registro.

Página Resumen

Use esta página para comprobar las acciones que el asistente realiza al implementar la DAC.

La siguiente configuración se utilizará en la implementación de su DAC. - Compruebe la información que se muestra para asegurarse de que las acciones emprenda serán las correctas. La ventana muestra el paquete DAC y el nombre que seleccionó para la instancia de DAC implementada. La ventana también muestra los valores de configuración que se utilizarán al crear la base de datos asociada con la DAC.

Página Implementar

Esta página notifica si la operación de implementación se realizó correctamente o no.

Implementación de DAC: notifica si cada acción realizada para implementar la DAC se realizó o no correctamente. Revise la información para determinar si cada acción se realizó o no correctamente. Cualquier acción que encontrara un error tendrá un vínculo en la columna Resultado . Seleccione el vínculo para ver un informe del error para esa acción.

Guardar informe: seleccione este botón para guardar el informe de implementación en un archivo HTML. El archivo notifica el estado de cada acción, incluidos todos los errores generados por cualquiera de las acciones. La carpeta predeterminada es la carpeta SQL Server Management Studio\DAC Packages de la carpeta Documentos de su cuenta de Windows.

Usar PowerShell

Cree un objeto SMO Server y establézcalo en la instancia en la que desea implementar la DAC.
Abra un objeto ServerConnection y conéctese a la misma instancia.
Use System.IO.File para cargar el archivo de paquete DAC.
Use add_DacActionStarted y add_DacActionFinished para suscribirse a los eventos de implementación de la DAC.
Establezca DatabaseDeploymentProperties.
Use el método DacStore.Install para implementar la DAC.
Cierra la secuencia de archivos usada para leer el archivo de paquete DAC.

En el siguiente ejemplo se implementa la DAC denominada MyApplication en una instancia predeterminada del motor de base de datos, mediante una definición de DAC de un paquete de MyApplication.dacpac.

Ejemplos de PowerShell

## Set a SMO Server object to the default instance on the local computer.
CD SQLSERVER:\SQL\localhost\DEFAULT
$server = Get-Item .
  
## Open a Common.ServerConnection to the same instance.
$serverConnection = New-Object Microsoft.SqlServer.Management.Common.ServerConnection($server.ConnectionContext.SqlConnectionObject)
$serverConnection.Connect()
$dacStore = New-Object Microsoft.SqlServer.Management.Dac.DacStore($serverConnection)
  
## Load the DAC package file.
$dacpacPath = "C:\MyDACs\MyApplication.dacpac"
$fileStream = [System.IO.File]::Open($dacpacPath,[System.IO.FileMode]::OpenOrCreate)
$dacType = [Microsoft.SqlServer.Management.Dac.DacType]::Load($fileStream)
  
## Subscribe to the DAC deployment events.
$dacStore.add_DacActionStarted({Write-Host `n`nStarting at $(Get-Date) :: $_.Description})
$dacStore.add_DacActionFinished({Write-Host Completed at $(Get-Date) :: $_.Description})
  
## Deploy the DAC and create the database.
$dacName  = "MyApplication"
$evaluateTSPolicy = $true
$deployProperties = New-Object Microsoft.SqlServer.Management.Dac.DatabaseDeploymentProperties($serverConnection,$dacName)
$dacStore.Install($dacType, $deployProperties, $evaluateTSPolicy)
$fileStream.Close()