SqlServerDacpacDeployment@1: tarea de implementación de base de datos de SQL Server (en desuso) v1

Use esta tarea para implementar una base de datos de SQL Server mediante DACPAC.

Importante

Esta tarea está en desuso y se retirará el 31 de enero de 2024. Use la implementación de aplicaciones web de IIS mediante WinRM - Viual Studio Marketplace.

Syntax

# SQL Server database deploy (Deprecated) v1
# Deploy a SQL Server database using DACPAC.
- task: SqlServerDacpacDeployment@1
  inputs:
    EnvironmentName: # string. Required. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    #Protocol: # 'Http' | 'Https'. Protocol. 
    #TestCertificate: true # boolean. Optional. Use when Protocol = Https. Test Certificate. Default: true.
  # Deployment
    DacpacFile: # string. Required. DACPAC File. 
  # Target
    TargetMethod: 'server' # 'server' | 'connectionString' | 'publishProfile'. Required. Specify SQL Using. Default: server.
    ServerName: 'localhost' # string. Required when TargetMethod = server. Server Name. Default: localhost.
    DatabaseName: # string. Required when TargetMethod = server. Database Name. 
    #SqlUsername: # string. Optional. Use when TargetMethod = server. SQL Username. 
    #SqlPassword: # string. Optional. Use when TargetMethod = server. SQL Password. 
    #ConnectionString: # string. Required when TargetMethod = connectionString. Connection String. 
    #PublishProfile: # string. Publish Profile. 
    #AdditionalArguments: # string. Additional Arguments. 
  # Advanced
    #DeployInParallel: true # boolean. Deploy in Parallel. Default: true.
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineFilter: # string. Deploy to Machines.

Entradas

EnvironmentName - Máquinas
string. Obligatorio.

Especifica una lista separada por comas de direcciones IP de máquina o FQDN junto con puertos. El puerto predeterminado se basa en el protocolo seleccionado. Por ejemplo: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986 también se pueden proporcionar variables de salida de otras tareas, por ejemplo $(variableName).

AdminUserName - Inicio de sesión del administrador
string.

Especifica el inicio de sesión de administrador para las máquinas de destino.

AdminPassword - Contraseña
string.

Especifica la contraseña de administrador para las máquinas de destino. Las variables definidas en definiciones de compilación o versión se aceptan como $(passwordVariable). Puede marcar el tipo de variable como secret para protegerlo.

Protocol - Protocolo
string. Valores permitidos: Http, Https.

Especifica el protocolo que se va a usar para la conexión winRM con las máquinas. El valor predeterminado es HTTPS.

TestCertificate - Certificado de prueba
boolean. Opcional. Use cuando Protocol = Https. Valor predeterminado: true.

Omite la validación de autenticidad del certificado de la máquina por una entidad de certificación de confianza. El parámetro es necesario para el protocolo HTTPS de WinRM.

DacpacFile - Archivo DACPAC
string. Obligatorio.

Especifica la ubicación del archivo DACPAC en las máquinas de destino o en una ruta de acceso UNC, como \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. La ruta de acceso UNC debe ser accesible para la cuenta de administrador de la máquina. También se admiten variables de entorno, como $env:windir, $env:systemrooty $env:windir\FabrikamFibre\Web.

TargetMethod - Especificar SQL mediante
string. Obligatorio. Valores permitidos: server, connectionString (Cadena de conexión), publishProfile (Perfil de publicación). Valor predeterminado: server.

Especifica la opción para conectarse a la base de datos de SQL Server de destino. Puede proporcionar SQL Server detalles de la base de datos, un SQL Server cadena de conexión o un archivo XML de perfil de publicación.

ServerName - Nombre del servidor
string. Necesario cuando TargetMethod = server. Valor predeterminado: localhost.

Especifica el nombre SQL Server, como machinename\FabriakmSQL,1433 o localhost.\SQL2012R2. Especificar localhost se conecta a la instancia de SQL Server predeterminada en el equipo.

DatabaseName - Nombre de la base de datos
string. Necesario cuando TargetMethod = server.

Especifica el nombre de la base de datos de SQL Server.

SqlUsername - Nombre de usuario de SQL
string. Opcional. Use cuando TargetMethod = server.

Si se especifica el inicio de sesión de SQL Server, se usa para conectarse al SQL Server. La autenticación integrada predeterminada usa las credenciales del administrador de la máquina.

SqlPassword - Contraseña de SQL
string. Opcional. Use cuando TargetMethod = server.

Si se especifica el nombre de usuario de inicio de sesión de SQL Server, proporcione la contraseña SQL Server. La autenticación integrada predeterminada usa las credenciales del administrador de la máquina.

ConnectionString - Cadena de conexión
string. Necesario cuando TargetMethod = connectionString.

Especifica el SQL Server cadena de conexión, como Server=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder;.

PublishProfile - Publicar perfil
string.

Proporciona un control específico sobre SQL Server creación o actualización de la base de datos. Especifica la ruta de acceso al archivo XML del perfil de publicación en el equipo de destino o en un recurso compartido UNC al que pueden acceder las credenciales del administrador de la máquina.

AdditionalArguments - Argumentos adicionales
string.

Especifica argumentos adicionales SqlPackage.exe que se aplican al crear o actualizar la base de datos de SQL Server, como /p:IgnoreAnsiNulls=True o /p:IgnoreComments=True. Estos argumentos invalidarán la configuración del archivo XML del perfil de publicación (si se proporciona).

DeployInParallel - Implementación en paralelo
boolean. Valor predeterminado: true.

Cuando se establece trueen , ejecuta la tarea de implementación de base de datos en paralelo en las máquinas de destino.

ResourceFilteringMethod - Seleccionar máquinas por
string. Valores permitidos: machineNames (Nombres de máquina), tags. Valor predeterminado: machineNames.

Opcional. Especifica un subconjunto de máquinas proporcionando nombres de máquina o etiquetas.

MachineFilter - Implementación en máquinas
string.

Esta entrada solo es válida para grupos de máquinas y aún no es compatible con una lista plana de máquinas o variables de salida.
Especifica una lista de máquinas, como dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34, o etiquetas, como Role:DB; OS:Win8.1. Si se proporcionan varias etiquetas, la tarea se ejecuta en todas las máquinas con las etiquetas especificadas. En El caso de los grupos de recursos de Azure, proporcione el nombre de la máquina virtual, como ffweb o ffdb. El valor predeterminado ejecuta la tarea en todas las máquinas.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	None
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	1.96.2 o superior
Categoría de la tarea:	Implementación