Alterar cadeias de conexão de fonte de dados em relatórios do Power BI com o PowerShell - Servidor de Relatório do Power BI

Habilitamos a capacidade de atualizar conexões para relatórios do Power BI para DirectQuery e atualizar.

Importante

Esta também é uma mudança significativa em como você poderia configurar isso em versões anteriores. Se você estiver usando uma versão anterior a outubro de 2020 do Servidor de Relatório do Power BI, consulte Alterar cadeias de conexão de fonte de dados em relatórios do Power BI com o PowerShell - Servidor de Relatório do Power BI anterior a outubro de 2020

Pré-requisitos

• Baixe a versão mais recente do Servidor de Relatório do Power BI e do Power BI Desktop para Servidor de Relatório do Power BI.
• Um relatório salvo com a versão de outubro de 2020 ou posterior do Power BI Desktop otimizado para o Servidor de Relatório, com Metadados de Conjunto de Dados Aprimorados habilitados.
• Um relatório que usa conexões parametrizadas. Somente relatórios com conexões parametrizadas e bancos de dados podem ser atualizados após a publicação.
• Este exemplo usa as ferramentas do PowerShell do Reporting Services. Você pode conseguir o mesmo usando as novas APIs REST.

Criar um relatório com conexões parametrizadas

1. Crie uma conexão do SQL Server com um servidor. No exemplo abaixo, estamos nos conectando ao localhost a um banco de dados chamado ReportServer e extraindo dados do ExecutionLog.

   

   Veja a aparência da consulta M neste momento:

   let
       Source = Sql.Database("localhost", "ReportServer"),
       dbo_ExecutionLog3 = Source{[Schema="dbo",Item="ExecutionLog3"]}[Data]
   in
       dbo_ExecutionLog3
   

2. Selecione Gerir Parâmetros no friso do Power Query Editor.

   

3. Crie parâmetros para servername e databasename.

   

4. Edite a consulta para a primeira conexão e mapeie o banco de dados e o nome do servidor.

   

   Agora, a consulta tem esta aparência:

   let
       Source = Sql.Database(ServerName, Databasename),
       dbo_ExecutionLog3 = Source{[Schema="dbo",Item="ExecutionLog3"]}[Data]
   in
       dbo_ExecutionLog3
   

   4. Publique esse relatório no servidor. Neste exemplo, o relatório é chamado executionlogparameter. A imagem a seguir é um exemplo de uma página de gerenciamento de fonte de dados.

   

Atualizar parâmetros usando as ferramentas do PowerShell

1. Abra o PowerShell e instale as ferramentas mais recentes do Reporting Services, seguindo as instruções em https://github.com/microsoft/ReportingServicesTools.

2. Para obter o parâmetro para o relatório, use a nova API REST DataModelParameters usando a seguinte chamada do PowerShell:

   Get-RsRestItemDataModelParameters '/executionlogparameter'
   
       Name         Value
       ----         -----
       ServerName   localhost
       Databasename ReportServer
   

3. Guardamos o resultado desta chamada numa variável:

   $parameters = Get-RsRestItemDataModelParameters '/executionlogparameter'
   

4. Mapeie para um dicionário para acessar os valores dos parâmetros.

   $parameterdictionary = @{}
   foreach ($parameter in $parameters) { $parameterdictionary.Add($parameter.Name, $parameter); }
   
   

5. Esta variável é atualizada com os valores que precisamos alterar.

6. Atualize os valores dos parâmetros desejados:

   $parameterdictionary[“ServerName”].Value = 'myproductionserver'
   $parameterdictionary[“Databasename”].Value = 'myproductiondatabase'
   

7. Com os valores atualizados, podemos usar o commandlet Set-RsRestItemDataModelParameters para atualizar os valores no servidor:

   Set-RsRestItemDataModelParameters -RsItem '/executionlogparameter' -DataModelParameters $parameters
   $parameterdictionary.Values
   

8. Depois que os parâmetros são atualizados, o servidor atualiza todas as fontes de dados que foram vinculadas aos parâmetros. Voltando à caixa de diálogo Editar fonte de dados, você poderá definir credenciais para o servidor e o banco de dados atualizados.

   

Conteúdos relacionados

• Fontes de dados de relatório paginadas no Servidor de Relatório do Power BI

Tem dúvidas? Tente perguntar à Comunidade do Power BI