• Artigo

Tipo de conexão do SQL Azure (SSRS)

O Microsoft Banco de dados SQL Azure é um banco de dados relacional hospedado baseado em nuvem integrado às tecnologias do SQL Server. Para incluir dados do Banco de dados SQL Azure no relatório, é necessário ter um conjunto de dados baseado em uma fonte de dados de relatório de tipo SQL Azure. Esse tipo de fonte de dados interna é baseado na extensão de dados do SQL Azure. Use esse tipo de fonte de dados para se conectar a e recuperar dados do Banco de dados SQL Azure.

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

O SQL Azure é semelhante a uma instância do SQL Server em seu local e a obtenção de dados do Banco de dados SQL Azure é, com algumas exceções, idêntica à obtenção de dados do SQL Server. Os recursos do Banco de dados SQL Azure estão alinhados com o SQL Server 2008.

Para obter mais informações sobre o SQL Azure, consulte "SQL Azure" no msdn.microsoft.com.

Use as informações deste tópico para criar uma fonte de dados. Para obter instruções passo a passo, consulte Como adicionar e verificar uma conexão de dados ou uma fonte de dados (Construtor de Relatórios 3.0 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 ao SQL Azure, você está se conectando a um objeto de banco de dados na nuvem. Assim como nos bancos de dados no local, o banco de dados hospedado 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ê se conectará ao banco de dados padrão atribuído pelo administrador.

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 hospedado de exemplo chamado AdventureWorks.

Data Source=<host>;Initial Catalog=AdventureWorks; Encrypt=True;

Além disso, você usa a caixa de diálogo Propriedades de Fontes de dados para fornecer credenciais como nome de usuário e senha. As opções User Id e Password são adicionadas automaticamente à cadeia de conexão; você não precisa digitá-las como parte da cadeia de conexão.

Para obter mais informações e exemplos de cadeias de conexão, consulte Conexões de dados, fontes de dados e cadeias de conexão no Construtor de Relatórios 3.0.

Credenciais

Não há suporte para a Autenticação do Windows (segurança integrada). Se você tentar se conectar a SQL Azure usando a Autenticação do Windows, ocorrerá um erro. O SQL Azure só dá suporte à Autenticação do SQL Server (nome de usuário e senha), e os usuários devem fornecer credenciais (logon e senha) toda vez que se conectam ao SQL Azure.

As credenciais devem ser suficientes para acessar o banco de dados. Dependendo da consulta, você talvez precise de outras permissões, como permissões suficientes para executar procedimentos armazenados e acessar tabelas e exibições. O proprietário da fonte de dados externa deve configurar credenciais que sejam suficientes para fornecer acesso somente leitura aos objetos de banco de dados de que você precisa.

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

  • Usar um nome de usuário e senha armazenados. Para negociar o salto duplo que ocorre quando o banco de dados que contém os dados de relatório é diferente do servidor de relatório, selecione as opções para usar as credenciais como credenciais do Windows. Também é possível optar por representar o usuário autenticado depois de se conectar à fonte de dados.

  • 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 Configurando 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 Especificando credenciais no Construtor de Relatórios 3.0.

Ícone de seta usado com o link Voltar ao InícioVoltar 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. Se a consulta retornar vários conjuntos de resultados, o relatório só processará o primeiro conjunto de resultados recuperado por uma consulta. Embora haja algumas diferenças entre os bancos de dados do SQL Server e SQL Azure como os tamanhos de bancos de dados suportados, escrever consultas nos bancos de dados do SQL Azure é o mesmo que escrever consultas nos bancos de dados do SQL Server. Algumas instruções Transact-SQL, como BACKUP, não têm suporte no SQL Azure, mas elas não são usadas em consultas de relatório. Para obter mais informações, consulte Tipo de conexão do SQL Server (SSRS).

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.

O designer de consultas com base em texto oferece aos dois modos a seguir:

  • Texto   Digite os comandos do Transact-SQL que selecionam dados da fonte de dados.

  • Procedimento armazenado   Escolha em uma lista de procedimentos armazenados.

Para obter mais informações, consulte Interface de usuário do Designer de Consulta relacional (Construtor de Relatórios 3.0) e Interface de usuário do Designer de Consulta com base em texto (Construtor de Relatórios 3.0).

Dependendo da complexidade de uma consulta e dos dados que ela retorna, a consulta pode demorar muito para ser concluída. Nesta versão do SQL Azure, são fechadas conexões ociosas e consultas que levam muito tempo para serem executadas depois de cinco minutos. Haverá falhas nas consultas que requerem mais que cinco minutos para serem concluídas. Recomenda-se que você crie consultas de relatório que sejam o mais eficientes possível ao obter dados de relatório do SQL Azure.

O designer de consultas gráficas usado pelo SQL Azure fornece suporte interno ao agrupamento e às agregações para ajudar a escrever consultas que só recuperam dados resumidos. Os recursos de linguagem do Transact-SQL são: a cláusula GROUP BY, a palavra-chave DISTINCT e agregações, como SUM e COUNT. O designer de consulta baseado em texto dá todo o suporte para a linguagem do Transact-SQL, inclusive para agrupamentos e agregações. Para obter mais informações sobre Transact-SQL, consulte Referência do Transact-SQL (Mecanismo de Banco de Dados) nos Manuais Online do SQL Server em msdn.microsoft.com.

Usando o tipo de consulta Text

No designer de consulta baseado em texto, você digita 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 posteriormente neste tópico.

Ícone de seta usado com o link Voltar ao InícioVoltar 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 posteriormente 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 sobre procedimentos armazenados, consulte "Procedimentos armazenados (mecanismo de banco de dados)" nos Manuais Online do SQL Server em msdn.microsoft.com.

Ícone de seta usado com o link Voltar ao InícioVoltar 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)

Por padrão, cada parâmetro de relatório tem o tipo de dados Texto e um conjunto de dados criado automaticamente para fornecer uma lista suspensa dos valores disponíveis. Depois que os parâmetros de relatório forem criados, talvez seja necessário alterar os valores padrão. Para obter mais informações, consulte Parâmetros (Report Builder 3.0 e SSRS).

Ícone de seta usado com o link Voltar ao InícioVoltar ao início

Comentários

Extensões de dados alternativas

Também é possível recuperar dados de um banco de dados do SQL Server usando um tipo de fonte de dados ODBC. Não há suporte para a conexão ao Banco de dados SQL Azure com o uso do OLE DB.

Para obter mais informações, consulte Tipo de conexão de 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.

Ícone de seta usado com o link Voltar ao InícioVoltar 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.

Ícone de seta usado com o link Voltar ao InícioVoltar ao Início