sp_changelogreader_agent (Transact-SQL)

Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure

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

Importante

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, confira Habilitar conexões criptografadas para o 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 login da conta sob a qual o agente é executado. job_login é nvarchar(257), com um padrão de NULL. Na Instância Gerenciada SQL do Azure, use uma conta do SQL Server. Isso não pode ser alterado para um editor que não seja do Microsoft SQL Server .

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

Importante

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

Observação

A ID do Microsoft Entra era anteriormente conhecida como Azure Active Directory (Azure AD).

É o modo de segurança usado pelo agente ao conectar-se ao Publicador. publisher_security_mode é smallint, com um padrão de NULL. Os seguintes valores definem o modo de segurança:

• 0 especifica a Autenticação do SQL Server.
• 1 especifica a autenticação do Windows.
• 2 especifica a autenticação de senha do Microsoft Entra a partir do SQL Server 2022 (16.x) 6.
• 3 especifica a autenticação integrada do Microsoft Entra a partir do SQL Server 2022 (16.x) 6.
• 4 especifica a autenticação de token do Microsoft Entra a partir do SQL Server 2022 (16.x) 6.

Importante

Quando possível, use a autenticação do Windows.

[ @publisher_login = ] 'publisher_login' É o login usado ao se conectar ao 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, a conta do Windows especificada em job_login será usada ao se conectar ao Publicador.

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

Importante

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 Editor. publisher é sysname, com um padrão de NULL. Esse parâmetro só tem suporte para Editores não SQL Server.

Valores do código de retorno

0 (sucesso) ou 1 (fracasso)

Comentários

sp_changelogreader_agent é usado na replicação transacional.

sp_changelogreader_agent é usado para alterar a conta do Windows sob a qual um agente do Leitor de Log é 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.

Confira também

Exibir e modificar configurações de segurança de replicação
sp_helplogreader_agent (Transact-SQL)
sp_addlogreader_agent (Transact-SQL)