Compartir a través de


SQLDacApplication [SPFSDK][VMROLE]

 

Se aplica a: Windows Azure Pack

El objeto SQLDacApplication proporciona la configuración para instalar SQL Server aplicaciones de capa de datos (DAC) cuando se aprovisiona una máquina virtual basada en Windows.

Jerarquía de tipos

ResourceExtension [SPFSDK][VMROLE]. ExtensionSettings [SPFSDK][VMROLE]. ApplicationProfile.WindowsApplicationProfile [SPFSDK][VMROLE]. SQLDacApplication

Sintaxis

{
    "DeploymentName": "string",

    "ScriptCommands": [
        <Script>
    ],

    "SQLScriptCommands": [
        {
            "DatabaseName": "string",
            "DeploymentOrder": integer,
            "EncryptConnection": boolean,
            "ExecutionTimeoutSeconds": integer,
            "LoginTimeoutSeconds": integer,
            "OutputFilePath": "string",
            "SQLAuthenticationType": "string",
            "CommandParameters": "string",
            "SQLScriptApplicationPayloadId": "string",
            "ScriptCredential": credential string,
            "ScriptType": "string",
        }
    ],

    "ApplicationPayloadId": "string",
    "BlockOnChanges": boolean,
    "DacInstance": "string",
    "IgnoreDataLoss": boolean,
    "RollbackOnFailure": boolean,
    "SQLAuthenticationType": "string",

    "SQLDeploymentCredential": credential string,

    "SQLInstance": "string",
    "SkipPolicyValidation": boolean,
    "UninstallMode": "string",
}

Propiedades

Nombre

Tipo

Obligatorio

Valor predeterminado

Descripción

DeploymentName

String

None

Nombre de la implementación.

ScriptCommands

Matriz de script [SPFSDK][VMROLE]

No

null

Scripts que se ejecutarán durante el aprovisionamiento. Los únicos valores válidos para la propiedad Script.ScriptType son:

  • Preinstalar

  • PostInstall

  • PreService

  • PostService

  • PreUninstall

  • PostUninstall

SQLScriptCommands

Matriz de SQLScriptCommand

No

null

Realice transacciones SQL comandos de script que se ejecutan con la instalación de la aplicación de capa de datos SQL Server.

ApplicationPayloadId

String

None

Identificador de un elemento ApplicationProfile.ApplicationPayload . Esta carga debe apuntar a un archivo .sql de script de Transact-SQL.

BlockOnChanges

Boolean

No

None

Si es true, indica que se debe producir un error en la actualización de la aplicación de capa de datos SQL Server si hay un desfase de base de datos.

Para obtener más información, consultehttps://go.microsoft.com/fwlink/?LinkID=307133.

DacInstance

String

None

El SQL Server nombre de aplicación de capa de datos de la instancia de SQL Server.

IgnoreDataLoss

Boolean

No

None

Si es true, indica que se debe omitir un error de pérdida de datos en una actualización de aplicación de capa de datos SQL Server.

Para obtener más información, consultehttps://go.microsoft.com/fwlink/?LinkID=307133.

RollbackOnFailure

Boolean

None

Si es true, indica que la base de datos debe revertirse si se produce un error de actualización.

Para obtener más información, consultehttps://go.microsoft.com/fwlink/?LinkID=307133.

SQLAuthenticationType

String

None

Tipo de autenticación que se usa para implementar la aplicación de capa de datos SQL Server. Los valores válidos son:

  • WindowsAuthentication

  • SQLAuthentication

SQLDeploymentCredential

String

None

Credencial que se va a usar durante la instalación de la aplicación de capa de datos SQL Server, en un formato domain\username:password.

SQLInstance

String

No

MSSQLSERVER

Nombre de la instancia de SQL Server a la que se va a implementar la aplicación de capa de datos SQL Server.

SkipPolicyValidation

Boolean

None

Si es true, indica que se debe omitir la validación de directivas de SQL Server cuando se actualiza una aplicación de capa de datos de SQL Server.

Para obtener más información, consultehttps://go.microsoft.com/fwlink/?LinkID=307133.

UninstallMode

String

None

Comportamiento de desinstalación de la aplicación de capa de datos SQL Server con respecto a la base de datos. Los valores válidos son:

  • MakeUnmanaged

  • DetachDatabase

  • DropDatabase

Para obtener más información, consultehttps://go.microsoft.com/fwlink/?LinkID=307135.

SQLScriptCommand

Para obtener más información sobre el script de PowerShell de Virtual Machine ManagerWindows que usa esta sección, vea https://go.microsoft.com/fwlink/?LinkID=218391.

