Conjuntos de Dados Incorporados em Relatórios e Conjuntos de Dados Partilhados (Report Builder e SSRS)

Um conjunto de dados especifica os dados que você deseja usar de uma conexão de dados. Um conjunto de dados baseia-se numa ligação de dados que foi guardada no relatório como fonte de dados embutida ou como referência a uma fonte de dados partilhada num servidor de relatórios. 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 partilhado é definido no servidor de relatórios. Pode aceder ao servidor para criar um conjunto de dados partilhado ou selecionar um pré-definido para adicionar ao seu relatório. Use um conjunto de dados partilhado para fornecer uma consulta que possa ser usada por mais do que um relatório. Os conjuntos de dados partilhados são armazenados no servidor de relatórios e geridos separadamente dos relatórios ou fontes de dados partilhadas. Por exemplo, um administrador de servidor de relatórios pode atualizar a consulta para tirar partido de uma indexação melhorada ou outra otimização do desempenho das consultas.

• Conjunto de dados incorporado. Um conjunto de dados incorporado é definido e usado apenas pelo relatório no qual está incorporado. Use um conjunto de dados incorporado quando quiser obter dados de uma fonte de dados externa para serem usados apenas em um relatório. Conjuntos de dados incorporados são úteis quando se quer criar uma consulta que não tem outras dependências e que não precisa de usar para múltiplos relatórios.

Um conjunto de dados também inclui parâmetros, filtros e opções de dados que especificam sensibilidades de caracteres, como maiúsculas e minúsculas, tipo kana, largura, acento e informações de agrupamento.

1. Conjuntos de dados no painel de Dados de Relatório Um conjunto de dados aparece no painel de Dados de Relatório depois de criar um conjunto de dados incorporado ou adicionar um conjunto de dados partilhado. Um conjunto de dados é baseado em uma fonte de dados.

2. Designer de Consulta Quando você cria uma consulta de conjunto de dados, o designer de consulta associado ao tipo de fonte de dados é aberto.

3. Comando de consulta O designer de consulta ajuda a criar um comando de consulta. A sintaxe do comando é determinada pelo provedor de dados.

4. Extensão de Dados/Provedor de Dados A conexão com os dados pode ser feita por meio de várias camadas de acesso a dados.

5. Fontes de dados externas Recupere dados de bases de dados relacionais, bases de dados multidimensionais, listas SharePoint, serviços Web ou modelos de relatórios.

6. Resultados da consulta Você pode executar a consulta e ver um conjunto de resultados de exemplo. Você deve ter credenciais de tempo de design para executar uma consulta.

7. 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-SQL SELECT retorna os nomes das colunas de uma tabela de banco de dados. Use o painel Dados do Relatório para expandir o conjunto de dados e exibir a coleção de campos do conjunto de dados.

Os dados também podem ser incluídos num relatório utilizando conjuntos de dados partilhados pré-definidos e partes do relatório. Estes itens já têm a informação de ligação de dados de que precisas. Para mais informações, consulte Conjuntos de Dados de Relatórios (SSRS) e Partes de Relatórios (Report Builder e SSRS).

Para mais informações sobre tipos de fontes de dados incorporados e extensões de dados, consulte Adicionar Dados a partir de Fontes de Dados Externas (SSRS).

Compreensão de Conjuntos de Dados de Relatórios 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 recuperar. Para criar o comando de consulta, utilize o designer de consultas associado à extensão de dados da fonte de dados externa. No designer de consulta, você pode executar o comando query e exibir um conjunto de resultados. O conjunto de resultados é um conjunto de linhas retangular que tem nomes de colunas e linhas com o mesmo número de valores em cada linha. Dados hierárquicos, também conhecidos como hierarquias irregulares, não são suportados. Os nomes das 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 ao 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 usados para criar o layout do relatório. Para mais informações sobre como trabalhar com campos, consulte Dataset Fields Collection (Report Builder e SSRS).

Compreender Dados de um Conjunto de Dados de Relatórios

Dependendo da extensão de 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 resultar da execução de comandos de banco de dados, procedimentos armazenados ou funções definidas pelo usuário. Se vários conjuntos de resultados forem recuperados por meio de uma única consulta, somente o primeiro conjunto de resultados será processado e todos os outros conjuntos de resultados serão ignorados. Por exemplo, quando você executa a seguinte consulta no designer de consulta baseado em texto, somente o conjunto de resultados para Production.Product aparece no painel de resultados:

  SELECT ProductID FROM Production.Product  
  GO  
  SELECT ContactID FROM Person.Contact  
  

