Implantar um modelo tabular do Visual Studio

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

A implantação de um projeto de modelo tabular do Visual Studio é um processo simples, no entanto, determinadas etapas devem ser executadas para garantir que o modelo seja implantado na instância de servidor correta ou no workspace do Power BI e com as opções de configuração corretas.

Os modelos de tabela são definidos com várias propriedades específicas da implantação. Quando você faz a implantação, é estabelecida uma conexão com a instância especificada na propriedade Servidor. Um novo modelo com o nome especificado na propriedade Database será criado nessa instância, se ainda não existir um. Os metadados do arquivo Model.bim do projeto de modelo são usados para configurar objetos no banco de dados modelo no servidor de implantação. Com a Opção de Processamento, você pode especificar se apenas os metadados modelo são implantados, criando o banco de dados modelo, ou, se Padrão ou Completa estiver especificado, as credenciais de representação usadas para conectar-se a fontes de dados de memória serão transmitidas na memória do banco de dados de workspace modelo para o modelo de banco de dados implantado. O Analysis Services executa o processamento para popular dados no modelo implantado. Depois que a implantação e o processamento forem concluídos, o modelo poderá ser conectado por aplicativos de relatório de cliente, como o Power BI e o Excel.

Implantar um projeto de modelo tabular do Visual Studio em um workspace Power BI Premium tem algumas etapas adicionais para concluir o processamento na primeira implantação. Para saber mais, confira Implantar projetos de modelo do Visual Studio no Power BI.

Propriedades de implantação

As opções de implantação de projeto e as propriedades do servidor de implantação especificam como e onde um modelo é implantado em um ambiente de preparo ou produção do Analysis Services. Apesar de as configurações de propriedades padrão serem definidas para todos os projetos modelo, de acordo com os seus requisitos de implantação específicos, você pode alterar essas configurações de propriedades para cada projeto.

Opções de implantação

Propriedade Configuração padrão Descrição
Opção de processamento Default Especifica o tipo de processamento necessário quando as alterações nos objetos são implantadas. Essa propriedade oferece as seguintes opções:

Padrão – essa configuração especifica que o Analysis Services determinará o tipo de processamento necessário. Os objetos não processados serão processados e, se preciso for, recalculando relações de atributos, hierarquias de atributo, hierarquias de usuário e colunas calculadas. Estas configurações geralmente resultam em um tempo de implantação mais rápido do que usar a opção de processamento completo.

Não Processar – essa configuração especifica que apenas os metadados serão implantados. Depois de implantar, pode ser necessário executar uma operação de processo no modelo implantado para atualizar e recalcular dados.

Completo – essa configuração especifica que os metadados são implantados e uma operação completa do processo é executada. Isto garante que o modelo implantado tem as atualizações mais recentes a metadados e dados.
Implantação Transacional Falso Especifica se a implantação é transacional ou não. Por padrão, a implantação de todos os objetos ou dos objetos alterados não é transacional com o processamento desses objetos implantados. A implantação pode ser bem-sucedida e persistir mesmo em caso de falha do processamento. É possível alterar esse padrão para incorporar a implantação e o processamento em uma única transação.
ADAL Cache Default Especifica o uso da propriedade cadeia de conexão USEADALCache ao se conectar a Azure Analysis Services.

Servidor de Implantação

Propriedade Configuração padrão Descrição
Servidor localhost Especifica a URL do recurso do servidor Azure Analysis Services, a URL de Conexão do Workspace do Power BI ou SQL Server Analysis Services nome da instância na qual o modelo será implantado.
Edição A mesma edição da instância na qual o banco de dados do Workspace está localizado. Essa propriedade especifica a edição do servidor do Analysis Services no qual o modelo será implantado. A edição do servidor define vários recursos que podem ser incorporados no projeto. Por padrão, a edição será do servidor local do Analysis Services, que se você estiver usando um workspace integrado será a edição do Visual Studio.
Backup de banco de dados <Projectname> Essa propriedade especifica o nome do banco de dados do Analysis Services no qual os objetos modelo serão instanciados na implantação. Esse nome também será especificado em uma conexão de dados de cliente de relatório ou em um arquivo de conexão de dados .bism.

Você poderá alterar este nome a qualquer momento quando estiver criando o modelo. Se você alterar o nome depois de implantar o modelo, as alterações feitas depois da implantação não afetarão o modelo implantado previamente. Por exemplo, se você abrir uma solução nomeada TestDB e implantar sua solução com o nome padrão de banco de dados modelo chamado Model, e depois modificar a solução e renomear o banco de dados modelo, Sales, a instância do Analysis Services em que as soluções foram implantadas exibirá bancos de dados separados, um denominado Model e o outro denominado Sales.
Nome do Modelo Modelo Essa propriedade especifica o nome do modelo, conforme mostrado em aplicativos e ferramentas cliente.

Implantar um modelo tabular

  • Em Gerenciador de Soluções, clique com o botão direito do mouse no nome do projeto e clique em Implantar.

    A caixa de diálogo Implantação aparecerá e indicará o status da implantação de metadados e o processamento (a menos que a propriedade Opção de Processamento esteja configurada como Não Processar) de cada tabela incluída no modelo.

Status de Implantação

A caixa de diálogo Implantar o habilita a monitorar o progresso de uma operação de Implantação. Uma operação de implantação também pode ser interrompida.

Status
Indica se a operação de implantação foi bem-sucedida ou não.

Detalhes
Lista os itens de metadados que foram implantados, o status de cada item de metadados, e fornece uma mensagem de quaisquer problemas.

Parar a implantação
Clique para interromper a operação de implantação. Essa opção será útil se a operação de implantação estiver demorando muito ou se houver muitos erros.

Implantando em um workspace Power BI Premium

Quando implantado pela primeira vez, um modelo semântico é criado no workspace usando metadados do model.bim. Como parte da operação de implantação, depois que o modelo tiver sido criado no workspace a partir de metadados de modelo, o processamento para carregar dados no modelo de fontes de dados falhará.

O processamento falha porque, ao contrário da implantação em uma instância do Azure ou SQL Server Analysis Services, em que as credenciais da fonte de dados são solicitadas como parte da operação de implantação, ao implantar em um espaço de trabalho Premium, não é possível especificar as credenciais da fonte de dados como parte da operação de implantação. Em vez disso, depois que a implantação de metadados tiver sido bem-sucedida e o modelo tiver sido criado, as credenciais da fonte de dados serão especificadas no Serviço do Power BI nas configurações de modelo semântico. No workspace, clique em Modelos semânticos>Configurações>Credenciais da fonte> de dadosEditar credenciais.

Importante

Durante a versão prévia pública, as associações de função não podem ser especificadas no projeto de modelo. Se não for possível implantar o projeto de modelo, verifique se não há nenhum usuário especificado em alguma função. Depois que o modelo tiver sido implantado com êxito, especifique os usuários para funções de modelo no serviço do Power BI.

Observação

Para modelos DirectQuery, se o modelo contiver itens calculados, colunas calculadas ou tabelas calculadas, depois de ser implantado, você deverá executar um Recalc de Processo no banco de dados. Para saber mais sobre como processar um banco de dados modelo do SSMS, consulte Processar banco de dados, tabela ou partição.

Após a conclusão do processo de implantação, use o SSMS para se conectar ao servidor ou workspace e verificar se o novo objeto de banco de dados modelo foi criado.

Confira também

Implantação de solução de modelo tabular
Configurar propriedades de implantação e modelagem de dados padrão
Processar Banco de Dados, Tabela ou Partição