Freigeben über


sp_changelogreader_agent (Transact-SQL)

Gilt für: SQL Server Azure SQL Managed Instance

Ändert die Sicherheitseigenschaften eines Protokolllese-Agents. Diese gespeicherte Prozedur wird im Publisher in der Publikationsdatenbank ausgeführt.

Wichtig

Beim Konfigurieren eines Herausgebers mit einem Remoteverteiler werden die für alle Parameter bereitgestellten Werte, einschließlich @job_login und @job_password, als Nur-Text an den Distributor gesendet. Sie sollten die Verbindung zwischen dem Verleger und dem zugehörigen Remoteverteiler verschlüsseln, bevor Sie diese gespeicherte Prozedur ausführen. Weitere Informationen finden Sie unter Konfigurieren der SQL Server-Datenbank-Engine zum Verschlüsseln von Verbindungen.

Syntax

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' ]
[ ; ]

Argumente

[ @job_login = ] N'job_login'

Die Anmeldung für das Konto, unter dem der Agent ausgeführt wird. @job_login ist nvarchar(257), mit einem Standardwert von NULL. Verwenden Sie in Azure SQL verwaltete Instanz ein SQL Server-Konto.

Hinweis

Dies kann für einen Nicht-SQL Server-Herausgeber nicht geändert werden.

[ @job_password = ] N'job_password'

Das Kennwort für das Konto, unter dem der Agent ausgeführt wird. @job_password ist "sysname" mit der Standardeinstellung "NULL.

Wichtig

Benutzer sollten nach Möglichkeit dazu aufgefordert werden, Anmeldeinformationen zur Laufzeit anzugeben. Wenn Anmeldeinformationen in einer Skriptdatei gespeichert werden müssen, muss die Datei an einem sicheren Ort gespeichert werden, um unberechtigten Zugriff zu vermeiden.

[ @publisher_security_mode = ] publisher_security_mode

Der vom Agent beim Herstellen einer Verbindung mit dem Publisher verwendete Sicherheitsmodus. @publisher_security_mode ist klein, mit einem Standardwert von NULL. Die folgenden Werte definieren den Sicherheitsmodus:

  • 0 Gibt die SQL Server-Authentifizierung an.
  • 1gibt Windows-Authentifizierung an.
  • 2 Gibt die Microsoft Entra-Kennwortauthentifizierung ab SQL Server 2022 (16.x) CU 6 an.
  • 3 Gibt die integrierte Microsoft Entra-Authentifizierung ab SQL Server 2022 (16.x) CU 6 an.
  • 4 Gibt die Microsoft Entra-Tokenauthentifizierung ab SQL Server 2022 (16.x) CU 6 an.

Wichtig

Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.

[ @publisher_login = ] N'publisher_login'

Der Anmeldename, der beim Herstellen einer Verbindung mit dem Verleger verwendet wird @publisher_login ist "sysname" mit einem Standardwert von NULL. @publisher_login muss angegeben werden, wenn @publisher_security_mode ist0. Wenn @publisher_login ist NULL und @publisher_security_mode ist 1, wird das in @job_login angegebene Windows-Konto beim Herstellen einer Verbindung mit publisher verwendet.

[ @publisher_password = ] N'publisher_password'

Das Kennwort, das beim Herstellen einer Verbindung mit dem Publisher verwendet wird. @publisher_password ist "sysname" mit einem Standardwert von NULL.

Wichtig

Verwenden Sie kein leeres Kennwort. Verwenden Sie ein sicheres Kennwort. Benutzer sollten nach Möglichkeit dazu aufgefordert werden, Anmeldeinformationen zur Laufzeit anzugeben. Wenn Anmeldeinformationen in einer Skriptdatei gespeichert werden müssen, muss die Datei an einem sicheren Ort gespeichert werden, um unberechtigten Zugriff zu vermeiden.

[ @publisher = ] N'publisher'

Der Name des Herausgebers. @publisher ist "sysname" mit der Standardeinstellung "NULL. Dieser Parameter wird nur für Nicht-SQL Server-Verleger unterstützt.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_changelogreader_agent wird in der Transaktionsreplikation verwendet.

sp_changelogreader_agent wird verwendet, um das Windows-Konto zu ändern, unter dem ein Log Reader-Agent ausgeführt wird. Sie können das Kennwort für einen vorhandenen Windows-Anmeldenamen ändern oder einen neuen Windows-Anmeldenamen und ein neues Kennwort angeben.

Nach dem Ändern des Anmeldenamens oder Kennworts eines Agents müssen Sie den Agent beenden und neu starten, damit die Änderungen in Kraft treten.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin oder die db_owner feste Datenbankrolle können ausgeführt werden sp_changelogreader_agent.