• Um conjunto de linhas nivelado de fontes de dados multidimensionais que usam o protocolo XML for Analysis (XMLA). Alguns provedores de dados fornecem propriedades adicionais de célula e dimensão da fonte de dados que você não pode ver no conjunto de resultados, mas que estão disponíveis no relatório.

• Um conjunto de resultados uniformizado proveniente de fontes de dados XML que incluem elementos XML, os seus atributos e os seus elementos subordinados.

• Um conjunto de resultados de qualquer provedor de dados .NET Framework registrado e configurado.

• Dados de um modelo de relatório que foi concebido para uma fonte de dados específica, com entidades, relações de entidade e campos pré-definidos. Para mais informações, consulte "Relatar Conjuntos de Dados" na documentação do Reporting Services.

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 estejam ausentes da fonte de dados. Os valores nulos da fonte de dados são mapeados para o valor do .NET Framework System.DBNull.Value.

Para mais informações sobre campos de conjuntos de dados, consulte Coleção de Campos de Conjunto de Dados (Report Builder e SSRS).

Consulta ao Conjunto de Dados

Quando executa uma consulta de conjunto de dados num estruturador de consultas em tempo de estruturação, vê um conjunto de linhas da origem de dados que apresenta dados de exemplo. Em tempo de execução, quando um usuário exibe o relatório, a consulta do conjunto de dados pode produzir valores diferentes porque os dados na fonte de dados foram alterados. Cada vez que o relatório é processado, novos dados podem aparecer.

Quando defines cada conjunto de dados, o Report Builder abre o designer de consultas que corresponde ao tipo de fonte de dados para te ajudar a desenhar as consultas. Por exemplo, para definir uma consulta para dados de um banco de dados relacional do SQL Server, os assistentes Tabela/Matriz, Gráfico e Mapa abrem uma interface gráfica simples que ajuda a criar a consulta; Tudo o que você precisa fazer é selecionar os campos que deseja em seu conjunto de dados.

Em um designer de consulta, você pode fazer o seguinte:

• Alterne entre o modo de exibição de consulta gráfico e baseado em texto. Use o gráfico para explorar esquemas, tabelas, exibições e procedimentos armazenados na fonte de dados. Use o modo de exibição baseado em texto para digitar, colar ou exibir uma consulta existente, normalmente usada para uma consulta complexa que não pode ser exibida em um designer de consulta gráfico. Por exemplo, pode importar uma consulta de um ficheiro Transact-SQL (.sql), um relatório diferente no servidor de relatórios ou um ficheiro de definição de relatório (.rdl) a partir de um partilha de ficheiros.

• Execute a consulta para ver os dados. A consulta retorna um conjunto de resultados. As colunas no conjunto de resultados tornam-se a coleção de campos para o conjunto de dados. As linhas do resultado passam a constituir os 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 desejados 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 especificado gera automaticamente um parâmetro de relatório correspondente. Os parâmetros de relatório permitem que os usuários especifiquem os dados do relatório que desejam ver quando executam o relatório. Por exemplo, o usuário seleciona para quais categorias de produtos deseja obter dados e, quando o relatório é executado, os dados somente dessas categorias de produtos aparecem no relatório.

• Importa uma consulta existente de outro relatório.

Os designers de consulta podem fornecer um modo gráfico ou um modo de texto, dependendo do tipo de fonte de dados. Se você escolher o modo de texto, deverá usar a sintaxe de consulta apropriada para a fonte de dados.

Ao definir um conjunto de dados de relatório, você pode definir propriedades de dados na consulta ou aceitar os padrões definidos pelo provedor de dados. Você pode alterar um tipo de dados usando uma das seguintes estratégias:

• Reescreva a consulta do 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 de banco de dados e forneça um formato personalizado.

Para mais informações, consulte Coleção de Campos de Conjunto de Dados (Report Builder e SSRS).

Importação de Consultas Existentes para um Conjunto de Dados

Quando cria um conjunto de dados, pode criar uma nova consulta ou importar uma consulta existente a partir de um ficheiro ou de outro relatório. Quando importa uma consulta de outro relatório, pode escolher qual consulta importar da lista de conjuntos de dados no relatório.

