Conjuntos de dados de relatório (SSRS)

Artigo
09/25/2024

Para adicionar dados a um relatório, você cria conjuntos de dados. Cada conjunto de dados representa o conjunto de resultados gerado pela execução de um comando de consulta em uma fonte dados. As colunas do conjunto de resultados são a coleção de campos. As linhas do conjunto de resultados são os dados. O conjunto de resultados não contêm os dados reais. Um conjunto de dados contém as informações necessárias para recuperar um conjunto específico de dados de uma fonte de dados.

Há dois tipos de conjuntos de dados: inserido ou compartilhado. Um conjunto de dados inserido é definido em um relatório e usado apenas por esse relatório. Um conjunto de dados compartilhado é definido no servidor de relatório ou em um site do SharePoint e pode ser usado por vários relatórios. No Construtor de Relatórios, você pode criar conjuntos de dados compartilhados no modo Conjunto de Dados Compartilhado ou conjuntos de dados inseridos no modo Designer de Relatórios. No Designer de Relatórios do SQL Server Data Tools (SSDT), você pode criar conjuntos de dados compartilhados como parte de um projeto ou conjuntos de dados inseridos como parte de um relatório.

Conjuntos de dados inseridos. Diferente de aplicativos como o Microsoft Office Excel, em que você trabalha diretamente com dados em uma planilha, no Construtor de Relatórios ou no Designer de Relatórios, você trabalha com metadados que representam os dados a serem recuperados quando o relatório for processado. Para criar um conjunto de dados inserido, selecione a fonte de dados e especifique uma consulta. Depois que você criar um conjunto de dados, use o painel Dados do Relatório para exibir a coleção de campos. Você pode exibir dados de um conjunto de dados em uma região de dados, como uma tabela ou gráfico. Em cada região de dados, é possível agrupar, filtrar e classificar os dados para organizá-los. Depois de criar o layout de relatório, execute o relatório para ver os dados reais.

Na figura a seguir, o painel Dados do Relatório exibe uma fonte de dados denominada AdventureWorks2022, um conjunto de dados denominado DataSet1 e cinco campos da coleção de campos do conjunto de dados. O painel Layout mostra uma tabela com a linha superior de títulos de coluna e a linha inferior com células de tabela que contêm texto. O texto do espaço reservado [Nome] contém metadados para o nome do campo. Quando o relatório é executado, o texto do espaço reservado é substituído pelos valores de dados reais. A tabela é expandida conforme necessário para exibir todos os dados.
Conjuntos de dados compartilhados. Crie um conjunto de dados compartilhado quando desejar usar um conjunto de dados em mais de um relatório. Para criar e salvar um conjunto de dados em um servidor de relatório ou em um site do SharePoint, use o Construtor de Relatórios na exibição de design do conjunto de dados compartilhado. Para criar um conjunto de dados compartilhado como parte de um projeto que pode ser implantado em um servidor ou site, use o Designer de Relatórios.

A ilustração a seguir mostra a exibição de Design do Conjunto de Dados Compartilhado no Construtor de Relatórios. Você pode selecionar ou modificar a conexão de dados, as propriedades de conjunto de dados, a consulta e os filtros e, se desejar, você pode marcar os filtros como parâmetros e exibir os resultados da consulta. Em seguida, salve as alterações no servidor ou no site.

Para obter mais informações, confira Conjuntos de dados inseridos e compartilhados (Construtor de Relatórios e SSRS) e Conexões de dados ou fontes de dados inseridas e compartilhadas (Construtor de Relatórios e SSRS).

Você também pode adicionar conjuntos de dados a um relatório adicionando partes de relatório que incluem os conjuntos de dados dos quais elas dependem. Partes de relatório são itens de relatório autossuficientes que são armazenados no servidor de relatório e podem ser incluídos em outros relatórios. No entanto, as partes do relatório foram preteridas para todas as versões do Microsoft SQL Server Reporting Services após o Microsoft SQL Server Reporting Services 2019 e descontinuadas a partir do Microsoft SQL Server Reporting Services 2022 e do Servidor de Relatórios do Power BI.

Para saber como criar um relatório que exibe dados de um banco de dados do SQL Server, confira Tutorial: Criando um relatório de tabela básico (Construtor de Relatórios). Para criar um relatório que inclui os próprios dados, confira Tutorial: Criar um gráfico de relatório rápido offline (Construtor de Relatórios).

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.

Adicionando dados de relatório

No Construtor de Relatórios, você pode adicionar dados de relatório das seguintes maneiras.

