Criar cadeias de conexão de dados – Construtor de Relatórios e SSRS

Aplica-se a: SQL Server 2016 (13.x) Reporting Services e posterior Servidor de Relatórios do Power BI SharePoint

Para incluir dados no --- title: include file description: include file author: maggiesMSFT ms.author: maggies ms.date: 12/06/2018 ms.service: ms.topic: include ms.custom: include fileReport Builder e relatórios paginados do Reporting Services, você deve primeiro criar uma cadeia de conexão para sua fonte de dados. Este artigo explica como criar cadeias de conexão de dados e tem informações importantes sobre as credenciais de fonte de dados. Uma fonte de dados inclui o tipo da fonte de dados, informações da conexão e o tipo de credenciais a serem usadas. Para saber mais detalhes, confira Introdução aos dados de relatório no SSRS (SQL Server Reporting Services).

Extensões de dados internas

As extensões de dados padrão no Reporting Services incluem Microsoft SQL Server, Banco de Dados SQL do Microsoft Azure e Microsoft SQL Server Analysis Services. Para obter uma lista completa de fontes de dados e versões aos quais o Reporting Services dá suporte, confira Fontes de dados com suporte no Reporting Services (SSRS).

Exemplos comuns de cadeia de conexão

Cadeias de conexão são a representação de texto de propriedades de conexão para um provedor de dados. A tabela a seguir lista exemplos de cadeias de conexão para vários tipos de conexão de dados.

Se não for possível conectar a um servidor de relatório que use localhost, verifique se o protocolo de rede TCP/IP está habilitado. Para obter mais informações, consulte Configure Client Protocols.

Para saber mais sobre as configurações necessárias para se conectar a esses tipos de fonte de dados, confira o artigo de conexão de dados específicos em Adicionar dados de fontes de dados externas (SSRS) ou Fontes de dados compatíveis com o Reporting Services (SSRS).

Caracteres especiais em uma senha

Se você configurar a fonte de dados ODBC ou SQL para solicitar uma senha ou para incluir uma senha na cadeia de conexão e o usuário inserir a senha com caracteres especiais, como sinais de pontuação, alguns drivers de fonte de dados subjacentes não conseguirão validar os caracteres especiais. Quando você processar o relatório, a mensagem "Senha inválida" poderá indicar esse problema. Se não for possível alterar a senha, você poderá trabalhar com o administrador do banco de dados para armazenar as credenciais apropriadas no servidor como parte de um DSN (nome da fonte de dados) do sistema ODBC. Para obter mais informações, confira OdbcConnection.ConnectionString" na documentação do .NET Framework.

Cadeias de conexão baseadas em expressão

Cadeias de conexão baseadas em expressão são avaliadas em tempo de execução. Por exemplo, você pode especificar a fonte de dados como um parâmetro, incluir a referência ao parâmetro na cadeia de conexão e permitir que o usuário escolha a fonte de dados para o relatório. Por exemplo, suponha que uma empresa multinacional tem servidores de dados em vários países/regiões. Com uma cadeia de conexão baseada em expressão, um usuário que está executando um relatório de vendas pode selecionar uma fonte de dados para um país/região específico antes de executar o relatório.

O exemplo a seguir ilustra o uso de uma expressão de fonte de dados em uma cadeia de conexão do SQL Server. O exemplo assume que você criou um parâmetro de relatório denominado ServerName:

="Data Source=" & Parameters!ServerName.Value & "; Initial Catalog=AdventureWorks"  

Expressões de fonte de dados são processadas em tempo de execução ou quando um relatório é visualizado. A expressão deve ser escrita no Visual Basic. Use as seguintes diretrizes ao definir uma expressão de fonte de dados:

• Crie o relatório usando uma cadeia de conexão estática. Uma cadeia de conexão estática faz referência a uma cadeia de conexão que não é definida através de uma expressão (por exemplo, quando você segue as etapas para criar uma fonte de dados específica ao relatório ou compartilhada, você está definindo um cadeia de conexão estática. O uso de uma cadeia de conexão estática permite conectar à fonte de dados no Designer de Relatórios de forma que você possa obter os resultados da consulta necessários para criar o relatório.

• Ao definir a conexão da fonte de dados, não use uma fonte de dados compartilhada. Não é possível usar uma expressão de fonte de dados em uma fonte de dados compartilhada. Você deve definir uma fonte de dados inserida para o relatório.

• Especifique credenciais separadamente da cadeia de conexão. É possível usar credenciais armazenadas, credenciais solicitadas ou segurança integrada.

• Adicione um parâmetro de relatório para especificar uma fonte de dados. Para os valores dos parâmetros, você pode fornecer uma lista estática de valores disponíveis (neste caso, os valores disponíveis devem ser fontes de dados usadas com o relatório) ou definir uma consulta que recupere uma lista de fontes de dados em tempo de execução.

• Verifique se a lista de fontes de dados compartilha o mesmo esquema de banco de dados. Todo design de relatório começa com informações de esquema. Se houver uma incompatibilidade entre o esquema usado para definir o relatório e o esquema real usado pelo relatório em tempo de execução, o relatório poderá não ser executado.

• Antes de publicar o relatório, substitua a cadeia de conexão estática por uma expressão. Espere até a conclusão do design do relatório para substituir a cadeia de conexão estática por uma expressão. Ao usar uma expressão, você não pode executar a consulta no Designer de Relatórios. Além disso, a lista de campos no painel de dados do relatório e a lista de Parâmetros não serão atualizadas automaticamente.

Próximas etapas

Introdução aos dados de relatório no SSRS (SQL Server Reporting Services)Criar e modificar fontes de dados compartilhadas
Criar e modificar fontes de dados inseridas
Definir propriedades de implantação
Especificar informações de credenciais e de conexão para fontes de dados de relatório

Mais perguntas? Experimente perguntar no fórum do Reporting Services