Apenas os tipos de ficheiro .sql e .rdl são suportados. Consultas de Expressão Multidimensional (MDX), consultas de Previsão de Mineração de Dados (DMX) e consultas de modelo (SMQL) só podem ser geradas pelo designer de consultas associado.

Comparação e Criação de Conjuntos de Dados Partilhados e Conjuntos de Dados Incorporados

Um conjunto de dados incorporado é definido num relatório ou numa parte de relatório publicado. As alterações feitas a um conjunto de dados incorporados afetam apenas esse relatório ou essa parte do relatório.

Um conjunto de dados partilhado é definido num servidor de relatórios ou num site SharePoint, baseia-se numa fonte de dados partilhada e pode ser utilizado por múltiplos relatórios e partes de relatórios. As alterações feitas à definição de um conjunto de dados partilhado afetam todos os relatórios e todas as partes de relatórios que o utilizam.

Quando adiciona um conjunto de dados partilhado a um relatório, a coleção de campos do conjunto de dados é atualizada para a definição atual no servidor de relatórios. Não recebe notificações de atualização quando são feitas alterações no servidor de relatórios. Para sincronizar uma cópia local da coleção de campos com as alterações feitas à definição do conjunto de dados partilhado no servidor de relatórios, deve atualizar a coleção local de campos. Para obter mais informações, consulte Adicionar, editar, atualizar campos no painel de dados do relatório (Construtor de Relatórios e SSRS).

Os itens de relatório publicados contêm os conjuntos de dados incorporados e partilhados dos quais dependem. Para mais informações, consulte Reporte de Peças e Conjuntos de Dados no Report Builder.

A diferença entre as fontes de dados embutidas e partilhadas está na forma como são criadas, armazenadas e geridas. A tabela seguinte resume as diferenças entre fontes de dados incorporadas e partilhadas:

Description	Incorporado Fonte de dados	Partilhado Fonte de dados
A ligação de dados está incorporada na definição do relatório.
O apontador para a ligação de dados no servidor de relatórios está incorporado na definição do relatório.
Gerido no servidor de relatórios
Necessário para conjuntos de dados partilhados
Necessário para componentes

No Designer de Relatórios, pode criar conjuntos de dados partilhados como parte de um projeto de relatório e controlar se os implanta num servidor de relatórios. Não pode navegar até um servidor de relatórios e selecionar um conjunto de dados partilhado para adicionar ao seu relatório.

No Construtor de Relatórios, pode fazer o seguinte:

• Para criar um conjunto de dados partilhado, utilize a Shared Dataset Design View. Podes guardá-lo num servidor de relatórios ou num site SharePoint para partilhar com outros relatórios. Também pode navegar até ao servidor de relatórios e editar um conjunto de dados partilhado existente. Nesta visão, pode construir uma consulta e definir todas as opções do conjunto de dados. Para mais informações, consulte Shared Dataset Design View (Report Builder).

• Para adicionar um conjunto de dados partilhado ao seu relatório, abra o Construtor de Relatórios na Vista de Design de Relatórios. A partir de um assistente ou do painel de Dados de Relatório, navegue até ao servidor de relatórios e selecione o conjunto de dados partilhado para adicionar ao seu relatório. Nesta perspetiva, não pode alterar a consulta exceto para adicionar campos. Podes sobrescrever outras opções de dados e adicionar filtros. Não podes remover filtros.

A tabela seguinte compara as propriedades que podem ser configuradas para a definição do conjunto de dados partilhado no servidor de relatórios e a instância do conjunto de dados partilhado na definição do relatório.

Para mais informações sobre a criação de conjuntos de dados, consulte Criar um Conjunto de Dados Partilhado ou Conjunto de Dados Incorporado (Report Builder e SSRS) e Ferramentas de Reporting Services na documentação do Reporting Services.

Filtragem, ordenação e agrupamento de dados num conjunto de dados

Os dados em um conjunto de dados vêm da execução de um comando de consulta em uma fonte de dados externa. A sintaxe do comando query para uma extensão de dados determina se os dados podem ser classificados ou agrupados. A classificação e o agrupamento ocorrem na consulta antes que os dados sejam recuperados para um relatório. A filtragem ocorre depois que os dados são recuperados para um relatório.

