sys.sp_changelogreader_agent (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Verandert de beveiligingseigenschappen van een Log Reader-agent. Deze opgeslagen procedure wordt uitgevoerd bij Publisher in de publicatiedatabase.

Important

Bij het configureren van een Publisher met een externe Distributor worden de waarden die voor alle parameters, inclusief @job_login en @job_password, als platte tekst naar de Distributor gestuurd. Versleutel de verbinding tussen publisher en de externe distributeur voordat u deze opgeslagen procedure uitvoert. Zie SQL Server Database Engine configureren voor het versleutelen van verbindingenvoor meer informatie.

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'

De login voor het account waaronder de agent werkt. @job_login is nvarchar(257), met een standaard van NULL. Op Azure SQL Managed Instance gebruik je een SQL Server-account.

Note

Dit kan niet worden aangepast voor een niet-SQL Server uitgever.

[ @job_password = ] N'job_password'

Het wachtwoord van het account waaronder de agent werkt. @job_password is systeemnaam, met als standaard .NULL

Important

Indien mogelijk vraagt u gebruikers om beveiligingsreferenties in te voeren tijdens runtime. Als u referenties in een scriptbestand moet opslaan, moet u het bestand beveiligen om onbevoegde toegang te voorkomen.

[ @publisher_security_mode = ] publisher_security_mode

De beveiligingsmodus die de agent gebruikt bij het verbinden met de Publisher. @publisher_security_mode is smallint, met een standaard van NULL. De volgende waarden definiëren de beveiligingsmodus:

  • 0 specificeert SQL Server-authenticatie.
  • 1 specificeert Windows-authenticatie.
  • 2specificeert Microsoft Entra-wachtwoordauthenticatie, beginnend met SQL Server 2022 (16.x) CU 6.
  • 3specificeert Microsoft Entra geïntegreerde authenticatie, beginnend met SQL Server 2022 (16.x) CU 6.
  • 4specificeert Microsoft Entra tokenauthenticatie, beginnend met SQL Server 2022 (16.x) CU 6.

Important

Gebruik waar mogelijk Windows-verificatie.

[ @publisher_login = ] N'publisher_login'

De login die wordt gebruikt bij het verbinden met de Publisher. @publisher_login is een systeemnaam, met als standaard .NULL @publisher_login moet worden gespecificeerd wanneer @publisher_security_mode is 0. Als @publisher_login is NULL en @publisher_security_mode is 1, dan wordt het Windows account dat in @job_login is gespecificeerd gebruikt bij het verbinden met de Publisher.

[ @publisher_password = ] N'publisher_password'

Het wachtwoord dat wordt gebruikt bij het verbinden met de uitgever. @publisher_password is een systeemnaam, met als standaard NULL.

Important

Gebruik geen leeg wachtwoord. Gebruik een sterk wachtwoord. Indien mogelijk vraagt u gebruikers om beveiligingsreferenties in te voeren tijdens runtime. Als u referenties in een scriptbestand moet opslaan, moet u het bestand beveiligen om onbevoegde toegang te voorkomen.

[ @publisher = ] N'uitgever'

De naam van de uitgever. @publisher is sysname, met als standaard NULL. Deze parameter wordt alleen ondersteund voor niet-SQL Server Publishers.

[ @job_security_mode = ] job_security_mode

Alleen ter informatie geïdentificeerd. Wordt niet ondersteund. Toekomstige compatibiliteit is niet gegarandeerd.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Remarks

sp_changelogreader_agent wordt gebruikt bij transactionele replicatie.

sp_changelogreader_agentwordt gebruikt om het Windows-account te wijzigen waaronder een Log Reader-agent draait. Je kunt het wachtwoord van een bestaande Windows-login wijzigen of een nieuwe Windows-login en wachtwoord invoeren.

Na het wijzigen van een agent-login of wachtwoord moet je de agent stoppen en opnieuw starten voordat de wijziging van kracht wordt.

Permissions

Alleen leden van de sysadmin-vaste serverrol of de db_owner vaste databaserol kunnen uitvoeren sp_changelogreader_agent.