Criando e adicionando conjuntos de dados (Construtor de Relatórios 3.0 e SSRS)
Um conjunto de dados especifica os dados que você pode usar a partir de uma conexão de dados. Um conjunto de dados é baseado em uma conexão de dados que foi salva no relatório como uma fonte de dados inserida ou uma referência a uma fonte de dados compartilhada em um servidor de relatório. O conjunto de dados inclui uma consulta que especifica um conjunto de campos. Ao arrastar esses campos para a superfície de design, você cria expressões que avaliam os dados reais quando o relatório é executado.
Existem dois tipos de conjuntos de dados:
Conjunto de dados compartilhado. Um conjunto de dados compartilhado é definido no servidor de relatório. Você pode procurar no servidor para criar um conjunto de dados compartilhado ou selecionar um predefinido para adicionar ao seu relatório.
Conjunto de dados inserido. Um conjunto de dados inserido é definido e usado somente pelo relatório em que está inserido.
Um conjunto de dados também inclui parâmetros, filtros e opções de dados que especificam diferenciação de caracteres, como maiúsculas e minúsculas, tipo kana, largura, acentuação e informações de agrupamento.
.gif "Criando conjuntos de dados de fontes de dados externas")
Conjuntos de dados no painel Dados do Relatório Uma conjunto de dados é exibida no painel de Dados do Relatório depois que você cria um conjunto de dados inserido ou adiciona um conjunto de dados compartilhado. Um conjunto de dados se baseia em uma fonte de dados.
Designer de Consultas Quando você projeta uma consulta de conjunto de dados, o designer de consultas associado ao tipo de fonte de dados é aberto.
Comando Query O designer de consultas ajuda a criar um comando Query. A sintaxe do comando é determinada pelo provedor de dados.
Dados de Extensão/Provedor de Dados A conexão com os dados pode ser feita por meio de várias camadas de acesso a dados.
Fontes de dados internas Recupera dados de bancos de dados relacionais, bancos de dados multidimensionais, listas do SharePoint, serviços Web ou modelos de relatório.
Resultados da consulta Você pode executar a consulta e ver um exemplo do conjunto de resultados. Você deve ter credenciais de tempo de design para executar uma consulta.
Metadados do esquema O provedor de dados executa um comando de consulta de esquema separado da consulta para recuperar metadados para a coleção de campos do conjunto de dados. Por exemplo, uma instrução Transact-SQLSELECT retorna os nomes de colunas para uma tabela do banco de dados. Use o painel Dados do Relatório para expandir o conjunto de dados para exibir a coleção de campos do conjunto de dados.
Também é possível incluir dados em um relatório usando conjuntos de dados compartilhados e peças de relatórios. Esses itens já têm as informações de conexão de dados necessárias. Para obter mais informações, consulte Adicionando dados a um relatório (Report Builder 3.0 e SSRS) e Partes de relatório (Construtor de Relatórios 3.0).
Para obter mais informações sobre extensões de dados e tipos de fontes de dados internos, consulte Adicionando dados de fontes de dados externas (SSRS).
.gif "Observação") Observação |
|---|
É possível criar e modificar definições de relatórios (.rdl) no Report Builder 3.0 e no Designer de Relatórios no Business Intelligence Development Studio. Cada ambiente de criação fornece diferentes maneiras de criar, abrir e salvar relatórios e itens relacionados. Para obter mais informações, consulte Projetando e implementando relatórios usando o Designer de Relatórios (Reporting Services) na Web em microsoft.com. |
Neste artigo
Compreendendo os conjuntos de dados de relatório e consultas
Comparando e criando conjuntos de dados compartilhados e conjuntos de dados inseridos
Classificar, agrupar e filtrar dados em um conjunto de dados
Usando parâmetros e conjuntos de dados
Usando modelos de relatório
Usando conjuntos de dados e mapas
Exibindo dados de vários conjuntos de dados
Exibindo uma mensagem quando nenhuma linha de dados está disponível
Definindo opções do conjunto de dados
Compreendendo os conjuntos de dados de relatório e consultas
Um conjunto de dados de relatório contém um comando de consulta que é executado na fonte de dados externa e especifica quais dados serão recuperados. Para criar o comando de consulta, use o designer de consulta que está associado à extensão de dados para a fonte de dados externa. No designer de consulta, é possível executar o comando de consulta e exibir um conjunto de resultados. O conjunto de resultados é um conjunto retangular de linhas com nomes de coluna e linhas com o mesmo número de valores em cada linha. Não há suporte para dados hierárquicos, também conhecidos como hierarquias imperfeitas. Os nomes de colunas são salvos na definição de relatório como uma lista de campos do conjunto de dados.
Depois de adicionar conjuntos de dados a seu relatório, arraste campos de suas coleções de campos no painel Dados do Relatório para tabelas, gráficos e outros itens de relatório que você usa para criar o layout de relatório. Para obter mais informações sobre como trabalhar com campos, consulte Trabalhando com campos em um conjunto de dados de relatório (Construtor de Relatórios 3.0 e SSRS).
Compreendendo dados a partir de um conjunto de dados de relatório
Dependendo da extensão dos dados, um conjunto de dados de relatório pode consistir nos seguintes tipos de dados:
Um conjunto de resultados de um banco de dados relacional, que pode ser resultante da execução de comandos de banco de dados, procedimentos armazenados ou funções definidas pelo usuário. Caso vários conjuntos de resultados sejam recuperados com uma única consulta, apenas o primeiro será processado e todos os demais serão ignorados. Por exemplo, quando você executa a seguinte consulta no designer de consulta baseado em texto, apenas o conjunto de resultados de Production.Product é exibido no painel de resultados:
SELECT ProductID FROM Production.Product GO SELECT ContactID FROM Person.ContactUm conjunto de linhas bidimensional de fontes de dados multidimensionais que usam o protocolo XMLA (XML for Analysis). Alguns provedores de dados fornecem propriedades adicionais de célula e dimensão da fonte de dados que não é possível ver no conjunto de resultados, mas que estão disponíveis no relatório.
Um conjunto de resultados bidimensional de fontes de dados XML que incluem elementos XML, seus atributos e elementos filhos.
Um conjunto de resultados de qualquer provedor de dados do .NET Framework registrado e configurado.
Dados de um modelo de relatório criado para uma fonte de dados específica, com entidades predefinidas, relações entre entidades e campos. Para obter mais informações, consulte "Using Report Models as Data Sources" na documentação do Reporting Services (em inglês) nos Manuais Online do SQL Server.
Quando o relatório é processado em tempo de execução, o conjunto de resultados real retornado para uma consulta pode ter zero ou mais linhas. Também é possível que as colunas definidas na consulta não sejam encontradas na fonte de dados. Valores nulos da fonte de dados são mapeados para o .NET Framework valor System.DBNull.Value.
Para obter mais informações sobre campos de conjunto de dados, consulte Trabalhando com campos em um conjunto de dados de relatório (Construtor de Relatórios 3.0 e SSRS).
.gif "Ícone de seta usado com o link Voltar ao Início")
Voltar ao início
Consulta do conjunto de dados
Ao executar uma consulta de conjunto de dados em um designer de consulta no tempo de design, você vê um conjunto de linhas da fonte de dados que mostra dados de exemplo. Em tempo de execução, quando um usuário exibe o relatório, a consulta de conjunto de dados pode produzir valores diferentes porque os dados foram alterados na fonte. Sempre que o relatório é processado, podem aparecer dados novos.
Quando você define cada conjunto de dados, o Construtor de Relatórios abre o designer de consulta que corresponde ao tipo de fonte de dados para ajudar a criar consultas. Por exemplo, para definir uma consulta para dados a partir de um banco de dados relacional do SQL Server, os assistentes de tabela/matriz, gráfico e mapa abrem uma interface gráfica que ajuda a criar a consulta; você só precisa selecionar os campos desejados no conjunto de dados.
Em um designer de consulta, você pode fazer o seguinte:
Ativar/desativar entre exibição de consulta gráfica e baseada em texto. Usar o gráfico para explorar esquemas, tabelas, exibições e procedimentos armazenados na fonte de dados. Usar a exibição baseada em texto para digitar, colar ou exibir uma consulta existente, geralmente usado para uma consulta complexa que não pode ser exibida em um designer de consultas gráficas. Por exemplo, você pode importar uma consulta de um arquivo Transact-SQL (.sql), um relatório diferente no servidor de relatório, ou um arquivo de definição de relatório (.rdl) de um compartilhamento de arquivos.
Execute a consulta para ver os dados. A consulta retorna um conjunto de resultados. As colunas no conjunto de resultados se transformam na coleção de campos no conjunto de dados. As linhas no resultado se transformam nos dados do conjunto de dados. Você pode trabalhar com a consulta até obter as colunas desejadas.
Adicione parâmetros de consulta para ajudar a recuperar apenas os dados que você deseja para o relatório. Os parâmetros de consulta geram automaticamente parâmetros de relatório correspondentes. Para uma fonte de dados de modelo de relatório, o filtro que você especifica gera automaticamente um parâmetro de relatório compatível. Os parâmetros de relatório permitem que os usuários especifiquem os dados de relatório que desejam consultar quando executam o relatório. Por exemplo, o usuário seleciona de quais categorias de produto deseja dados. Quando o relatório executar, somente dados para essas categorias de produto aparecem no relatório.
Importe uma consulta existente de outro relatório.
Designers de consulta podem fornecer um modo gráfico ou um modo de texto dependendo do tipo de fonte de dados. Se você escolher modo de texto, deve usar a sintaxe de consulta apropriada para a fonte de dados.
Ao definir um conjunto de dados de relatório, você pode configurar propriedades de dados na consulta ou aceitar os padrões definidos pelo provedor de dados. É possível alterar um tipo de dados usando uma das seguintes estratégias:
Reescreva a consulta de conjunto de dados para converter especificamente um campo em um tipo de dados diferente.
Edite o campo no conjunto de dados e forneça um formato personalizado.
Crie um novo campo personalizado com base em um campo do banco de dados e forneça um formato personalizado.
Para obter mais informações, consulte Trabalhando com campos em um conjunto de dados de relatório (Construtor de Relatórios 3.0 e SSRS).
Voltar ao início
Importando consultas existentes de um conjunto de dados
Ao criar um conjunto de dados, você pode criar uma nova consulta ou importar uma existente de um arquivo ou de outro relatório. Ao importar uma consulta de outro relatório, você pode escolher qual consulta deve ser importada da lista dos conjuntos de dados no relatório.
Só há suporte para os tipos de arquivo .sql e .rdl. Consultas de Linguagem MDX, consultas de Previsão de Mineração de Dados (DMX) e consultas de modelo (SMQL) somente podem ser geradas pelo designer de consulta associado.
Voltar ao início
Comparando e criando conjuntos de dados compartilhados e conjuntos de dados inseridos
Um conjunto de dados inserido é definido em um relatório ou em uma parte de relatório publicada. As alterações feitas em um conjunto de dados inserido afetam somente aquele relatório ou aquela parte de relatório.
Um conjunto de dados compartilhado é definido em um servidor de relatório ou site do SharePoint, é baseado em uma fonte de dados compartilhada e pode usado por vários relatórios e partes de relatório. As alterações feitas a uma definição de conjunto de dados compartilhada afetam todos os relatórios e todas as partes de relatório que a usam.
Ao adicionar um conjunto de dados compartilhado ao um relatório, a coleção de campos de conjunto de dados é atualizada para a definição atual no servidor de relatório. Você não recebe notificações de atualização quando são feitas alterações no servidor de relatório. Para sincronizar uma cópia local da coleção de campos com alterações feitas à definição de conjunto de dados compartilhada no servidor de relatório, você deve atualizar a coleção de campos local. Para obter mais informações, consulte Como adicionar, editar e atualizar campos no painel Dados do Relatório (Construtor de Relatórios 3.0 e SSRS).
Os itens de relatório publicados contêm os conjuntos de dados inseridos e compartilhados dos quais eles dependem. Para obter mais informações, consulte Trabalhando com partes e conjuntos de dados de relatório no Report Builder 3.0.
Para obter mais informações sobre como criar conjuntos de dados, consulte Como criar um conjunto de dados compartilhado ou um conjunto de dados inserido (Report Builder 3.0 e SSRS). Para obter mais informações sobre conjuntos de dados compartilhados depois de eles terem sido salvos em um servidor de relatório, consulte Gerenciando conjuntos de dados compartilhados na documentação do Reporting Services (em inglês) nos Manuais Online do SQL Server.
Voltar ao início
Filtrando, classificando e agrupando dados em um conjunto de dados
Os dados em um conjunto de dados são obtidos quando um comando de consultas é executado em uma fonte de dados externa. A sintaxe do comando de consulta para uma extensão de dados determina se os dados podem ser classificados ou agrupados. Classificar e agrupar ocorre na consulta antes de os dados serem recuperados para um relatório. Filtrar ocorre após os dados serem recuperados para um relatório.
Para obter mais informações, consulte Filtrando, agrupando e classificando dados (Construtor de Relatórios 3.0 e SSRS).
Filtrando os dados de um conjunto de dados
Os filtros fazem parte da definição de conjunto de dados em um relatório. Use filtros de conjunto de dados para especificar quais dados de um conjunto de dados devem ser incluídos em um relatório. Quando você especifica filtros em um conjunto de dados, todas as regiões de dados que são baseadas no conjunto de dados exibem somente os dados que passam pelos filtros do conjunto de dados.
Os filtros fazem parte de uma definição de conjuntos de dados compartilhados. Os filtros de conjunto de dados compartilhados afetam todos os relatórios que incluem o conjunto de dados compartilhado. Depois de adicionar um conjunto de dados compartilhado ao relatório, ou depois de adicionar um componente com um conjunto de dados compartilhado dependente, você pode criar filtros de conjunto de dados adicionais. Os filtros que você cria são usados somente no seu relatório, eles não fazem parte da definição de conjunto de dados compartilhada no servidor de relatório.
É possível definir filtros adicionais em uma região de dados ou grupo de regiões de dados. Você pode usar uma combinação de parâmetros e filtros que permitem que os usuários escolham os dados que eles desejam ver em um relatório. Para obter mais informações, consulte Parâmetros (Report Builder 3.0 e SSRS).
Classificando dados em um conjunto de dados
Em um conjunto de dados, a ordem dos dados é a ordem em que eles são recuperados da fonte de dados externa. Esta é a mesma ordem que você vê quando executa a consulta no designer de consulta. Se a sintaxe do comando de consulta dá suporte à classificação, você pode editar a consulta para classificar os dados na fonte, antes de eles serem retornados como dados de relatório. Por exemplo, para uma consulta do Transact-SQL, a instrução ORDER BY controla a ordem de classificação.
Para classificar dados depois que são retornados ao relatório, defina expressões de classificação em regiões de dados e grupos de regiões de dados. Para obter mais informações, consulte o tópico para o tipo específico de região de dados, por exemplo, Tabelas, matrizes e listas (Report Builder 3.0 e SSRS).
Você pode usar uma combinação de parâmetros e expressões de classificação para permitir que os usuários escolham a ordem de classificação para os dados em um relatório. Para obter mais informações, consulte Parâmetros (Report Builder 3.0 e SSRS).
Agrupando dados em um conjunto de dados
Você não pode agrupar dados em um conjunto de dados. Para agregar dados em um conjunto de dados, você pode editar o comando de consulta para calcular agregações antes de os dados serem recuperados para um relatório. Eles são conhecidos como agregações do servidor. Em expressões, para identificar estes valores como agregações pré-calculadas, use a função de agregação. Para obter mais informações, consulte Função de agregação (Construtor de Relatórios 3.0 e SSRS).
Usando parâmetros e conjuntos de dados
Para uma consulta de banco de dados inserido que contém variáveis de consulta, parâmetros de consulta e os parâmetros de relatório correspondentes são automaticamente criados. Quando o relatório é executado, o valor do parâmetro do relatório é vinculado ao parâmetro de consulta do conjunto de dados. Dessa maneira, o comando de consulta que é executado na fonte de dados externa inclui os valores que são especificados para parâmetros de relatório. Os parâmetros de relatório permitem que um usuário escolha os dados que deseja ver no relatório. Você pode ver como os parâmetros de consulta e os parâmetros de relatório são vinculados na página Caixa de diálogo Propriedades do Conjunto de Dados, Parâmetros (Construtor de Relatórios 3.0).
Para um conjunto de dados compartilhado, os parâmetros de consulta fazem parte da definição de conjunto de dados compartilhada que pode ser gerenciada no servidor de relatório independentemente de um relatório. A lista seguinte descreve o suporte para valores de parâmetros de consulta:
Pode ser baseado em expressão.
Pode incluir valores padrão.
Pode ser definido como somente leitura. Parâmetros somente leitura não podem ser alterados em uma instância do conjunto de dados compartilhado em um relatório.
Não pode incluir referências à coleção de Parâmetros interna, que representa os parâmetros de relatório.
Para configurar os valores do parâmetro de consulta para um conjunto de dados compartilhado, em modo de design de conjunto de dados, navegue e abra um conjunto de dados compartilhado do servidor de relatório e defina as opções na página Caixa de diálogo Propriedades do Conjunto de Dados, Parâmetros (Construtor de Relatórios 3.0). Para obter mais informações, consulte Como criar um conjunto de dados compartilhado ou um conjunto de dados inserido (Report Builder 3.0 e SSRS).
Para algumas fontes de dados multidimensionais, como o Analysis Services, o designer de consultas gráficas permite especificar filtros de consulta e selecionar uma opção para criar um parâmetro de consulta correspondente. Quando você seleciona a opção de parâmetro, a extensão de dados automaticamente cria um conjunto de dados de relatório separado para fornecer valores disponíveis em uma lista suspensa para aquele parâmetro. Por padrão, esses conjuntos de dados ocultos não são exibidos no painel Dados do Relatório.
Parâmetros de relatório que são vinculados a parâmetros de consulta ajudam a filtrar os dados antes de eles serem retornados da fonte de dados externa. Você também pode filtrar dados no relatório criando filtros que fazem parte da definição de relatório. Para obter mais informações, consulte Filtrando, agrupando e classificando dados (Construtor de Relatórios 3.0 e SSRS).
Exibindo conjuntos de dados ocultos
Quando você cria uma consulta parametrizada para algumas fontes de dados multidimensionais, os conjuntos de dados que fornecem valores válidos para o parâmetro são automaticamente criados. Em alguns designers de consulta, você faz isto especificando filtros e selecionando a opção para criar parâmetros. Por padrão, esses conjuntos de dados não são exibidos no painel Dados do Relatório, mas eles podem ser exibidos. Para obter mais informações, consulte Como mostrar conjuntos de dados ocultos para obter valores de parâmetros para dados multidimensionais (Construtor de Relatórios 3.0 e SSRS).
Voltar ao início
Usando modelos de relatório
Modelos de relatório permitem selecionar dados para um relatório sem ter um conhecimento detalhado da estrutura de dados na origem de dados subjacentes. Uma pessoa com experiência no design de modelo deve primeiro criar um modelo de relatório e publicá-lo antes de poder usá-lo como fonte de dados.
Os modelos de relatório contêm campos predefinidos e relacionamentos de dados, entidades chamadas e funções, que aparecem no painel Dados. Você pode usar estes itens da mesma forma que usa campos de conjuntos de dados: arrastando-os à superfície de design enquanto cria seu relatório. Para obter mais informações, consulte Interface de usuário do Designer de Consulta do modelo de relatório (Construtor de Relatórios 3.0).
Para obter mais informações sobre como criar modelos de relatório, consulte "Trabalhando com o Designer de Modelo" na documentação do Reporting Services nos Manuais Online do SQL Server. Para obter mais informações sobre como criar relatórios ad hoc, consulte Criando e implementando relatórios com o uso do Construtor de Relatórios 1.0 no msdn.microsoft.com.
Voltar ao início
Usando mapas e conjuntos de dados
Se você incluir um mapa em seu relatório, deve fornecer dados espaciais. Os dados espaciais devem ser obtidos de um conjunto de dados de relatório, de um mapa na galeria de mapas ou dos arquivos de forma ESRI. Os dados espaciais de um relatório ou de um arquivo de forma ESRI não aparecem como um conjunto de dados no painel Dados do Relatório. Para obter mais informações, consulte Mapas (Report Builder 3.0 e SSRS).
Voltar ao início
Exibindo dados de vários conjuntos de dados
Normalmente, um relatório tem mais de um conjunto de dados. A seguinte lista descreve como é possível usar conjuntos de dados em um relatório:
Você exibe os dados de cada conjunto de dados usando uma região de dados separada. Para obter mais informações, consulte Regiões e mapas de dados (Construtor de Relatórios 3.0 e SSRS).
Você pode vincular mais de uma região de dados ao conjunto de dados e fornecer várias exibições dos mesmos dados. Para obter mais informações, consulte Vinculando várias regiões de dados ao mesmo conjunto de dados (Construtor de Relatórios 3.0 e SSRS).
É possível usar conjuntos de dados para fornecer uma lista suspensa dos valores disponíveis ou padrão de um parâmetro de relatório. Para obter mais informações, consulte Parâmetros (Report Builder 3.0 e SSRS).
É possível vincular dados relacionados de vários conjuntos de dados usando parâmetros com relatórios de detalhamento ou sub-relatórios. Por exemplo, um relatório de vendas pode mostrar dados resumidos de todas as lojas, e um link para detalhamento pode especificar o identificador da loja como parâmetro de um relatório com uma consulta de conjunto de dados que recupera as vendas individuais da loja especificada. Para obter mais informações, consulte Detalhamento, busca detalhada, sub-relatórios e regiões de dados aninhadas (Construtor de Relatórios 3.0 e SSRS) e Sub-relatórios (Construtor de Relatórios 3.0 e SSRS).
Não é possível exibir dados detalhados de vários conjuntos de dados em uma única região de dados. No entanto, você pode exibir valores de função de agregação ou interna de vários conjuntos de dados em uma região de dados. Para obter mais informações, consulte Referência de funções de agregação (Construtor de Relatórios 3.0 e SSRS). Caso precise integrar dados detalhados de vários conjuntos de dados a uma região, você deve reescrever a consulta para recuperar os dados como um conjunto único.
Voltar ao início
Exibindo uma mensagem quando nenhuma linha de dados está disponível
Durante o processamento do relatório, quando a consulta a um conjunto de dados é executada, o conjunto de resultados pode não conter nenhuma linha. No relatório renderizado, uma região de dados vinculada a um conjunto de dados vazio é exibida como uma região de dados vazia. É possível especificar um texto a ser exibido no relatório renderizado em lugar da região de dados vazia. Também é possível especificar uma mensagem para sub-relatórios quando as consultas a todos os conjuntos de dados não produzem nenhum dado em tempo de execução. Para obter mais informações, consulte Como definir uma mensagem Nenhum Dado para uma região de dados (Construtor de Relatórios 3.0 e SSRS).
Voltar ao início
Definindo opções do conjunto de dados
Para fontes de dados que oferecem suporte a dados internacionais, você deve ajustar as propriedades para um conjunto de dados que afetam a ordem de classificação, as propriedades de caracteres internacionais e a diferenciação de maiúsculas e minúsculas. Entre essas propriedades estão maiúsculas e minúsculas, tipo kana, largura, acentuação e agrupamento. Para obter mais informações, consulte “Considerações internacionais para aplicativos de banco de dados e aplicativos do Mecanismo de Banco de Dados” e “Trabalhando com agrupamentos” nos manuais Online do SQL Server. Para obter mais informações sobre como definir essas propriedades, consulte Caixa de diálogo Propriedades do Conjunto de Dados, Opções (Construtor de Relatórios 3.0).
Voltar ao início