Partilhar via

Método ConfigurationSetting - SetDatabaseConnection

Define a ligação da base de dados do servidor de relatórios a uma base de dados específica do servidor de relatórios.

Sintaxe

Public Sub SetDatabaseConnection(Server as String, _  
    DatabaseName as string, CredentialsType as Integer, _  
    Username as String, Password as String, ByRef HRESULT as Int32)  

public void SetDatabaseConnection(string Server,   
    string DatabaseName, Int32 CredentialsType,   
    string UserName, string Password, out Int32 HRESULT);

Parâmetros

Server
O nome da instância do SQL Server usada para alojar a base de dados do servidor de relatórios.

DatabaseName
O nome da base de dados do servidor de relatórios.

CredentialsType
O tipo de credenciais a usar para a ligação. Os valores podem ser:

  • 0 - Windows

  • 1 - SQL Server

  • 2 - Serviço Windows

UserName
O nome da conta é usado para se ligar à base de dados do servidor de relatórios.

Senha
A palavra-passe usada para se ligar à base de dados do servidor de relatórios.

HRESULT
[fora] Valor que indica se a chamada teve sucesso ou falhou.

Valor de retorno

Devolve um HRESULT indicando sucesso ou falha da chamada ao método. Um valor de 0 indica que a chamada ao método foi bem-sucedida. Um valor não nulo indica que ocorreu um erro.

Observações

Quando o parâmetro CredentialsType está definido para 0 (Windows), os parâmetros de Nome de Utilizador e Palavra-passe devem ser definidos. O parâmetro UserName deve estar no formulário domain\username, e o valor deve representar um login válido do Windows.

Quando o parâmetro CredentialsType é definido para 1 (SQL Server), o valor passado no parâmetro UserName deve cumprir os requisitos de um nome de login do SQL Server.

Quando o parâmetro CredentialsType é definido para 2 (Serviço Windows), o servidor de relatórios utiliza segurança integrada para se ligar à base de dados do servidor de relatórios, e os parâmetros de Nome de Utilizador e Palavra-passe são ignorados. O serviço Web do Servidor de Relatórios utiliza a conta ASP.NET ou a conta de um pool de aplicações e a conta do serviço Windows para aceder à base de dados do servidor de relatórios.

Quando chamado, o método SetDatabaseConnection encripta e armazena as credenciais e a informação da base de dados no ficheiro de configuração do servidor de relatórios especificado.

O método SetDatabaseConnection não verifica se o servidor de relatórios consegue ligar-se à base de dados do servidor de relatórios usando os dados especificados.

Quando definido pela primeira vez, a propriedade ConnectionPoolSize é definida com base nos seguintes processadores: ConnectionPoolSize = #Processors * 75.

O método SetDatabaseConnection não concede permissões a(s) conta(s) especificada(s). Deve chamar o método GenerateDatabaseRightsScript para cada conta que requer acesso à base de dados do servidor de relatórios e executar o script resultante.

Requerimentos

namespace:root\Microsoft\SqlServer\ReportServer\<InstanceName>\v13\Admin

Conteúdo relacionado

  • Last updated on