sys.sp_changelogreader_agent (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

Altera as propriedades de segurança de um agente Leitor de Log. Este procedimento armazenado é executado no Publisher no banco de dados de publicação.

Importante

Ao configurar um Publisher com um Distribuidor remoto, os valores fornecidos para todos os parâmetros, incluindo @job_login e @job_password, são enviados ao Distribuidor em texto simples. Deve encriptar a ligação entre o Publisher e o seu Distribuidor remoto antes de executar este procedimento armazenado. Para obter mais informações, consulte Configurar o Mecanismo de Banco de Dados do SQL Server para criptografar conexões.

Syntax

sys.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' ]
    [ , [ @job_security_mode = ] job_security_mode ]
[ ; ]

Arguments

[ @job_login = ] N'job_login'

O login da conta com a qual o agente opera. @job_login é nvarchar(257), com um padrão de NULL. No Azure SQL Managed Instance, use uma conta SQL Server.

Note

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

[ @job_password = ] N'job_password'

A palavra-passe da conta com a qual o agente opera. @job_password é sysname, com um padrão de NULL.

Importante

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

[ @publisher_security_mode = ] publisher_security_mode

O modo de segurança usado pelo agente ao ligar-se ao Publisher. @publisher_security_mode é smallint, com um padrão de NULL. Os seguintes valores definem o modo de segurança:

  • 0 especifica autenticação SQL Server.
  • 1 especifica autenticação do Windows.
  • 2especifica autenticação por palavra-passe Microsoft Entra, começando com SQL Server 2022 (16.x) 6.
  • 3especifica autenticação integrada Microsoft Entra, começando com SQL Server 2022 (16.x) 6.
  • 4especifica autenticação de token Microsoft Entra, a partir do SQL Server 2022 (16.x) 6.

Importante

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

[ @publisher_login = ] N'publisher_login'

O login usado ao ligar-se ao Publisher. @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, então a conta Windows especificada em @job_login é usada ao ligar à Publisher.

[ @publisher_password = ] N'publisher_password'

A palavra-passe usada ao ligar-se ao Publisher. @publisher_password é sysname, com um padrão de NULL.

Importante

Não utilize uma palavra-passe em branco. Use uma senha forte. Quando possível, solicite que os usuários insiram credenciais de segurança em tempo de execução. Se você precisar armazenar credenciais em um arquivo de script, deverá proteger o arquivo para impedir o acesso não autorizado.

@publisher [ = ] N'editor'

O nome do Editor. @publisher é sysname, com um padrão de NULL. Este parâmetro é suportado apenas para editores que não são SQL Server.

[ @job_security_mode = ] job_security_mode

Identificado apenas para fins informativos. Não suportado. A compatibilidade futura não é garantida.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

sp_changelogreader_agent é usado na replicação transacional.

sp_changelogreader_agenté usado para alterar a conta Windows sob a qual um agente do Leitor de Registo é executado. Pode alterar a palavra-passe de um login Windows existente ou fornecer um novo login e palavra-passe do Windows.

Após alterar o login ou a palavra-passe do agente, deve parar e reiniciar o agente antes que a alteração entre em vigor.

Permissions

Apenas os membros do papel de servidor fixo de sysadmin ou do papel de base de dados fixa db_owner podem executar sp_changelogreader_agent.

Conteúdo relacionado

  • Last updated on