sp_changelogreader_agent (Transact-SQL)

Altera as propriedades de segurança de um agente Log Reader. Esse procedimento armazenado é executado no Publicador, no banco de dados publicador.

Observação sobre segurança

Quando um Publicador é configurado com um Distribuidor remoto, os valores fornecidos para todos os parâmetros, inclusive job_login e job_password, são enviados ao Distribuidor como texto sem-formatação. Você deve criptografar a conexão entre o Publicador e seu Distribuidor remoto antes de executar esse procedimento armazenado. Para obter mais informações, consulte Habilitar conexões criptografadas no Mecanismo de Banco de Dados (SQL Server Configuration Manager).

Sintaxe

sp_changelogreader_agent [ [ @job_login = ] 'job_login' ]
    [ , [ @job_password = ] 'job_password' ]
    [ , [ @publisher_security_mode = ] publisher_security_mode ]
    [ , [ @publisher_login = ] 'publisher_login' ]
    [ , [ @publisher_password = ] 'publisher_password' ] 
    [ , [ @publisher = ] 'publisher' ]

Argumentos

• [ @job_login= ] 'job_login'
  É o logon da conta do Windows na qual o agente é executado. job_login é nvarchar(257), com um padrão de NULL. Isso não pode ser alterado para um publicador que não seja do Microsoft SQL Server.

• [ @job_password= ] 'job_password'
  É a senha da conta do Microsoft Windows na qual o agente é executado. job_password é sysname, com um padrão de NULL.

  Observação sobre segurança
  Quando possível, solicite que os usuários insiram as credenciais de segurança em tempo de execução. Se for necessário armazenar credenciais em um arquivo de script, você deverá proteger o arquivo para impedir acesso não autorizado.

• [ @publisher_security_mode= ] publisher_security_mode
  É o modo de segurança usado pelo agente ao conectar-se ao Publicador. publisher_security_mode é smallint, com um padrão de NULL. 0 especifica Autenticação do SQL Server e 1 especifica Autenticação do Windows.

  Observação sobre segurança
  Quando possível, use a Autenticação do Windows.

• [ @publisher_login= ] 'publisher_login'
  É o logon usado na conexão com o Publicador. publisher_login é sysname, com um padrão de NULL. publisher_login deve ser especificado quando publisher_security_mode for 0. Se publisher_login for NULL e publisher_security_mode for 1, então a conta Windows especificada em job_login será usada na conexão com o Publicador.

• [ @publisher_password= ] 'publisher_password'
  É a senha usada ao conectar-se ao Publicador. publisher_password é sysname, com um padrão de NULL.

  Observação sobre segurança
  Não use uma senha em branco. Use uma senha forte. Quando possível, solicite que os usuários insiram as credenciais de segurança em tempo de execução. Se for necessário armazenar credenciais em um arquivo de script, você deverá proteger o arquivo para impedir acesso não autorizado.

• [ @publisher= ] 'publisher'
  É o nome do Publicador. publisher é sysname, com um padrão de NULL. Esse parâmetro só tem suporte para Editores não SQL Server.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_changelogreader_agent é usado em replicação transacional.

sp_changelogreader_agent é usado para alterar a conta do Windows na qual um agente Log Reader é executado. Você pode alterar a senha de um logon de Windows existente ou pode fornecer um logon e uma senha de Windows novos.

Depois de alterar o logon ou a senha de um agente, você deve parar e reiniciar o agente antes que as alterações entrem em vigor.

Permissões

Somente membros da função de servidor fixa sysadmin ou da função de banco de dados fixa db_owner podem executar sp_changelogreader_agent.

Consulte também

Referência

sp_helplogreader_agent (Transact-SQL)

sp_addlogreader_agent (Transact-SQL)

Conceitos

Exibir e modificar configurações de segurança de replicação