Adicionar parâmetros em cascata a um relatório paginado do Power BI (Construtor de Relatórios do Power BI)
APLICA-SE A: 
Power BI Report Builder 
Power BI Desktop
Os parâmetros em cascata fornecem uma maneira de gerenciar grandes quantidades de dados em um relatório paginado do Power BI. Você pode definir um conjunto de parâmetros relacionados para que a lista de valores para um parâmetro dependa do valor escolhido em outro parâmetro. Por exemplo, o primeiro parâmetro é independente e pode apresentar uma lista de categorias de produtos. Quando o usuário seleciona uma categoria, o segundo parâmetro depende do valor do primeiro parâmetro. Seus valores são atualizados com uma lista de subcategorias dentro da categoria escolhida. Quando o usuário exibe o relatório, os valores dos parâmetros de categoria e subcategoria são usados para filtrar os dados do relatório.
Para criar parâmetros em cascata, defina primeiro a consulta do conjunto de dados e inclua um parâmetro de consulta para cada parâmetro em cascata necessário. Você também deve criar um conjunto de dados separado para cada parâmetro em cascata para fornecer valores disponíveis. Para obter mais informações, consulte Adicionar, alterar ou excluir valores disponíveis para um parâmetro de relatório (Construtor de Relatórios do Power BI).
A ordem é importante para parâmetros em cascata porque a consulta do conjunto de dados para um parâmetro mais adiante na lista inclui uma referência a cada parâmetro que está anteriormente na lista. Em tempo de execução, a ordem dos parâmetros no painel Dados do Relatório determina a ordem em que as consultas de parâmetros aparecem no relatório e, portanto, a ordem na qual um usuário escolhe cada valor de parâmetro sucessivo.
Criar o conjunto de dados principal com uma consulta com vários parâmetros relacionados
No painel Dados do Relatório, clique com o botão direito do mouse em uma fonte de dados e clique em Adicionar Conjunto de Dados.
Em Nome, digite o nome do conjunto de dados.
Em Fonte de dados, escolha o nome da fonte de dados ou clique em Novo para criar uma.
Em Tipo de consulta, escolha o tipo de consulta para a fonte de dados selecionada. Neste tópico, o tipo de consulta Text é assumido.
Em Consulta, digite a consulta a ser usada para recuperar dados para este relatório. A consulta deve incluir as seguintes partes:
Uma lista de campos de fonte de dados. Por exemplo, em uma instrução Transact-SQL, a instrução SELECT especifica uma lista de nomes de colunas de banco de dados de uma determinada tabela ou exibição.
Um parâmetro de consulta para cada parâmetro em cascata. Um parâmetro de consulta limita os dados recuperados da fonte de dados especificando determinados valores a serem incluídos ou excluídos da consulta. Normalmente, os parâmetros de consulta ocorrem em uma cláusula de restrição na consulta. Por exemplo, em uma instrução Transact-SQL SELECT, os parâmetros de consulta ocorrem na cláusula WHERE.
Clique em Executar (!). Depois de incluir parâmetros de consulta e, em seguida, executar a consulta, os parâmetros de relatório que correspondem aos parâmetros de consulta são criados automaticamente.
Nota
A ordem dos parâmetros de consulta na primeira vez que você executa uma consulta determina a ordem em que eles são criados no relatório. Para alterar a ordem, consulte Alterar a ordem de um parâmetro de relatório (Construtor de Relatórios do Power BI)
Selecione OK.
Em seguida, você criará um conjunto de dados que forneça os valores para o parâmetro independente.
Criar um conjunto de dados para fornecer valores para um parâmetro independente
No painel Dados do Relatório, clique com o botão direito do mouse em uma fonte de dados e clique em Adicionar Conjunto de Dados.
Em Nome, digite o nome do conjunto de dados.
Em Fonte de dados, verifique se o nome é o nome da fonte de dados escolhida na etapa 1.
Em Tipo de consulta, escolha o tipo de consulta para a fonte de dados selecionada. Neste tópico, o tipo de consulta Text é assumido.
Em Consulta, digite a consulta a ser usada para recuperar valores para esse parâmetro. As consultas para parâmetros independentes normalmente não contêm parâmetros de consulta. Por exemplo, para criar uma consulta para um parâmetro que fornece todos os valores de categoria, você pode usar uma instrução Transact-SQL semelhante à seguinte:
SELECT DISTINCT <column name> FROM <table>O comando SELECT DISTINCT remove valores duplicados do conjunto de resultados para que você obtenha cada valor exclusivo da coluna especificada na tabela especificada.
Clique em Executar (!). O conjunto de resultados mostra os valores disponíveis para este primeiro parâmetro.
Selecione OK.
Em seguida, você definirá as propriedades do primeiro parâmetro para usar esse conjunto de dados para preencher seus valores disponíveis em tempo de execução.
Definir valores disponíveis para um parâmetro de relatório
No painel Dados do Relatório, na pasta Parâmetros, clique com o botão direito do mouse no primeiro parâmetro e clique em Propriedades do Parâmetro.
Em Nome, verifique se o nome do parâmetro está correto.
Clique em Valores disponíveis.
Clique em Obter valores de uma consulta. Três campos aparecem.
Em Conjunto de dados, na lista suspensa, clique no nome do conjunto de dados criado no procedimento anterior.
No campo Valor , clique no nome do campo que fornece o valor do parâmetro.
No campo Rótulo , clique no nome do campo que fornece o rótulo do parâmetro.
Selecione OK.
Em seguida, você criará um conjunto de dados que forneça os valores para um parâmetro dependente.
Criar um conjunto de dados para fornecer valores para um parâmetro dependente
No painel Dados do Relatório, clique com o botão direito do mouse em uma fonte de dados e clique em Adicionar Conjunto de Dados.
Em Nome, digite o nome do conjunto de dados.
Em Fonte de dados, verifique se o nome é o nome da fonte de dados escolhida na etapa 1.
Em Tipo de consulta, escolha o tipo de consulta para a fonte de dados selecionada. Neste tópico, o tipo de consulta Text é assumido.
Em Consulta, digite a consulta a ser usada para recuperar valores para esse parâmetro. As consultas para parâmetros dependentes geralmente incluem parâmetros de consulta para cada parâmetro do qual esse parâmetro depende. Por exemplo, para criar uma consulta para um parâmetro que fornece todos os valores de subcategoria (parâmetro dependente) para uma categoria (parâmetro independente), você pode usar uma instrução Transact-SQL semelhante à seguinte:
SELECT DISTINCT Subcategory FROM <table> WHERE (Category = @Category)Na cláusula WHERE, Category é o nome de um campo da tabela> e @Category é um parâmetro de <consulta. Esta instrução produz uma lista de subcategorias para a categoria especificada em @Category. Em tempo de execução, esse valor será preenchido com o valor que o usuário escolher para o parâmetro de relatório que tem o mesmo nome.
Selecione OK.
Em seguida, você definirá as propriedades do segundo parâmetro para usar esse conjunto de dados para preencher seus valores disponíveis em tempo de execução.
Definir valores disponíveis para o segundo parâmetro
No painel Dados do Relatório, na pasta Parâmetros, clique com o botão direito do mouse no primeiro parâmetro e clique em Propriedades do Parâmetro.
Em Nome, verifique se o nome do parâmetro está correto.
Clique em Valores disponíveis.
Clique em Obter valores de uma consulta.
Em Conjunto de dados, na lista suspensa, clique no nome do conjunto de dados criado no procedimento anterior.
No campo Valor , clique no nome do campo que fornece o valor do parâmetro.
No campo Rótulo , clique no nome do campo que fornece o rótulo do parâmetro.
Selecione OK.
Testar os parâmetros em cascata
Clique em Executar.
Na lista suspensa do primeiro parâmetro independente, escolha um valor.
O processador de relatório executa a consulta do conjunto de dados para o próximo parâmetro e passa a ele o valor escolhido para o primeiro parâmetro. A lista suspensa para o segundo parâmetro é preenchida com os valores disponíveis com base no primeiro valor do parâmetro.
Na lista suspensa para o segundo parâmetro dependente, escolha um valor.
O relatório não é executado automaticamente depois que você escolhe o último parâmetro para que você possa alterar sua escolha.
Clique em Ver relatório. O relatório atualiza a exibição com base nos parâmetros escolhidos.
Conteúdos relacionados
- Adicionar, alterar ou excluir um parâmetro de relatório (Construtor de Relatórios do Power BI)
- Parâmetros de relatório (Construtor de Relatórios do Power BI e Designer de Relatórios)
- Tutorial: Adicionar um parâmetro ao relatório (Construtor de Relatórios do Power BI)
- Tutoriais do Construtor de Relatórios do Power BI
- Conjuntos de dados incorporados de relatório e conjuntos de dados compartilhados (Construtor de Relatórios do Power BI)