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.

Observação

Connectionstrings.com é outro recurso para obter exemplos de cadeias de conexão.

Fonte de dados Exemplo Descrição
Banco de dados do SQL Server no servidor local Data Source="(local)"; Initial Catalog=AdventureWorks Defina o tipo de fonte de dados como Microsoft SQL Server. Para obter mais informações, consulte Tipo de conexão do SQL Server (SSRS).
Instância nomeada do SQL Server Data Source=<host>\MSSQL13.<InstanceName>; Initial Catalog=AdventureWorks Defina o tipo de fonte de dados como Microsoft SQL Server. Para obter mais informações, consulte Tipo de conexão do SQL Server (SSRS).
Banco de Dados SQL do Azure Data Source=<host>.database.windows.net; Initial Catalog=AdventureWorks; Encrypt=True Defina o tipo de fonte de dados como Banco de Dados SQL do Microsoft Azure. Para obter mais informações, consulte Tipo de conexão do SQL do Azure (SSRS).
SQL Server Parallel Data Warehouse HOST=<IP address>; database=AdventureWorks; port=<port> Defina o tipo de fonte de dados como Microsoft SQL Server Parallel Data Warehouse. Para obter mais informações, consulte Tipo de conexão do SQL Server Parallel Data Warehouse (SSRS).
Banco de dados do Analysis Services no servidor local Data Source=localhost; Initial Catalog=Adventure Works DW Defina o tipo de fonte de dados como Microsoft SQL Server Analysis Services. Para obter mais informações, consulte Tipo de conexão do Analysis Services para MDX (SSRS) ou Tipo de conexão do Analysis Services para DMX (SSRS).
Banco de dados modelo de tabela do Analysis Services com perspectiva de vendas Data Source=<servername>; Initial Catalog=Adventure Works DW; cube='Sales' Defina o tipo de fonte de dados como Microsoft SQL Server Analysis Services. Especifique o nome da perspectiva na configuração cube=. Para obter mais informações, consulte Perspectivas em modelos tabulares.
Azure Analysis Services Data Source=asazure://aspaaseastus2.asazure.windows.net/<server name>; Initial Catalog=AdventureWorks Defina o tipo de fonte de dados como Microsoft SQL Server Analysis Services. Para obter mais informações, consulte Extensão de processamento de dados do Microsoft SQL Server Analysis Services.
Servidor do Oracle Data Source=<host> Defina o tipo de fonte de dados como Oracle. As ferramentas do cliente Oracle devem estar instaladas no computador de Designer de Relatórios e no servidor de relatório. Para obter mais informações, consulte o Tipo de Conexão Oracle (SSRS e Servidor de Relatórios do Power BI).
Fonte de dados do SAP NetWeaver BI Data Source=https://mySAPNetWeaverBIServer:8000/sap/bw/xml/soap/xmla Defina o tipo de fonte de dados como SAP NetWeaver Bl. Para obter mais informações, consulte Tipo de conexão SAP NetWeaver BI (SSRS).
Fonte de dados do Hyperion Essbase Data Source=https://localhost:13080/aps/XMLA; Initial Catalog=Sample Defina o tipo de fonte de dados como Hyperion Essbase. Para obter mais informações, confira Tipo de conexão Hyperion Essbase (SSRS).
Fonte de dados do Teradata Data Source=<NNN>.<NNN>.<NNN>.<NNN>; Defina o tipo de fonte de dados como Teradata. A cadeia de conexão é um endereço IP no formulário de quatro campos, em que cada campo pode ter de um a três dígitos. Para obter mais informações, confira Tipo de conexão Teradata (SSRS).
Fonte de dados do Teradata Database=<database name>; Data Source=<NNN>.<NNN>.<NNN>.<NNN>; Use X Views=False; Restrict to Default Database=True Defina o tipo de fonte de dados como Teradata, semelhante ao exemplo anterior. Use apenas o banco de dados padrão especificado na marca Database e não descubra automaticamente relações de dados.
Fonte de dados XML, serviço Web data source=https://adventure-works.com/results.aspx Defina o tipo de fonte de dados como XML. A cadeia de conexão é uma URL para um serviço Web com suporte para WSDL. Para obter mais informações, confira Tipo de conexão XML (SSRS).
Fonte de dados XML, documento XML https://localhost/XML/Customers.xml Defina o tipo de fonte de dados como XML. A cadeia de conexão é uma URL para o documento XML.
Fonte de dados XML, documento XML inserido Empty (vazio) Defina o tipo de fonte de dados como XML. Os dados XML são inseridos na definição do relatório.
Lista do SharePoint Data Source=https://MySharePointWeb/MySharePointSite/ Definir o tipo de fonte de dados como lista do SharePoint.
Conjunto de dados do Power BI Premium (começando com o Reporting Services 2019 e o Servidor de Relatórios do Power BI de janeiro de 2020) Data Source=powerbi://api.powerbi.com/v1.0/myorg/<workspacename>; Initial Catalog=<datasetname> Defina o tipo de fonte de dados como Microsoft SQL Server Analysis Services.

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.

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