Método ConfigurationSetting – SetDatabaseConnection

  • Artigo

Define a conexão do banco de dados do servidor de relatório para um banco de dados do servidor de relatório específico.

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

Servidor
O nome da instância do SQL Server usada para hospedar o banco de dados do servidor de relatório.

DatabaseName
O nome do banco de dados do servidor de relatório.

CredentialsType
O tipo de credenciais a ser usada para a conexão. Os valores podem ser:

  • 0 - Windows

  • 1 - SQL Server

  • 2 - Serviço do Windows

UserName
O nome de conta usada para se conectar ao banco de dados do servidor de relatório.

Senha
A senha usada para se conectar ao banco de dados do servidor de relatório.

HRESULT
[out] Valor que indica se a chamada obteve êxito ou falhou.

Valor retornado

Retorna um HRESULT indicando êxito ou falha da chamada do método. Um valor 0 indica que a chamada do método teve êxito. Um valor diferente de zero indica que ocorreu um erro.

Comentários

Quando o parâmetro CredentialsType for definido como 0 (Windows), os parâmetros UserName e Password devem ser definidos. O parâmetro UserName deve estar no formato domain\username, e o valor deve representar um login válido do Windows.

Quando o parâmetro CredentialsType é definido como 1 (SQL Server), o valor passado no parâmetro UserName precisa estar em conformidade com os requisitos de um nome de logon do SQL Server.

Quando o parâmetro CredentialsType é definido como 2 (serviço Windows), o servidor de relatório usa a segurança integrada para se conectar ao banco de dados do servidor de relatório, e os parâmetros UserName e Password são ignorados. O serviço Web Servidor de Relatórios usa a conta ASP.NET ou uma conta do pool de aplicativos e a conta de serviço Windows para acessar o banco de dados do servidor de relatório.

Quando chamado, o método SetDatabaseConnection criptografa e armazena as credenciais e informações do banco de dados no arquivo de configuração para o servidor de relatório especificado.

O método SetDatabaseConnection não verifica se o servidor de relatório pode se conectar ao banco de dados do servidor de relatório usando os dados especificados.

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

O método SetDatabaseConnection não concede permissões para as contas especificadas. Você deve chamar o método GenerateDatabaseRightsScript para cada conta que requer acesso ao banco de dados do servidor de relatório e executar o script resultante.

Requisitos

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

Conteúdo relacionado