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 de publicação.

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. Criptografe a conexão entre o Publicador e seu Distribuidor remoto antes de executar esse procedimento armazenado. Para obter mais informações, consulte Criptografando conexões com o SQL Server.

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 para a conta do Windows em que o agente é executado. job_login é nvarchar(257), com um padrão NULL. Isso não pode ser alterado para um editor não-Microsoft SQL Server*.*

• [ @job_password= ] 'job_password'
  É a senha para a conta Microsoft Windows na qual o agente é executado. job_password é sysname, com um padrão 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 evitar acesso não autorizado.

• [ @publisher_security_mode= ] publisher_security_mode
  É o modo de segurança usado pelo agente ao se conectar ao Publicador. publisher_security_mode é smallint, com um padrão 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 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 na conexão com o Publicador. publisher_password é sysname, com um padrão 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 evitar acesso não autorizado.

• [ @publisher= ] 'publisher'
  É o nome do Publicador. publisher é sysname, com um padrão NULL. Esse parâmetro só tem suporte para Publicadores 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 do Windows novos.

Depois de alterar o logon ou a senha de um agente, você deve parar e reiniciar o agente para que a alteração entre 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

Tarefas

Como exibir e modificar propriedades de segurança de replicação (Programação Transact-SQL de replicação)

Referência

sp_helplogreader_agent (Transact-SQL)

sp_addlogreader_agent (Transact-SQL)