Compartilhar via


Referências de DataSources e DataSets em um relatório paginado (Construtor de Relatórios)

Aplica-se a: Microsoft Report Builder (SSRS) Power BI Report Builder Report Designer no SQL Server Data Tools

A coleção DataSources representa todas as fontes de dados usadas em um relatório paginado. De maneira semelhante, a coleção DataSets representa todos os conjuntos de dados para todas as fontes de dados em um relatório. Use o painel Dados do Relatório para obter uma exibição hierárquica dos conjuntos de dados do relatório organizados sob a fonte de dados a qual eles fazem referência. Se você incluir referências nessas coleções, não poderá ver os valores ao visualizar o relatório. Essas coleções estão disponíveis apenas após o relatório ter sido publicado em um servidor de relatório.

Observação

Você pode criar e modificar arquivos de definição de relatório paginado (.rdl) no Construtor de Relatórios da Microsoft, Construtor de Relatórios do Power BI e no Designer de Relatórios no SQL Server Data Tools.

DataSources

A coleção DataSources representa as fontes de dados referenciadas em uma definição de relatório publicada. É possível optar por incluir essas informações no relatório para documentar a origem dos dados do relatório. Essa coleção não está disponível no modo Visualização. A tabela a seguir descreve as variáveis dentro da coleção DataSources .

Variável Tipo Descrição
DataSourceReference Cadeia de caracteres O caminho completo da definição da fonte de dados no servidor de relatório. Por exemplo, você pode incluir uma lista de todas as fontes de dados que um relatório usou como parte de um histórico de relatório. O exemplo a seguir mostra o caminho completo da fonte de dados denominada AdventureWorks2022:

/DataSources/AdventureWorks2022.
Tipo Cadeia de caracteres O tipo de provedor de dados para a fonte de dados. Por exemplo, SQL.

DataSets

A coleção DataSets representa os conjuntos de dados referenciados em uma definição de relatório. É possível optar por incluir a consulta no relatório em uma caixa de texto, de modo que um usuário interessado exatamente nos dados que estão no relatório possa ver o texto do comando original. Essa coleção não está disponível no modo Visualização. A tabela a seguir descreve os membros da coleção DataSets .

Membro Tipo Descrição
CommandText Cadeia de caracteres Para fontes de dados do banco de dados, esta consulta é a consulta usada para recuperar dados da fonte de dados. Se a consulta for uma expressão, essa expressão será a expressão avaliada.
RewrittenCommandText Cadeia de caracteres O valor de CommandText expandido do provedor de dados. Geralmente esse valor é usado para relatórios com parâmetros de consulta mapeados para parâmetros de relatório. O provedor de dados define essa propriedade ao expandir as referências do parâmetro do texto do comando nos valores constantes selecionados para os parâmetros de relatório mapeados.

Usar Expressões de Consulta

É possível usar expressões para definir a consulta contida em um conjunto de dados. É possível usar esse recurso para projetar relatórios em que a consulta é alterada com base na entrada do usuário, dos dados em outros conjuntos de dados ou outras variáveis. Para obter mais informações sobre consultas, confira Conjuntos de dados inseridos e compartilhados de relatório (Construtor de Relatórios).