Para mais informações, consulte Filtrar, Agrupar e Ordenar Dados (Construtor de Relatórios e SSRS).

Filtragem de Dados num Conjunto de Dados

Os filtros fazem parte da definição do 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 baseadas no conjunto de dados exibem apenas os dados que passam pelos filtros do conjunto de dados.

Os filtros fazem parte de uma definição de conjunto de dados partilhada. Os filtros de conjunto de dados partilhados afetam todos os relatórios que incluem o conjunto de dados partilhado. Depois de adicionar um conjunto de dados partilhado ao seu relatório, ou depois de adicionar um componente com um conjunto de dados partilhado dependente, pode criar filtros adicionais para o conjunto de dados. Os filtros que cria são usados apenas no seu relatório, não fazem parte da definição do conjunto de dados partilhado no servidor de relatórios.

Você pode definir filtros adicionais em uma região de dados ou em um grupo de regiões de dados. Você também pode usar uma combinação de parâmetros e filtros para permitir que os usuários escolham os dados que desejam ver em um relatório. Para obter mais informações, consulte Parâmetros de relatório (Construtor de Relatórios e Designer de Relatórios).

Ordenação de Dados num Conjunto de Dados

Em um conjunto de dados, a ordem dos dados é a ordem em que são recuperados da fonte de dados externa. Essa é a mesma ordem que você vê quando executa a consulta no designer de consulta. Se a sintaxe do comando query oferecer suporte à classificação, você poderá editar a consulta para classificar os dados na origem, antes que eles sejam retornados como dados de relatório. Por exemplo, para uma consulta Transact-SQL, a instrução ORDER BY controla a ordem de classificação.

Para classificar os dados depois que eles forem retornados ao relatório, defina expressões de classificação em regiões de dados e grupos de regiões de dados. Para 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 e SSRS).

Você também 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 dos dados em um relatório. Para obter mais informações, consulte Parâmetros de relatório (Construtor de Relatórios e Designer de Relatórios).

Agrupamento de Dados num Conjunto de Dados

Não é possível agrupar dados em um conjunto de dados. Para agregar dados em um conjunto de dados, você pode editar o comando query para calcular agregações antes que os dados sejam recuperados para um relatório. Estes são conhecidos como agregados de servidor. Em expressões, para identificar esses valores como agregados pré-calculados, use a função Agregar. Para mais informações, consulte Função Agregada (Report Builder e SSRS).

Utilização de parâmetros e conjuntos de dados

Para uma consulta de conjunto de dados incorporado que contém variáveis de consulta, os parâmetros de consulta e os parâmetros de relatório correspondentes são criados automaticamente. Quando o relatório é executado, o valor do parâmetro de relatório é vinculado ao parâmetro de consulta do conjunto de dados. Dessa forma, o comando de consulta executado na fonte de dados externa inclui os valores especificados para os parâmetros de relatório. Os parâmetros de relatório permitem que um usuário ajude a escolher os dados que deseja ver no relatório. Você pode exibir como os parâmetros de consulta e os parâmetros de relatório são vinculados na caixa de diálogo Propriedades do conjunto de dados, página Parâmetros.

Para um conjunto de dados partilhado, os parâmetros de consulta fazem parte da definição do conjunto de dados partilhado que podem ser geridos no servidor de relatórios independentemente de um relatório. A lista a seguir 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. Os parâmetros só de leitura não podem ser alterados numa instância de um conjunto de dados partilhado num relatório.

• Não pode incluir referências à coleção incorporada Parameters, que representa parâmetros de relatório.

Para configurar valores de parâmetros de consulta para um conjunto de dados partilhado, no modo de design de conjunto de dados, navegue e abra um conjunto de dados partilhado a partir do servidor de relatórios, e defina opções na Caixa de Diálogo Propriedades do Conjunto de Dados, na página de Parâmetros. Para mais informações, consulte Criar um Conjunto de Dados Partilhado ou Conjunto de Dados Incorporado (Construtor de Relatórios e SSRS).

Para algumas fontes de dados multidimensionais, como os Serviços de Análise, o designer gráfico de consultas permite-lhe especificar filtros de consulta e selecionar uma opção para criar um parâmetro de consulta correspondente. Quando seleciona a opção de parâmetro, a extensão de dados cria automaticamente um conjunto de dados de relatório separado para fornecer os valores disponíveis para uma lista suspensa desse parâmetro. Por padrão, esses conjuntos de dados ocultos não aparecem no painel Dados do Relatório.

