Criar cadeias de ligação de dados no Construtor de Relatórios

Aplica-se a: SQL Server 2016 (13.x) Serviços de Relatórios e versões posteriores Power BI Report Server SharePoint

Para incluir dados nos relatórios paginados do Construtor de Relatórios e dos Serviços de Relatórios, deve primeiro criar uma cadeia de ligação à sua fonte de dados. Este artigo explica como criar cadeias de ligação de dados e fornece informações importantes relacionadas com credenciais de fontes de dados. Uma fonte de dados inclui o tipo de fonte de dados, a informação de ligação e o tipo de credenciais necessárias. Para mais informações, consulte Introdução aos dados de reporte em SQL Server Reporting Services (SSRS).

Extensões de dados incorporadas

As extensões de dados padrão nos Serviços de Relatórios incluem Microsoft SQL Server, Microsoft Azure SQL Database e Microsoft SQL Server Analysis Services. Para uma lista completa de fontes de dados e versões suportadas pelos Serviços de Relatório, consulte Fontes de Dados suportadas pelos Serviços de Relatórios (SSRS).

Exemplos comuns de cadeias de conexão

As cadeias de conexão são a representação em texto das propriedades de conexão de um provedor de dados. A tabela seguinte lista exemplos de cadeias de ligações para vários tipos de ligação de dados.

Se não conseguir ligar-se a um servidor de relatórios usando localhost, certifique-se de que o protocolo de rede para o protocolo TCP/IP está ativado. Para mais informações, consulte Configurar protocolos cliente.

Para mais informações sobre as configurações necessárias para se ligar a estes tipos de fontes de dados, consulte o artigo específico sobre ligação de dados em Adicionar dados de fontes de dados externas (SSRS) ou Fontes de dados suportadas pelos Serviços de Relatórios (SSRS).

Caracteres especiais numa palavra-passe

Se configurar a sua fonte de dados ODBC ou SQL com uma palavra-passe, pode encontrar erros com caracteres especiais. Se um utilizador introduzir a palavra-passe com caracteres especiais como sinais de pontuação, alguns drivers de fonte de dados subjacentes não conseguem validar esses caracteres especiais. Quando processa o relatório, a mensagem "Não é uma palavra-passe válida" pode indicar este problema. Se alterar a palavra-passe for impraticável, pode trabalhar com o administrador da base de dados para armazenar as credenciais apropriadas no servidor como parte do nome de origem de dados ODBC (DSN) do sistema. Para mais informações, consulte OdbcConnection.ConnectionString na documentação do .NET Framework.

Cadeias de conexão baseadas em expressão

As cadeias de ligação baseadas em expressões são avaliadas em tempo de execução. Por exemplo, pode especificar a fonte de dados como parâmetro, incluir a referência do parâmetro na cadeia de ligação e permitir que o utilizador escolha uma 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 ligação baseada em expressões, um utilizador que executa um relatório de vendas pode selecionar uma fonte de dados para um país/região específica antes de executar o relatório.

O exemplo seguinte ilustra a utilização de uma expressão de fonte de dados numa cadeia de ligação SQL Server. O exemplo assume que criou um parâmetro de relatório chamado ServerName:

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

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

• Projete o relatório usando uma cadeia de ligação estática. Uma cadeia de ligação estática é uma cadeia de ligação que não é definida através de uma expressão. Por exemplo, ao seguir os passos para criar uma fonte de dados específica ou partilhada para um relatório, está a definir uma cadeia de ligação estática. Usar uma cadeia de ligação estática permite-lhe ligar à fonte de dados no Report Designer para obter os resultados da consulta necessária para criar o relatório.

• Ao definir a ligação da fonte de dados, não use uma fonte de dados partilhada. Não podes usar uma expressão de fonte de dados numa fonte de dados partilhada. Deve definir uma fonte de dados embutida para o relatório.

• Especifique as credenciais separadamente da cadeia de ligação. Pode usar credenciais armazenadas, credenciais solicitadas ou segurança integrada.

• Adicione um parâmetro de relatório para especificar uma fonte de dados. Para valores de parâmetro, 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. Neste caso, a lista estática de valores disponíveis deve ser composta por fontes de dados que pode usar com o relatório.

• Certifique-se de que a lista de fontes de dados partilha o mesmo esquema de base de dados. Todo o desenho de relatórios começa com a informação do 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 pode não ser executado.

• Antes de publicar o relatório, substitua a cadeia de ligação estática por uma expressão. Espere até terminar de desenhar o relatório antes de substituir a cadeia de ligação estática por uma expressão. Depois de usar uma expressão, não pode executar a consulta no Designer de Relatórios. Além disso, a lista de campos no painel de Dados de Relatório e a lista de Parâmetros não são atualizadas automaticamente.

Conteúdo relacionado

• Introdução aos dados de relatórios no SQL Server Reporting Services (SSRS)
• Criar e modificar fontes de dados partilhadas
• Criar e modificar fontes de dados embutidas
• Fórum dos Serviços de Relatórios