O tipo de conexão do SQL Server (SSRS)

  • Artigo

Para incluir dados de um banco de dados relacional do SQL Server no seu relatório, é necessário ter um conjunto de dados baseado na fonte de dados do relatório do tipo Microsoft SQL Server. Esse tipo de fonte de dados interna é baseado na extensão de dados do Microsoft SQL Server. Use esse tipo de fonte de dados para se conectar e para recuperar dados de uma versão atual e de versões anteriores de bancos de dados do SQL Server.

Essa extensão de dados dá suporte a parâmetros de vários valores, a agregações de servidor e a credenciais gerenciadas separadamente da cadeia de conexão.

Use as informações deste tópico para criar uma fonte de dados. Para ver instruções passo a passo, confira Adicionar e verificar uma conexão de dados (Construtor de Relatórios e SSRS).

Cadeia de conexão

Ao se conectar a um banco de dados SQL Server, você está se conectando ao objeto de banco de dados em uma instância do SQL Server em um servidor. O banco de dados pode ter vários esquemas que tenham várias tabelas, exibições e procedimentos armazenados. Especifique o objeto de banco de dados a ser usado no designer de consulta. Se não especificar um banco de dados na cadeia de conexão, você será conectado ao banco de dados padrão atribuído pelo administrador do banco de dados.

Contate o administrador do banco de dados para obter informações sobre a conexão e as credenciais que devem ser usadas para se conectar à fonte de dados. O exemplo de cadeia de conexão a seguir especifica um banco de dados de exemplo no cliente local:

Data Source=<server>;Initial Catalog=AdventureWorks

Para saber mais sobre exemplos de cadeias de conexão, confira Criar cadeias de conexão de dados – Construtor de Relatórios e SSRS.

Credenciais

As credenciais são necessárias para executar consultas, visualizar o relatório localmente e visualizá-lo no servidor de relatório.

Após a publicação do relatório, talvez seja necessário alterar as credenciais da fonte de dados para que, quando o relatório for executado no servidor de relatório, as permissões recuperadas sejam válidas.

Em um cliente de criação de relatório, as seguintes opções estão disponíveis para especificar credenciais:

  • Usuário atual do Windows (também conhecido como segurança integrada).

  • Usar um nome de usuário e senha armazenados.

  • Solicitar credenciais ao usuário. Essa opção só dá suporte à segurança integrada do Windows.

  • Nenhuma credencial é necessária. Para usar essa opção, você deve ter a conta de execução autônoma configurada no servidor de relatório. Para obter mais informações, confira Configurar a Conta de Execução Autônoma (Configuration Manager do Servidor de Relatório).

Para obter mais informações, confira Criar cadeias de conexão de dados – Construtor de Relatórios e SRS ou Especificar informações de credenciais e conexão para fontes de dados de relatório.

Consultas

Uma consulta especifica os dados a serem recuperados de um conjunto de dados de relatório. As colunas no conjunto de resultados para uma consulta populam a coleção de campos para um conjunto de dados. Um relatório só processa o primeiro conjunto de resultados recuperado por uma consulta.

Por padrão, se você criar uma nova consulta ou abrir uma consulta existente que possa ser representada no designer de consultas gráficas, o designer de consultas relacionais estará disponível. Você pode especificar uma consulta das seguintes formas:

  • Crie uma consulta interativamente. Use o designer de consultas relacionais, que mostra uma exibição hierárquica de tabelas, exibições, procedimentos armazenados e outros itens de banco de dados, organizado por esquema de banco de dados. Selecione colunas em tabelas ou exibições, ou especifique procedimentos armazenados ou funções de valor de tabela. Limite o número de linhas de dados a serem recuperadas especificando critérios de filtragem. Personalize o filtro quando o relatório for executado definindo a opção de parâmetro.

  • Digite ou cole uma consulta. Use o designer de consulta baseado em texto para inserir o texto do Transact-SQL diretamente, colar texto de consulta de outra fonte, inserir consultas complexas que não podem ser criadas com o designer de consultas relacionais ou inserir expressões baseadas em consulta.

  • Importa uma consulta existente de um arquivo ou relatório. Use o botão Importar consulta em qualquer designer de consulta para navegar até um arquivo .sql ou .rdl e importar uma consulta.

Para obter mais informações, confira Interface do usuário do Designer de Consultas Relacionais (Construtor de Relatórios) e Interface do usuário do Designer de Consultas Baseadas em Texto (Construtor de Relatórios).

Há suporte para os seguintes modos de consulta:

Usando o tipo de consulta Text

No designer de consulta baseado em texto, você pode digitar os comandos do Transact-SQL para definir os dados em um conjunto de dados. Por exemplo, a seguinte consulta Transact-SQL seleciona os nomes de todos os funcionários que são assistentes de marketing:

SELECT  
  HumanResources.Employee.BusinessEntityID  
  ,HumanResources.Employee.JobTitle  
  ,Person.Person.FirstName  
  ,Person.Person.LastName  
FROM  
  Person.Person  
  INNER JOIN HumanResources.Employee  
    ON Person.Person.BusinessEntityID = HumanResources.Employee.BusinessEntityID  
WHERE HumanResources.Employee.JobTitle = 'Marketing Assistant'

Clique no botão Executar ( ! ) na barra de ferramentas para executar a consulta e exibir um conjunto de resultados.

