Implantar soluções de modelo usando o Utilitário de Implantação

  • Artigo

Aplica-se a: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

O utilitário Microsoft.AnalysisServices.Deployment permite que você inicie o mecanismo de implantação SQL Server Analysis Services no prompt de comando. Como arquivo de entrada, o utilitário usa os arquivos de saída XML gerados pela criação de um projeto de SQL Server Analysis Services em SQL Server Data Tools. Os arquivos de entrada são facilmente modificáveis para personalizar a implantação de um projeto SQL Server Analysis Services. O script de implantação gerado pode ser executado imediatamente ou pode ser salvo para implantação posterior.

O Assistente/Utilitário de Implantação de SQL Server Analysis Services é instalado com o SSMS (SQL Server Managment Studio). Verifique se você está usando a versão mais recente. Por padrão, a versão mais recente do utilitário de implantação instalada com o SSMS 18.x ou superior é instalada em C:\Arquivos de Programas (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE. Quando instalado com o SSMS 17.x anterior, o caminho padrão é C:\Arquivos de Programas (x86)\Microsoft SQL Server\140\Tools\Binn\ManagementStudio.

Sintaxe

Microsoft.AnalysisServices.Deployment [ASdatabasefile]   
    {[/s[:logfile]] | [/a] | [[/o[:output_script_file]] [/d]]}

Argumentos

ASdatabasefile
O caminho completo da pasta na qual o arquivo de script de implantação SQL Server Analysis Services (.asdatabase) está localizado. Esse arquivo é gerado quando você implanta um projeto no SQL Server Data Tools. Ele está localizado na pasta bin do projeto. O arquivo .asdatabase que contém as definições de objetos a serem implantados está localizado. Se não for especificada, a pasta atual será usada.

/s
Executa o utilitário em modo sem confirmação e não exibe nenhuma caixa de diálogo. Para obter mais informações sobre modos, consulte a seção, Modos, mais adiante neste tópico.

Logfile
O caminho completo e o nome do arquivo de log. Eventos de rastreamento serão registrados no arquivo de log especificado. Se o arquivo de log já existir, seu conteúdo será substituído.

/a
Executa o utilitário em modo de resposta. Todas as respostas feitas durante a parte do assistente do utilitário devem ser gravadas novamente nos arquivos de entrada, mas nenhuma alteração será realmente feita nos destinos da implantação.

/o
Executa o utilitário em modo de saída. A implantação não ocorrerá, mas o script XMLA (XML for Analysis) que normalmente é enviado aos destinos da implantação é salvo no arquivo de script de saída especificado. Se o output_script_file não for especificado, o utilitário tentará usar o arquivo de script de saída especificado no arquivo de entrada de opções da implantação (.deploymentoptions). Se um arquivo de script de saída não for especificado no arquivo de entrada de opções da implantação, ocorrerá um erro.

Para obter mais informações sobre modos, consulte a seção, Modos, mais adiante neste tópico.

output_script_file
O caminho completo e o nome do arquivo de script de saída.

/d
Caso o argumento /o seja usado, especifica que o utilitário não deve se conectar à instância de destino. Como nenhuma conexão é feita com os destinos da implantação, o script de saída é gerado com base apenas nas informações recuperadas dos arquivos de entrada.

Observação

O argumento /d é usado apenas no modo de saída. Esse argumento será ignorado se especificado em modo de resposta ou sem confirmação. Para obter mais informações sobre modos, consulte a seção, Modos, mais adiante neste tópico.

Comentários

O utilitário Microsoft.AnalysisServices.Deployment usa um conjunto de arquivos que fornecem as definições de objetos, destinos da implantação, opções da implantação e definições da configuração e tenta implantar as definições de objetos nos destinos de implantação especificados usando as opções de implantação e os parâmetros de configuração especificados. Esse utilitário pode fornecer uma interface do usuário quando invocado em modo de arquivo de resposta ou de saída. Para obter mais informações sobre como usar a interface do usuário fornecida para esse utilitário para criar arquivos de resposta, consulte Implantar soluções de modelo usando o Assistente de Implantação.

O utilitário está localizado na pasta \Arquivos de programas (x86)\Microsoft SQL Server\140\Binn\ManagementStudio.

Modos

O utilitário pode ser executado nos modos listados na tabela a seguir.

Mode Descrição
Modo sem confirmação Nenhuma interface do usuário é exibida e todas as informações necessárias para a implantação são fornecidas pelos arquivos de entrada. Nenhum progresso é exibido pelo utilitário em modo sem confirmação. Em vez disso, um arquivo de log opcional pode ser usado para capturar o progresso e informações de erro para revisão posterior.
Modo de resposta A interface do usuário do Assistente para Implantação é exibida e as respostas do usuário são salvas nos arquivos de entrada especificados para implantação posterior. A implantação não acontece em modo de resposta. O único propósito do modo de resposta é capturar respostas do usuário.
Modo de saída Nenhuma interface do usuário é exibida e todas as informações necessárias para a implantação são fornecidas pelos arquivos de entrada.

No entanto, ao contrário do modo sem confirmação, a saída do utilitário é gravada em um arquivo de script de saída e não é enviada aos destinos de implantação indicados nos arquivos de entrada. A menos que o argumento /d seja especificado, o utilitário se conecta à cada destino de implantação para comparar metadados ao gerar o arquivo de script de saída.

Voltar para Argumentos

Exemplos

O exemplo a seguir mostra como implantar um projeto de SQL Server Analysis Services no modo silencioso, o progresso do log e as mensagens de erro para revisão posterior:

Microsoft.AnalysisServices.Deployment.exe

<drive>:\My Documents\Visual Studio 2010\Projects\AdventureWorksProject\Project1\bin

/s: C:\ My Documents\Visual Studio 2010\Projects\AdventureWorksProject\Project1\bin\deployment.log

Confira também

Referência do utilitário do prompt de comando (mecanismo de banco de dados)