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

Para incluir dados de um banco de dados do SQL Server em 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 interno de fonte de dados é baseado na extensão de dados do MicrosoftSQL 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 compilar uma fonte de dados. Para obter instruções passo a passo, consulte Adicionar e verificar uma conexão de dados ou uma fonte de dados (Construtor de Relatórios e SSRS).

Neste artigo

Cadeia de conexão

Credenciais

Consultas

Parâmetros

Comentários

Tópicos de instruções

Seções relacionadas

Cadeia de conexão

Ao se conectar a um banco de dados do 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 sobre 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 obter mais informações sobre exemplos de cadeias de conexão, consulte Conexões de dados, fontes de dados e cadeias de conexão no Construtor de Relatórios.

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, consulte Configure a conta de execução autônoma na documentação do Reporting Services no msdn.microsoft.com.

Para obter mais informações, consulte Conexões de dados, fontes de dados e cadeias de conexão (SSRS) ou Especificar as credenciais no Construtor de Relatórios.

Voltar ao início

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 com base em texto para inserir o texto do Transact-SQL diretamente, para colar texto de consulta de outra fonte, para inserir consultas complexas que não possam ser criadas com o designer de consultas relacionais ou para inserir expressões com base 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, consulte Interface de usuário do Designer de Consulta relacional (Construtor de Relatórios) e Interface de usuário do Designer de Consulta baseado em texto (Construtor de Relatórios).

Há suporte para os seguintes modos de consulta:

• Tipo Text nos comandos Transact-SQL.

• Procedimento armazenado Escolha em uma lista de procedimentos armazenados.

Usando o tipo de consulta Text

No designer de consulta baseado em texto, você pode digitar os comandos 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.

Voltar ao início

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 "Procedimentos armazenados (mecanismo de banco de dados)" nos Manuais Online do SQL Server no msdn.microsoft.com.

Voltar ao início

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 Text. 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, consulte Parâmetros de relatório (Construtor de Relatórios e SSRS).

Voltar ao início

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, consulte Tipo de conexão OLE DB (SSRS) ou Tipo de conexão ODBC (SSRS).

Plataforma e informações de versão

Para obter mais informações sobre plataforma e suporte à versão, consulte Fontes de dados com suporte no Reporting Services (SSRS) na documentação do Reporting Services nos Manuais Online do SQL Server.

Voltar ao início

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 ou uma fonte 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)

Voltar ao início

Seções relacionadas

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.

• Adicionar dados a um relatório (Construtor de Relatórios e SSRS)
  Fornece uma visão geral de como acessar dados de seu relatório.

• Conexões de dados, fontes de dados e cadeias de conexão no Construtor de Relatórios
  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) na documentação do Reporting Services nos Manuais Online do SQL Server.
  Fornece informações detalhadas sobre suporte à plataforma e à versão para cada extensão de dados.

Voltar ao início

Consulte também

Conceitos

Parâmetros de relatório (Construtor de Relatórios e SSRS)

Filtrar, agrupar e classificar dados (Construtor de Relatórios e SSRS)

Expressões (Construtor de Relatórios e SSRS)