Para parametrizar essa consulta, adicione um parâmetro de consulta. Por exemplo, altere a cláusula WHERE para o seguinte:

WHERE HumanResources.Employee.JobTitle = (@JobTitle)

Quando você executa a consulta, os parâmetros do relatório que correspondem aos parâmetros da consulta serão criados automaticamente. Para obter mais informações, consulte Parâmetros de consulta mais adiante neste tópico.

Usando o tipo de consulta StoredProcedure

Você pode especificar um procedimento armazenado para uma consulta de conjunto de dados das seguintes maneiras:

  • Na caixa de diálogo Propriedades do Conjunto de dados , defina a opção Procedimento Armazenado . Faça suas escolhas na lista suspensa de procedimentos armazenados e funções avaliadas por tabela.

  • No designer de consulta relacional, no painel de exibição Banco de Dados, selecione um procedimento armazenado ou função avaliada por tabela.

  • No designer de consulta baseado em texto, selecione StoredProcedure na barra de ferramentas.

Após selecionar um procedimento armazenado ou função avaliada por tabela, você pode executar a consulta. Você receberá uma solicitação para obter valores de parâmetro de entrada. Quando você executa a consulta, os parâmetros do relatório que correspondem aos parâmetros de entrada serão criados automaticamente. Para obter mais informações, consulte Parâmetros de consulta mais adiante neste tópico.

Somente o primeiro conjunto de resultados recuperado para um procedimento armazenado é suportado. Se um procedimento armazenado retornar vários conjuntos de resultados, somente o primeiro será usado.

Se um procedimento armazenado tiver um parâmetro com um valor padrão, você poderá acessar esse valor usando a palavra-chave DEFAULT como valor para o parâmetro. Se o parâmetro de consulta estiver vinculado a um parâmetro de relatório, o usuário poderá digitar ou selecionar a palavra DEFAULT na caixa de entrada do parâmetro de relatório.

Para obter mais informações, consulte Criar procedimentos armazenados (Mecanismo de Banco de Dados).

Parâmetros

Quando o texto de consulta contém variáveis ou procedimentos armazenados com parâmetros de entrada, os parâmetros de consulta para o conjunto de dados e os parâmetros de relatório para o relatório são automaticamente gerados. O texto de consulta não deve incluir uma instrução DECLARE para cada variável de consulta.

Por exemplo, a consulta SQL a seguir cria um parâmetro de relatório chamado EmpID:

SELECT FirstName, LastName FROM HumanResources.Employee E INNER JOIN  
       Person.Contact C ON  E.ContactID=C.ContactID   
WHERE EmployeeID = (@EmpID)

Os parâmetros de relatório são criados com valores de propriedade padrão que talvez precisem ser modificados. Por exemplo:

  • Por padrão, cada parâmetro de relatório é do tipo de dados Texto. Se os dados subjacentes forem de outro tipo de dados, será necessário alterar o tipo de dados de parâmetro.

  • Se você selecionar a opção para parâmetros de vários valores, deverá alterar manualmente a consulta para testar se os valores fazem parte de um conjunto usando o operador IN , por exemplo, WHERE EmployeeID IN (@EmpID).

Para obter mais informações, confira Parâmetros de relatório (Construtor de Relatórios e Designer de Relatórios).

Comentários

Você também pode recuperar dados de um banco de dados do SQL Server com o uso de um tipo de fonte de dados do OLE DB ou ODBC. Para obter mais informações, confira Tipo de conexão do OLE DB (SSRS) ou Tipo de conexão do ODBC(SSRS).

Informações sobre plataforma e versão

Saiba mais sobre suporte de versão e plataforma em Fontes de dados com suporte no Reporting Services (SSRS).

Tópicos de instruções

Esta seção contém instruções passo a passo para trabalhar com conexões de dados, fontes de dados e conjuntos de dados.

Adicionar e verificar uma conexão de dados (Construtor de Relatórios e SSRS)

Criar um conjunto de dados compartilhado ou um conjunto de dados inserido (Construtor de Relatórios e SSRS)

Adicionar um filtro a um conjunto de dados (Construtor de Relatórios e SSRS)

Estas seções da documentação especificam informações conceituais detalhadas sobre os dados do relatório e informações de procedimentos sobre como definir, personalizar e usar partes de um relatório relacionadas aos dados.

Conjuntos de dados de relatório (SSRS)
Fornece uma visão geral de como acessar dados de seu relatório.

Criar cadeias de conexão de dados – Construtor de Relatórios e SSRS
Fornece informações sobre conexões de dados e fontes de dados.

Conjuntos de dados inseridos e compartilhados de relatório (Construtor de Relatórios e SSRS)
Fornece informações sobre conjuntos de dados inseridos e compartilhados.

Coleção de campos de conjuntos de dados (Construtor de Relatórios e SSRS)
Fornece informações sobre a coleção de campos de conjuntos de dados gerada pela consulta.

Fontes de Dados com suporte no Reporting Services (SSRS).
Fornece informações detalhadas sobre suporte à plataforma e à versão para cada extensão de dados.

Consulte Também

Parâmetros de relatório (Construtor de Relatórios e Designer de Relatórios)
Filtrar, agrupar e classificar dados (Construtor de Relatórios e SSRS)
Expressões (Construtor de Relatórios e SSRS)