Implantar soluções de modelo usando o Assistente de Implantação

Artigo
05/08/2023

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

O Assistente de Implantação de SQL Server Analysis Services usa arquivos de saída JSON gerados de um projeto SQL Server Analysis Services como arquivos de entrada. Esses 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 é instalado com o SSMS (SQL Server Management Studio). Verifique se você está usando a versão mais recente. Se estiver em execução no prompt de comando, por padrão, a versão mais recente do assistente de implantação será instalada em C:\Arquivos de Programas (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE.

Você pode implantar usando o assistente, conforme descrito aqui. É possível automatizar a implantação ou usar o recurso Sincronizar. Se o banco de dados implantado for grande, considere o uso de partições em sistemas específicos. Você pode automatizar a criação e a população de partições usando o TOM (Modelo de Objeto Tabular), o TMSL (Tabular Model Scriting Language) e o AMO (Analysis Management Objects).

Importante

Nem os arquivos de saída nem o script de implantação conterão a ID de usuário ou a senha se eles forem especificados no cadeia de conexão para uma fonte de dados ou para fins de representação. Como eles são necessários para fins de processamento nesse cenário, você adicionará essas informações manualmente. Se a implantação não incluir processamento, você pode adicionar essa conexão e as informações de representação conforme necessário, depois da implantação. Se a implantação incluir processamento, você poderá adicionar essas informações dentro do assistente ou no script de implantação depois de ele ter sido salvo.

Executar o Assistente de Implantação

O Assistente de Implantação pode ser executado das seguintes maneiras:

Interativamente – Quando executado interativamente, o Assistente de Implantação gera um script de implantação com base nos arquivos de entrada, conforme modificado interativamente pela entrada do usuário. O assistente aplica qualquer modificação de usuário somente ao script de implantação. O assistente não modifica os arquivos de entrada.
No prompt de comando – quando executado no prompt de comando, o Assistente de Implantação gera um script de implantação com base nas opções que você usa para executar o assistente. O assistente pode executar qualquer uma destas ações: alertá-lo para entrada de usuário e modificar arquivos de entrada com base naquela entrada; executar uma implantação autônoma silenciosa, que usa os arquivos de entrada como são; ou criar um script de implantação que você pode usar depois.

Executar de maneira interativa

Quando executado interativamente, o Assistente de Implantação lê os valores dos arquivos de entrada e apresenta essas informações para você. Você pode modificar esses valores de entrada, como destino de implantação, definições de configuração, opções de implantação e senhas de cadeia de conexão ou deixá-los como estão. Se você alterar os valores de entrada, o assistente usará essas alterações ao gerar o script de implantação. Porém, o assistente não faz nenhuma alteração nos valores do arquivo de entrada.

Observação

Se você quiser que o Assistente de Implantação modifique os valores de entrada, execute o assistente no prompt de comando e defina o assistente para ser executado no modo de arquivo de resposta.

Depois de examinar os valores de entrada e fazer as alterações desejadas, o assistente gerará o script de implantação. Você pode executar esse script de implantação imediatamente no servidor de destino ou salvá-lo para uso posterior.

Para executar o Assistente para Implantação do Analysis Services interativamente

Clique em Iniciar e digite Assistente de Implantação do Analysis Services.

-ou-
Na pasta Projetos do projeto SQL Server Analysis Services, clique duas vezes no arquivo nome> do <projeto.asdatabase.

Observação

Se você não encontrar o arquivo .asdatabase, use Pesquisar e especifique *.asdatabase. Ou talvez seja necessário criar o projeto no SSDT.

Executar no prompt de comando

O Assistente de Implantação também pode ser executado no prompt de comando. Quando executado no prompt de comando, você fornece o caminho completo para o arquivo .asdatabase e executa o assistente em um dos seguintes modos:

Modo de arquivo de resposta
No modo de arquivo de resposta, o assistente permite modificar interativamente os arquivos de entrada que foram originalmente gerados quando o projeto SQL Server Analysis Services foi criado SQL Server Data Tools. O assistente salva esses arquivos de entrada modificados antes de gerar o script de implantação. Os arquivos de entrada modificados tornam-se o novo ponto de partida na próxima vez que o assistente for executado.

Para executar o assistente no modo de arquivo de resposta, use a opção / a.

Modo sem confirmação
No modo silencioso, o assistente executa uma implantação autônoma silenciosa com base na informação residente nos arquivos de entrada.

Para executar o assistente no modo silencioso, use a opção /s . Quando você executar o assistente no modo silencioso, serão produzidas mensagens para o console ou, se fornecido, para um arquivo de log.

Modo de saída
No modo de saída, o assistente gera um script de implantação para execução posterior com base nos arquivos de entrada.

Para executar o assistente no modo de saída, use a opção /o e forneça um nome de arquivo de saída.

Para obter mais informações sobre essas opções de linha de comando, consulte Implantar soluções de modelo com o Utilitário de Implantação.

Para executar o Assistente para Implantação do Analysis Services no prompt de comando

Se estiver instalado com o SSMS 18.x, abra um prompt de comando e navegue até o caminho padrão C:\Arquivos de Programas (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE.
Digite Microsoft.AnalysisServices.Deployment.exe seguido pelas opções que correspondem ao modo no qual você deseja executar o assistente.

Reconhecimento do script de implantação

O script de implantação XMLA gerado pelo Assistente de Implantação consiste em duas seções:

A primeira parte do script de implantação contém os comandos necessários para criar, alterar ou excluir os objetos apropriados do Microsoft SQL Server no banco de dados de destino. Por padrão, os arquivos de entrada gerados pelo projeto SQL Server Analysis Services são baseados em uma implantação incremental. Como resultado, o script de implantação XMLA afetará apenas os objetos que foram alterados ou excluídos.
A segunda parte do script de implantação contém os comandos necessários para processar apenas os objetos criados ou alterados no servidor de destino (a opção Processar Padrão) ou processar o banco de dados de destino completamente. Você também pode escolher fazer com que o script de implantação não contenha nenhum comando de processamento.

O script de implantação inteiro pode ser executado em uma única transação ou em várias transações. Se o script for executado em várias transações, a primeira parte do script será executada como uma única transação e cada objeto será processado em sua própria transação.

Importante

O Assistente de Implantação do SQL Server Analysis Services implanta apenas objetos em um único banco de dados SQL Server Analysis Services. Não implanta nenhum objeto ou dados no nível do servidor.

Arquivos de script de implantação – Entrada usada para criar o script de implantação

Quando você cria um projeto, SQL Server Data Tools gera arquivos para o projeto. SQL Server Data Tools coloca esses arquivos na pasta Saída do projeto. Por padrão, a saída é colocada na pasta \Bin. A tabela a seguir lista os arquivos XML que SQL Server Data Tools cria:

Arquivo	Descrição
<nome do> projeto. asdatabase	Um arquivo XMLA para projetos de modelo de tabela multidimensionais ou 1100/1103 ou um arquivo JSON para projetos de modelo Tabular 1200 e superior. Contém as definições declarativas para todos os objetos SQL Server Analysis Services no projeto.
<nome do> projeto. deploymenttargets	Contém o nome da instância de SQL Server Analysis Services e do banco de dados no qual os objetos SQL Server Analysis Services serão criados.
<nome do> projeto. configsettings	Contém configurações específicas do ambiente, como informações de conexão de fonte de dados e locais de armazenamento de objeto. As configurações neste arquivo substituem as configurações no arquivo nome> do < projeto.asdatabase.
<nome do> projeto. deploymentoptions	Contém opções de implantação como se a implantação é transacional e se objetos implantados deveriam ser processados depois da implantação.

SQL Server Data Tools nunca armazena senhas nos arquivos de projeto.

Modificando arquivos de entrada

Modificar os valores nos arquivos de entrada ou os valores recuperados dos arquivos de entrada possibilita alterar o destino da implantação, as definições de configuração e as opções de implantação sem editar todo < o arquivo name.asdatabase >do projeto (ou um arquivo de script inteiro se você gerar um script de um banco de dados SQL Server Analysis Services existente). A possibilidade de modificar arquivos individuais permite que você crie com facilidade scripts de implantação para diferentes finalidades.

Arquivos de script de implantação – Especificando o destino de instalação

O Assistente de Implantação lê as informações de destino de instalação do arquivo nome> do < projeto.deploymenttargets. SQL Server Data Tools cria esse arquivo quando você compila o projeto. SQL Server Data Tools usa o banco de dados e o servidor especificados na página Implantação da caixa de diálogo Páginas de Propriedadesdo nome>do< projeto para criar o arquivo name.targets> do < projeto.

Modificando o destino de instalação

Em algumas situações, talvez seja necessário implantar um projeto em um banco de dados ou instância diferente daquele especificado na página Implantação . Por exemplo, você talvez queira implantar o projeto em um servidor para teste antes da implantação e, em seguida, implantá-lo em um servidor de produção após a conclusão do teste. Também é possível implantar um projeto concluído e testado em vários servidores de produção em um cluster de Balanceamento de Carga de Rede ou em um servidor de preparação e em um de produção.

Para implantar um projeto em um banco de dados ou instância diferente, altere o destino de instalação no arquivo de entrada usando um dos métodos descritos no seguinte procedimento:

Para alterar o destino de instalação depois que os arquivos de entrada tiverem sido gerados

Execute o Assistente de Implantação do SQL Server Analysis Services interativamente. Na página Destino de Instalação, especifique um novo destino para a instância de SQL Server Analysis Services e o banco de dados.

-ou-
Execute o Assistente de Implantação do SQL Server Analysis Services no prompt de comando e defina o assistente para ser executado no modo de arquivo de resposta.

-ou-
Modifique o arquivo nome> do < projeto.deploymenttargets usando qualquer editor de texto.

Arquivos de script de implantação – Opções de implantação de função e partição

O Assistente de Implantação lê as opções de implantação de partição e função do arquivo nome> do < projeto.deploymentoptions. SQL Server Data Tools cria esse arquivo quando você compila o projeto. SQL Server Data Tools usa as opções de implantação de partição e função do projeto atual quando o < arquivo name.deploymentoptions >do projeto é criado.

Revisão das opções de implantação de partição e função

As opções de implantação no arquivo nome> do < projeto.deploymentoptions incluem o seguinte:

Opções de implantação de partição
O < arquivo nome> do projeto.deploymentoptions especifica se as partições existentes no banco de dados de destino são retidas ou substituídas (padrão). Se as partições existentes forem retidas, só serão implantadas partições novas e os projetos de partições e agregação em todos os grupos de medidas existentes ficarão inalterados.

Se o grupo de medidas no qual a partição existe for excluído, a partição será excluída automaticamente.

Opções de implantação de função
O < arquivo nome> do projeto.deploymentoptions especifica uma das seguintes opções de implantação de função:

As funções e os membros de função existentes no banco de dados de destino são retidos e apenas novas funções e membros de função são implantados.
Todas as funções e os membros de função existentes no banco de dados de destino são substituídos pelas funções e pelos membros sendo implantados.
As funções e os membros de função existentes no banco de dados de destino são retidos e nenhuma nova função será implantada.

Quando funções e membros existentes são mantidos, as permissões associadas a essas funções são redefinidas para nenhuma. As permissões de segurança são contidas pelos objetos que protegem, não pelas funções de segurança com que estão associadas. Para obter mais informações sobre como trabalhar com esse comportamento usando o Assistente de Implantação do Analysis Service, consulte 'Reter funções e membros' na Base de Dados de Conhecimento Microsoft.

Modificando opções de implantação de partição e função

Talvez seja necessário implantar o projeto usando opções de partição e função diferentes daquelas armazenadas no arquivo nome> do < projeto.deploymentoptions. Por exemplo, convém manter partições, funções e membros de função existentes, em vez de substituir todas as partições, funções e membros existentes, conforme indicado no arquivo nome> do < projeto.deploymentoptions.

Para modificar a implantação de partições e funções em um projeto, você não pode alterar as configurações de partição e funções dentro do projeto porque a caixa de diálogo Páginas de Propriedadesdo nome>do< projeto no SQL Server Data Tools não exibe essas opções. Se você quiser alterar as opções de implantação para funções e partições, altere essas informações no próprio arquivo nome> do < projeto.deploymentoptions. O procedimento a seguir descreve como alterar as opções de implantação de partição e função no arquivo name.deploymentoptions >do <projeto.

Para alterar a implantação de partições ou de funções depois que os arquivos de entrada tiverem sido gerados

Execute o Assistente de Implantação interativamente e, na página Opções de Implantação de Partição e Função , especifique novas opções de implantação para as partições e funções.

-ou-
Execute o Assistente de Implantação no prompt de comando e defina o assistente para ser executado no modo de arquivo de resposta.

-ou-
Abra o nome> do < projeto.deploymentoptions em qualquer editor de texto e altere manualmente as opções. As opções para PartitionDeployment são DeployPartitions, RetainPartitions. As opções para RoleDeployment são DeployRolesAndMembers, DeployRolesRetainMembers, RetainRoles.

Arquivos de script de implantação – Configurações de implantação da solução

O Assistente de Implantação lê as opções de implantação de partição e função que você usa no script de implantação do arquivo nome> do < projeto.configsettings. Para projetos multidimensionais, SQL Server Data Tools cria esse arquivo quando você compila o projeto. Para projetos tabulares, dependendo da versão, pode ser necessário executar o Assistente de Implantação no modo de Resposta para gerar o arquivo .configsettings. SQL Server Data Tools usa as definições de configuração do projeto atual para criar o arquivo name.configsettings >do <projeto.

Revisão das definições de configuração

Veja a seguir as definições de configuração armazenadas no arquivo nome> do < projeto.configsettings:

Cadeias de conexão da fonte de dados – essas são as cadeias de conexão para cada fonte de dados com base nos valores especificados no projeto. A ID de usuário e senha são sempre removidas da cadeia de caracteres de conexão antes da cadeia restante ser armazenada nesse arquivo. Porém, se o Assistente para Implantação estiver fazendo a implantação diretamente em uma instância do Analysis Services, você poderá adicionar as informações adequadas de ID de usuário e senha ao assistente para habilitar um processamento bem-sucedido do banco de dados de desenvolvimento. Essas informações de conexão não serão armazenadas no próprio script de implantação se alguma for salva pelo Assistente para Implantação.
Contas de Representação – essa configuração especifica o nome de usuário que SQL Server Analysis Services usa para executar instruções em cada fonte de dados. Se nenhuma conta de representação for especificada, SQL Server Analysis Services usará sua conta de logon para executar instruções. Se a conta de logon receber permissões diretamente na fonte de dados, todos os administradores de banco de dados em todos os bancos de dados na instância SQL Server Analysis Services terão acesso à fonte de dados por meio da conta de logon. Se uma conta e senha do usuário forem especificadas, essas informações sempre serão removidas antes de as informações de representação serem armazenadas nesse arquivo. Porém, se o Assistente para Implantação estiver fazendo a implantação diretamente em uma instância do Analysis Services, você poderá adicionar as informações adequadas de ID de usuário e senha ao assistente para habilitar um processamento bem-sucedido do banco de dados de desenvolvimento. Essas informações de representação não serão armazenadas no próprio script de implantação se alguma for salva pelo Assistente para Implantação.

Observação

Para modelos tabulares no nível de compatibilidade 1400 e superior com conexões de fonte de dados do provedor estruturado, ao selecionar Reter definições de configuração para objetos existentes na página Especificar Propriedades de Configuração do Assistente, o nome de usuário e a senha armazenados no banco de dados de modelo tabular do servidor de destino não são mantidos. Os administradores devem definir o nome de usuário e a senha manualmente usando o SSMS após a conclusão da implantação.
Arquivos de log de erros de chave – essa configuração especifica o nome do arquivo e o caminho do arquivo de log de erros de chave para cada cubo, grupo de medidas, partição e dimensão no banco de dados.
Locais de Armazenamento – essa configuração especifica o local de armazenamento para cada cubo, grupo de medidas e partição no banco de dados. Se nenhum valor for fornecido para um objeto , o Assistente de Implantação usará o local padrão para o objeto . Por exemplo, as partições usam o local para o grupo de medidas, os grupos de medidas usam o local do cubo e os cubos usam o local padrão para objetos na instância do servidor. O local de armazenamento pode ser um local ou um caminho UNC (Convenção Universal de Nomenclatura).
Servidor de Relatório – essa configuração especifica o local do servidor de relatório e da pasta para cada ação de relatório definida em cada cubo no banco de dados.

Modificando definições de configuração

Em alguns casos, talvez seja necessário implantar o projeto usando definições de configuração diferentes daquelas armazenadas no arquivo name.configsettings >do <projeto. Por exemplo, convém alterar a cadeia de caracteres para uma ou mais fontes de dados ou especificar locais de armazenamento para partições ou grupos de medidas específicos.

Para modificar a implantação de partições e funções em um projeto, você deve alterar essas informações no arquivo nome> do < projeto.configsettings, conforme descrito no procedimento abaixo. Não é possível alterar as configurações de partição e funções dentro do projeto porque a caixa de diálogo Páginas de Propriedadesdo nome>do< projeto no SQL Server Data Tools não exibe essas opções.

Observação

Os parâmetros de configuração podem se aplicar a todos os objetos ou só aos objetos recentemente criados. Aplique definições de configuração a objetos recém-criados somente quando você estiver implantando objetos adicionais em um banco de dados SQL Server Analysis Services implantado anteriormente e não quiser substituir objetos existentes. Para especificar se as definições de configuração se aplicam a todos os objetos ou somente aos recém-criados, defina essa opção no arquivo nome> do < projeto.deploymentoptions.

Para alterar os parâmetros de configuração depois que os arquivos de entrada tiverem sido gerados

Execute o Assistente de Implantação interativamente e, na página Definições de Configuração, especifique a configuração para os objetos que estão sendo implantados.

-ou-
Execute o Assistente de Implantação no prompt de comando e defina o assistente para ser executado no modo de arquivo de resposta.

-ou-
Modifique o < arquivo name.configsettings >do projeto usando qualquer editor de texto.

Arquivos de script de implantação – opções de processamento

O Assistente de Implantação lê as opções de processamento do arquivo nome> do < projeto.deploymentoptions. SQL Server Data Tools cria esse arquivo quando você compila o projeto. SQL Server Data Tools usa as opções de processamento especificadas na página Implantação da caixa de diálogo Páginas de Propriedades do nome>do< projeto para criar o arquivo nome> do < projeto.deploymentoptions.

Revisão das opções de processamento

As definições de configuração armazenadas no arquivo nome> do < projeto.deploymentoptions são:

Método de processamento – essa configuração controla se os objetos implantados são processados após a implantação e o tipo de processamento que será executado. Há três opções de processamento:
- O processamento padrão (padrão) detecta o estado do processo dos objetos de banco de dados e executa o processamento necessário para entregar objetos não processados ou parcialmente processados a um estado totalmente processado.
- O processamento completo processa um objeto e todos os objetos que ele contém. Quando o comando Processar Completo é executado em um objeto que já foi processado, o Analysis Services descarta todos os dados do objeto e, em seguida, processa o objeto.
- Nenhum significa que nenhum processamento é executado.
Opções de tabela de write-back – se o write-back estiver habilitado no projeto, essa configuração definirá como o write-back é tratado. Há três opções de tabela de write-back:
- Por padrão, a tabela de write-back existente será usada, se existir. Se uma tabela de write-back não existir, uma nova tabela será criada.
- Se uma tabela de write-back já existir, a implantação falhará. Se uma tabela de write-back não existir, uma nova tabela será criada.
- Independentemente da existência de uma tabela de write-back, uma nova tabela será criada. Nesse caso, o Assistente de Implantação excluirá qualquer tabela existente e a substituirá por uma nova tabela de write-back.
Implantação transacional – essa configuração controla se a implantação de alterações de metadados e comandos de processo ocorrem em uma única transação ou em transações separadas.
- Se essa opção for True (padrão), SQL Server Analysis Services implantará todas as alterações de metadados e todos os comandos de processo em uma única transação.
- Se essa opção for False, SQL Server Analysis Services implantará as alterações de metadados em uma única transação e implantará cada comando de processamento em sua própria transação.

Modificando opções de processamento

No entanto, talvez seja necessário implantar o projeto usando opções de processamento diferentes daquelas armazenadas no arquivo name.deploymentoptions >do <projeto. Por exemplo, você pode processar por completo todos os objetos, processar usando a opção padrão ou não processá-los. Se os cubos ou dimensões forem habilitados para gravação, é possível especificar se uma tabela de write-back nova ou existente será usada.

Para modificar as opções de processamento usadas durante a implantação, edite e recrie o projeto ou altere as opções de processamento do arquivo de entrada usando um dos métodos conforme descrito no procedimento a seguir.

Para alterar as opções de processamento depois que os arquivos de entrada tiverem sido gerados

Execute o Assistente de Implantação interativamente. Na página Opções de Processamento , especifique as opções de processamento para o projeto que está sendo implantado.

-ou-
Execute o Assistente de Implantação no prompt de comando e defina o assistente para ser executado no modo de arquivo de resposta.

-ou-
Modifique o < arquivo name.deploymentoptions >do projeto usando qualquer editor de texto.

Confira também

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