Adicione partes de relatório de um servidor de relatório ao seu relatório. Cada parte de relatório é autossuficiente e inclui conjuntos de dados dependentes. Os conjuntos de dados são predefinidos.
Use os assistentes de Tabela/Matriz, Gráfico e Mapa. Com os assistentes, é possível selecionar fontes de dados compartilhadas e conjuntos de dados compartilhados, ou criar novos conjuntos de dados, e continuar criando o relatório.
Adicione conjuntos de dados compartilhados de um servidor de relatório. Os conjuntos de dados compartilhados são predefinidos e especificam quais dados devem ser usados de uma fonte de dados predefinida. Ao adicionar um conjunto de dados compartilhado ao relatório, você adiciona uma referência de conjunto de dados que aponta para a definição do conjunto de dados compartilhado.

No Construtor de Relatórios ou Designer de Relatórios, você pode adicionar dados das seguintes maneiras.

Adicione conjuntos de dados inseridos com base nas fontes de dados compartilhadas.
Adicione conjuntos de dados inseridos com base nas fontes de dados inseridas.

Observação

Em um servidor de relatório, os itens compartilhados são protegidos individualmente ou herdando permissões da pasta onde eles são publicados. Para permitir que outros usuários acessem os conjuntos de dados compartilhados que você salva, é necessário entender como as permissões são concedidas. Para obter mais informações, confira Segurança (Construtor de Relatórios) ou Proteger itens de conjuntos de dados compartilhados.

Depois de adicionar dados a um relatório, você pode organizar os dados na página de relatório com regiões de dados, modificar partes de relatório e compartilhar essas alterações com outros, além de permitir que os usuários limitem ou classifiquem os dados no relatório. Para obter mais informações, consulte os seguintes tópicos relacionados:

Adicionando dados com partes de relatório

As partes de relatório contêm os conjuntos de dados dos quais elas dependem. Esses conjuntos de dados são criados em fontes de dados compartilhadas que estão disponíveis no servidor de relatório. No Construtor de Relatórios, quando você adiciona uma parte de relatório ao relatório, os conjuntos de dados dependentes são adicionados ao relatório, como se você os tivesse adicionado manualmente. Por exemplo, um gráfico predefinido contém um conjunto de dados. Para ver os dados, visualize o relatório.

Observação

Partes de relatório são itens de relatório autossuficientes que são armazenados no servidor de relatório e podem ser incluídos em outros relatórios. No entanto, as partes do relatório foram preteridas para todas as versões do Microsoft SQL Server Reporting Services após o Microsoft SQL Server Reporting Services 2019 e descontinuadas a partir do Microsoft SQL Server Reporting Services 2022 e do Servidor de Relatórios do Power BI.

Partes de relatório, fontes de dados compartilhadas e conjuntos de dados compartilhados são definidos antecipadamente e salvos em um servidor de relatório. Para acessá-los, você precisa abrir o Construtor de Relatórios no modo de servidor conectando-se ao servidor de relatório. Você pode usá-los para criar suas próprias versões se tiver permissões de gravação no servidor de relatório.

Para obter mais informações, confira Partes de relatório (Construtor de Relatórios e SSRS) e Partes de relatório no Designer de Relatórios (SSRS).

Consultas e designers de consulta

Para especificar quais dados deseja em uma fonte de dados, crie um comando de consulta. Cada tipo de fonte de dados fornece um designer de consulta relacionado para ajudar você a criar a consulta. O designer de consulta pode ser gráfico ou baseado em texto. Em um designer de consulta gráfica, você exibe metadados que representam os dados na fonte de dados externa e criam interativamente uma consulta arrastando campos ou entidades para a superfície de design de consulta. Em um designer de consulta baseado em texto, você escreve ou importa consultas na sintaxe de consulta que tem suporte da fonte de dados externa.

No designer de consulta, você pode executar a consulta para exibir dados de exemplo e validar a sintaxe do comando de consulta. Os nomes de coluna no conjunto de resultados tornam-se os nomes de campo que você vê no painel Dados do Relatório. O conjunto de resultados deve ser um único conjunto de linhas e colunas em que o mesmo número de valores existe para cada linha de dados. Não há suporte para vários conjuntos de resultados a partir de uma única consulta. Não há suporte para hierarquias imperfeitas, que não têm um número constante de colunas e podem gerar um número diferente de valores de dados para cada linha.

Para executar uma consulta, é necessário ter credenciais de tempo de design. Para saber mais, confira Especificar informações de credencial e conexão para fontes de dados de relatório e Criar cadeias de conexão de dados – Construtor de Relatórios e SRS.

A comunicação entre uma extensão de dados e a fonte de dados externa é gerenciada pelos provedores de dados. O suporte para sintaxe do comando de consulta, parâmetros de consulta e tipos de dados para obter valores no conjunto de resultados é determinado por cada provedor de dados. Para saber mais, confira o tópico para o tipo específico de extensão de dados e Ferramentas de Designers de Consulta (SSRS).