Criar cadeias de conexão de dados no Report Builder

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

Para incluir dados no Construtor de Relatórios e repositórios paginados do Reporting Services, primeiro você deve criar uma cadeia de conexão para a fonte de dados. Este artigo explica como criar cadeias de conexão de dados e fornece informações importantes sobre 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 necessários. Para obter mais informações, consulte 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 oferece suporte, consulte 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, veja Configurar protocolos de cliente.

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 sua fonte de dados ODBC ou SQL com uma senha, poderá encontrar erros com caracteres especiais. Se um usuário digitar a senha com caracteres especiais, como sinais de pontuação, alguns drivers de fonte de dados subjacentes não poderão validar esses 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, consulte 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 é uma cadeia de conexão que não é definida por meio de uma expressão. Por exemplo, ao seguir as etapas para criar uma fonte de dados compartilhada ou específica de relatório, você está definindo uma cadeia de conexão estática. O uso de uma cadeia de conexão estática permite conectar à fonte de dados no Report Designer para 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 ou definir uma consulta que recupere uma lista de fontes de dados em tempo de execução. Nesse caso, a lista estática de valores disponíveis deve ser fontes de dados que você pode usar com o relatório.

• 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 Report Designer. Além disso, a lista de campos no painel Dados do Relatório e a lista Parâmetros não serão atualizadas automaticamente.

Conteúdo relacionado

• Introdução a dados de relatório no SSRS (SQL Server Reporting Services)
• Criar e modificar fontes de dados compartilhadas
• Criar e modificar fontes de dados integradas

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