Compartilhar via


SQLDacApplication [SPFSDK][VMROLE]

 

Aplica-se a: Windows Azure Pack

O objeto SQLDacApplication fornece configurações para instalar SQL Server DACs (aplicativos de camada de dados) quando uma máquina virtual baseada em Windows é provisionada.

Hierarquia de Tipos

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

Sintaxe

{
    "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",
}

Propriedades

Nome

Tipo

Obrigatório

Valor padrão

Descrição

DeploymentName

String

Sim

Nenhum

O nome da implantação.

ScriptCommands

Matriz de script [SPFSDK][VMROLE]

No

nulo

Scripts a serem executados durante o provisionamento. Os únicos valores válidos para a propriedade Script.ScriptType são:

  • Pré-instalar

  • PostInstall

  • PreService

  • PostService

  • Pré-instalação

  • PostUninstall

SQLScriptCommands

Matriz de SQLScriptCommand

No

nulo

Transe SQL comandos de script que são executados com a instalação do aplicativo da camada de dados SQL Server.

ApplicationPayloadId

String

Sim

Nenhum

O identificador de um item ApplicationProfile.ApplicationPayload . Essa carga deve apontar para um arquivo .sql de script .sql do Transact-SQL.

BlockOnChanges

Boolean

Não

Nenhum

Se for verdadeiro, indica que a atualização do aplicativo da camada de dados SQL Server deverá falhar se houver um descompasso de banco de dados.

Para obter mais informações, consultehttps://go.microsoft.com/fwlink/?LinkID=307133.

Dacinstance

String

Sim

Nenhum

O SQL Server nome do aplicativo da camada de dados da instância do SQL Server.

IgnoreDataLoss

Boolean

Não

Nenhum

Se for verdadeiro, indica que um erro de perda de dados deve ser ignorado em um SQL Server atualização de aplicativo da camada de dados.

Para obter mais informações, consultehttps://go.microsoft.com/fwlink/?LinkID=307133.

RollbackOnFailure

Boolean

Sim

Nenhum

Se verdadeiro, indica que o banco de dados deve ser revertido se houver uma falha de atualização.

Para obter mais informações, consultehttps://go.microsoft.com/fwlink/?LinkID=307133.

SQLAuthenticationType

String

Sim

Nenhum

O tipo de autenticação usado para implantar o aplicativo da camada de dados SQL Server. Os valores válidos são:

  • WindowsAuthentication

  • SQLAuthentication

SQLDeploymentCredential

String

Sim

Nenhum

A credencial a ser usada durante a instalação do aplicativo da camada de dados SQL Server, em um formato domain\username:password.

SQLInstance

String

Não

MSSQLSERVER

O nome da instância de SQL Server à qual o aplicativo da camada de dados SQL Server deve ser implantado.

SkipPolicyValidation

Boolean

Sim

Nenhum

Se for verdadeiro, indica que a validação da política de SQL Server deve ser ignorada quando um aplicativo da camada de dados SQL Server for atualizado.

Para obter mais informações, consultehttps://go.microsoft.com/fwlink/?LinkID=307133.

DesinstalarMode

String

Sim

Nenhum

O comportamento de desinstalação do aplicativo da camada de dados SQL Server em relação ao banco de dados. Os valores válidos são:

  • MakeUnmanaged

  • DetachDatabase

  • DropDatabase

Para obter mais informações, consultehttps://go.microsoft.com/fwlink/?LinkID=307135.

SQLScriptCommand

Para obter mais informações sobre o script do PowerShell do Virtual Machine ManagerWindows usado por esta seção, consulte https://go.microsoft.com/fwlink/?LinkID=218391.

Nome

Tipo

Obrigatório

Valor padrão

Descrição

DatabaseName

String

Sim

Nenhum

O nome do banco de dados no qual esse comando de script é executado.

DeploymentOrder

int

Sim

Nenhum

A ordem na qual executar esse comando de script.

EncryptConnection

Boolean

No

Falso

Se for verdadeiro, indica a criptografia da conexão com a instância do SQL Server.

ExecutionTimeoutSeconds

int

Sim

Nenhum

O tempo limite para o comando script, em segundos.

LoginTimeoutSeconds

Yes

Sim

Nenhum

O tempo limite para estabelecer uma conexão com a instância do SQL Server, em segundos.

OutputFilePath

String

Não

Nenhum

O caminho do arquivo de log para capturar toda a saída.

SQLAuthenticationType

String

Sim

Nenhum

O tipo de autenticação usado para implantar o aplicativo da camada de dados SQL Server. Os valores válidos são:

  • WindowsAuthentication

  • SQLAuthentication

CommandParameters

String

Não

nulo

Pares nome-valor de parâmetros de comando a serem usados com o comando SQL.

Para obter mais informações, consulte a opção -v da documentação da ferramenta Sqlcmd em https://go.microsoft.com/fwlink/?LinkID=154481.

SQLScriptApplicationPayloadId

String

Sim

Nenhum

O identificador de um item ApplicationProfile.ApplicationPayload . Essa carga deve apontar para um arquivo .sql de script .sql SQL Transact.

ScriptCredential

String

Sim

Nenhum

A credencial usada para executar o script, em um formato domain\username:password .

ScriptType

String

Sim

Nenhum

A especificação de quando o script deve ser executado. Os valores válidos são:

  • Pré-instalar

  • PostInstall

  • PreService

  • PostService

  • Pré-instalação

  • PostUninstall

Comentários

O exemplo de código a seguir fornece um objeto SQLDacApplication de exemplo.

{
    "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 Também

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