Nombre

Tipo

Obligatorio

Valor predeterminado

Descripción

DatabaseName

String

None

Nombre de la base de datos con la que se ejecuta este comando de script.

DeploymentOrder

Int

None

Orden en el que se va a ejecutar este comando de script.

EncryptConnection

Boolean

No

False

Si es true, indica el cifrado de la conexión a la instancia de SQL Server.

ExecutionTimeoutSeconds

Int

None

Tiempo de espera del comando script, en segundos.

LoginTimeoutSeconds

None

Tiempo de espera para establecer una conexión con la instancia de SQL Server, en segundos.

OutputFilePath

String

No

None

Ruta de acceso del archivo de registro para capturar toda la salida.

SQLAuthenticationType

String

None

Tipo de autenticación que se usa para implementar la aplicación de capa de datos SQL Server. Los valores válidos son:

  • WindowsAuthentication

  • SQLAuthentication

CommandParameters

String

No

null

Pares nombre-valor de parámetros de comando que se van a usar con el comando SQL.

Para obtener más información, vea el modificador -v de la documentación de la herramienta Sqlcmd en https://go.microsoft.com/fwlink/?LinkID=154481.

SQLScriptApplicationPayloadId

String

None

Identificador de un elemento ApplicationProfile.ApplicationPayload . Esta carga debe apuntar a un archivo .sql de script de Transact SQL.

ScriptCredential

String

None

Credencial que se usa para ejecutar el script, en un formato domain\username:password .

ScriptType

String

None

Especificación de cuándo se debe ejecutar el script. Los valores válidos son:

  • Preinstalar

  • PostInstall

  • PreService

  • PostService

  • PreUninstall

  • PostUninstall

Comentarios

En el ejemplo de código siguiente se proporciona un objeto SQLDacApplication de ejemplo.

{
    "DeploymentName": "SQL App 1",

    "ScriptCommands": [
        {
            "AlwaysReboot": false,
            "ApplicationPayloadId": null,
            "ErrorPolicy": "FailOnMatch",
            "ExecutableAndParams": null,
            "ExitCodeRegex": "[1-9][0-9]*",
            "MaxOutputSize": 1048576,
            "RebootExitCodeRegex": "{1641}|{3010}|{3011}",
            "RestartOnRetry": false,
            "ScriptBlock": "rem some script that needs to run before sqldac package is installed",
            "ScriptCredential": {
                "Password": "mypassword4",
                "UserName": "dcmanagerlab\\esdcvsec4"
            },
            "ScriptType": "PreInstall",
            "StandardErrorPath": "c:\\err.txt",
            "StandardErrorRegex": ".+",
            "StandardInput": null,
            "StandardOutputPath": "c:\\out.txt",
            "StandardOutputRegex": null,
            "TimeoutInSeconds": 900,
            "WorkingDirectory": null
        }
    ],

    "SQLScriptCommands": [
        {
            "DatabaseName": "[Param.SharepointDB]",
            "DeploymentOrder": 1,
            "EncryptConnection": false,
            "ExecutionTimeoutSeconds": 500,
            "LoginTimeoutSeconds": 50,
            "OutputFilePath": "c:\\sharepointDB.sql.log",
            "SQLAuthenticationType": "WindowsAuthentication",
            "CommandParameters" : "VAR1=42 VAR2=\"Example String\"",
            "SQLScriptApplicationPayloadId": "db04416b-d0a8-44d5-b0ee-d5739378a98d",
            "ScriptCredential": "[Param.SQLScriptCommandCredential]",
            "ScriptType": "PostInstall"
        }
    ],

    "ApplicationPayloadId": "5b064b6a-d6d0-48f0-8979-9aafc676a9e5",
    "BlockOnChanges": false,
    "DacInstance": "[Param.SharepointDB]",
    "IgnoreDataLoss": false,
    "RollbackOnFailure": true,
    "SQLAuthenticationType": "WindowsAuthentication",

    "SQLDeploymentCredential": "[param.SQLDeploymentCredential]",

    "SQLInstance": "[Param.SQLInstance]",
    "SkipPolicyValidation": true,
    "UninstallMode": "DropDatabase"
}

Consulte también

ApplicationProfile.WindowsApplicationProfile [SPFSDK][VMROLE]
SQLProfile [SPFSDK][VMROLE]
WebDeployApplication [SPFSDK][VMROLE]
ScriptApplication [SPFSDK][VMROLE]
Script [SPFSDK][VMROLE]