sp_changelogreader_agent (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Instâ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

Ao configurar um Publicador com um Distribuidor remoto, os valores fornecidos para todos os parâmetros, incluindo @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 Configurar o Mecanismo de Banco de Dados do SQL Server para criptografia de conexões.

Sintaxe

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

Argumentos

@job_login [ = ] N'job_login'

O logon da conta na qual o agente é executado. @job_login é nvarchar(257), com um padrão de NULL. Na Instância Gerenciada de SQL do Azure, use uma conta do SQL Server.

Observação

Isso não pode ser alterado para um editor que não seja do SQL Server.

@job_password [ = ] N'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

O modo de segurança usado pelo agente ao se conectar 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, começando com SQL Server 2022 (16.x) 6.
  • 3 especifica a autenticação integrada do Microsoft Entra, começando com SQL Server 2022 (16.x) 6.
  • 4 especifica a autenticação de token do Microsoft Entra, começando com SQL Server 2022 (16.x) 6.

Importante

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

@publisher_login [ = ] N'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 é 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 [ = ] N'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 [ = ] N'editor'

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 (falha).

Comentários

sp_changelogreader_agent é usado na replicação transacional.

sp_changelogreader_agent é usado para alterar a conta do Windows na 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_agento .

Conteúdo relacionado