sys.sp_changelogreader_agent (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed Instance

Ändrar säkerhetsegenskaperna hos en loggläsaragent. Den här lagrade proceduren körs i Publisher i publikationsdatabasen.

Important

När en Publisher konfigureras med en fjärrdistributör skickas värdena för alla parametrar, inklusive @job_login och @job_password, till distributören som klartext. Du bör kryptera anslutningen mellan Utgivaren och dess fjärranslutna distributör innan du kör den här lagrade proceduren. Mer information finns i Konfigurera Databasmotor för SQL Server för kryptering av anslutningar.

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'

Inloggningen för kontot som agenten körs under. @job_login är nvarchar(257), med en standard på NULL. På Azure SQL Managed Instance, använd ett SQL Server-konto.

Note

Detta kan inte ändras för en utgivare som inte är SQL Server.

[ @job_password = ] N'job_password'

Lösenordet till kontot som agenten kör under. @job_password är sysname, med standardvärdet .NULL

Important

När det är möjligt uppmanar du användarna att ange säkerhetsautentiseringsuppgifter vid körning. Om du måste lagra autentiseringsuppgifter i en skriptfil måste du skydda filen för att förhindra obehörig åtkomst.

[ @publisher_security_mode = ] publisher_security_mode

Säkerhetsläget som agenten använder när de ansluter till Publisher. @publisher_security_mode är smallint, med standardvärdet .NULL Följande värden definierar säkerhetsläget:

  • 0 specificerar autentisering av SQL Server.
  • 1 specificerar Windows-autentisering.
  • 2specificerar autentisering av Microsoft Entra-lösenord, med start från SQL Server 2022 (16.x) CU 6.
  • 3specificerar Microsoft Entra integrerad autentisering, med start från SQL Server 2022 (16.x) CU 6.
  • 4specificerar Microsoft Entra-tokenautentisering, med start från SQL Server 2022 (16.x) CU 6.

Important

Använd Windows-autentisering när det är möjligt.

[ @publisher_login = ] N'publisher_login'

Inloggningen som används vid anslutning till Publisher. @publisher_login är sysname, med standardvärdet .NULL @publisher_login måste specificeras när @publisher_security_mode är 0. Om @publisher_login är NULL och @publisher_security_mode är 1, används det Windows konto som anges i @job_login när man ansluter till Publisher.

[ @publisher_password = ] N'publisher_password'

Lösenordet som används vid anslutning till utgivaren. @publisher_password är sysname, med standardvärdet .NULL

Important

Använd inte ett tomt lösenord. Använd ett starkt lösenord. När det är möjligt uppmanar du användarna att ange säkerhetsautentiseringsuppgifter vid körning. Om du måste lagra autentiseringsuppgifter i en skriptfil måste du skydda filen för att förhindra obehörig åtkomst.

[ @publisher = ] N'utgivare'

Namnet på utgivaren. @publisher är sysname, med standardvärdet NULL. Denna parameter stöds endast för icke-SQL Server Publishers.

[ @job_security_mode = ] job_security_mode

Identifieras endast i informationssyfte. Stöds ej. Framtida kompatibilitet garanteras inte.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Remarks

sp_changelogreader_agent används vid transaktionell replikation.

sp_changelogreader_agentanvänds för att ändra Windows-kontot under vilket en loggläsaragent körs. Du kan ändra lösenordet till en befintlig Windows-inloggning eller ange en ny Windows-inloggning och lösenord.

Efter att ha bytt agentinloggning eller lösenord måste du stoppa och starta om agenten innan ändringen träder i kraft.

Permissions

Endast medlemmar av sysadmin-rollen med fast server eller db_owner fast databasroll kan köra sp_changelogreader_agent.

Relaterat innehåll

  • Last updated on