Os parâmetros de relatório vinculados a parâmetros de consulta ajudam a filtrar dados antes que os dados sejam 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 mais informações, consulte Filtrar, Agrupar e Ordenar Dados (Construtor de Relatórios e SSRS).

Exibição de Conjuntos de Dados Ocultos

Quando cria uma consulta parametrizada para algumas fontes de dados multidimensionais, são automaticamente criados conjuntos de dados que fornecem valores válidos para o parâmetro. Em alguns designers de consulta, você faz isso especificando filtros e, em seguida, selecionando a opção para criar parâmetros. Por padrão, esses conjuntos de dados não aparecem no painel Dados do Relatório, mas podem ser exibidos. Para mais informações, consulte Mostrar Conjuntos de Dados Ocultos para Valores de Parâmetros para Dados Multidimensionais (Construtor de Relatórios e SSRS).

Utilização de Mapas e Conjuntos de Dados

Se você incluir um mapa em seu relatório, deverá fornecer dados espaciais. Os dados espaciais podem provir de um conjunto de dados de relatório, de um mapa na galeria de mapas ou dos ESRI Shapefiles. Dados espaciais de um relatório ou de um Shapefile ESRI não aparecem como um conjunto de dados no painel de Dados de Relatório. Para mais informações, consulte Mapas (Construtor de Relatórios e SSRS).

Exibição de Dados de Múltiplos Conjuntos de Dados

Um relatório normalmente tem mais de um conjunto de dados. A lista a seguir descreve como você pode 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 mais informações, consulte Regiões de Dados e Mapas (Report Builder e SSRS).

• Você pode vincular mais de uma região de dados a um conjunto de dados e fornecer várias exibições dos mesmos dados. Para mais informações, consulte Ligar Múltiplas Regiões de Dados ao Mesmo Conjunto de Dados (Construtor de Relatórios e SSRS).

• Pode usar conjuntos de dados para fornecer uma lista suspensa de valores disponíveis ou valores padrão para um parâmetro de relatório. Para obter mais informações, consulte Parâmetros de relatório (Construtor de Relatórios e Designer de Relatórios).

• Você pode 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 de resumo para todas as lojas e um link de detalhamento pode especificar o identificador da loja como um parâmetro para um relatório com uma consulta de conjunto de dados que recupera as vendas individuais para a loja especificada. Para mais informações, consulte Pesquisa detalhada, desagregação, sub-relatórios e regiões de dados aninhadas (Report Builder e SSRS) e Sub-relatórios (Report Builder 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 agregados ou internos para vários conjuntos de dados em uma região de dados. Para mais informações, consulte Referência de Funções Agregadas (Report Builder e SSRS). Se precisar combinar dados detalhados de vários conjuntos de dados em uma região de dados, você deverá reescrever sua consulta para recuperar os dados como um único conjunto de dados.

Mostrar uma mensagem quando não há linhas de dados disponíveis

Durante o processamento do relatório, quando a consulta para um conjunto de dados é executada, o conjunto de resultados pode não conter linhas. No relatório renderizado, uma região de dados vinculada a um conjunto de dados vazio é exibida como uma região de dados vazia. Você pode especificar o texto a ser exibido no relatório renderizado no lugar da região de dados vazia. Você também pode especificar uma mensagem para sub-relatórios quando as consultas para todos os conjuntos de dados não produzirem dados em tempo de execução. Para mais informações, consulte Definir uma Mensagem Sem Dados para uma Região de Dados (Construtor de Relatórios e SSRS).

Definição de Opções de Conjunto de Dados

Para fontes de dados que oferecem suporte a dados internacionais, talvez seja necessário ajustar as propriedades de 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. Estas propriedades incluem maiúsculas e minúsculas, tipo de kana, largura, acento e ordenação. Para mais informações sobre como definir estas propriedades, consulte a Caixa de Diálogo Propriedades do Conjunto de Dados, Opções (Report Builder).

Conteúdo relacionado

• Coleção de campos de conjunto de dados (Construtor de Relatórios e SSRS)
• Criar cadeias de ligação de dados em Report Builder
• Conjuntos de dados de relatório (SSRS)