sp_changelogreader_agent (Transact-SQL)

Ändert die Sicherheitseigenschaften eines Protokolllese-Agents. Diese gespeicherte Prozedur wird beim Verleger mit der Veröffentlichungsdatenbank ausgeführt.

SicherheitshinweisSicherheitshinweis

Bei der Konfiguration eines Verlegers mit einem Remoteverteiler werden die Werte, die für alle Parameter einschließlich job_login und job_password bereitgestellt werden, als Nur-Text an den Verteiler gesendet. Vor dem Ausführen dieser gespeicherten Prozedur sollten Sie die Verbindung zwischen dem Verleger und dessen Remoteverteiler verschlüsseln. Weitere Informationen finden Sie unter Verschlüsseln von Verbindungen zu SQL Server.

Syntax

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

Argumente

  • [ @job_login= ] 'job_login'
    Der Anmeldename für das Windows-Konto, unter dem der Agent ausgeführt wird. job_login ist vom Datentyp nvarchar(257) und hat den Standardwert NULL. Dies kann für einen Nicht-MicrosoftSQL Server-Verleger nicht geändert werden.

  • [ @job_password= ] 'job_password'
    Das Kennwort für das Microsoft Windows-Konto, unter dem der Agent ausgeführt wird. job_password ist vom Datentyp sysname und hat den Standardwert NULL.

    SicherheitshinweisSicherheitshinweis

    Fordern Sie bei Laufzeit die Benutzer nach Möglichkeit zur Eingabe von Anmeldeinformationen für die Sicherheit auf. Wenn Anmeldeinformationen in einer Skriptdatei gespeichert werden müssen, müssen Sie die Datei an einem sicheren Ort speichern, um unberechtigten Zugriff zu vermeiden.

  • [ @publisher_security_mode= ] publisher_security_mode
    Der vom Agenten beim Herstellen der Verbindung mit dem Verleger verwendete Sicherheitsmodus. publisher_security_mode ist vom Datentyp smallint und hat den Standardwert NULL. Der Wert 0 gibt die SQL Server-Authentifizierung und der Wert 1 die Windows-Authentifizierung an.

    SicherheitshinweisSicherheitshinweis

    Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.

  • [ @publisher_login= ] 'publisher_login'
    Der zum Herstellen einer Verbindung mit dem Verleger verwendete Anmeldename. publisher_login ist vom Datentyp sysname und hat den Standardwert NULL. publisher_login muss angegeben werden, wenn publisher_security_mode den Wert 0 hat. Wenn publisher_login den Wert NULL und publisher_security_mode den Wert 1 hat, wird beim Herstellen der Verbindung mit dem Verleger das in job_login angegebene Windows-Konto verwendet.

  • [ @publisher_password= ] 'publisher_password'
    Das zum Herstellen einer Verbindung mit dem Verleger verwendete Kennwort. publisher_password ist vom Datentyp sysname und hat den Standardwert NULL.

    SicherheitshinweisSicherheitshinweis

    Verwenden Sie kein leeres Kennwort. Verwenden Sie ein sicheres Kennwort. Fordern Sie bei Laufzeit die Benutzer nach Möglichkeit zur Eingabe von Anmeldeinformationen für die Sicherheit auf. Wenn Anmeldeinformationen in einer Skriptdatei gespeichert werden müssen, müssen Sie die Datei an einem sicheren Ort speichern, um unberechtigten Zugriff zu vermeiden.

  • [ @publisher = ] 'publisher'
    Der Name des Verlegers. publisher ist vom Datentyp sysname und hat den Standardwert NULL. Dieser Parameter wird nur für Nicht-SQL Server-Verleger unterstützt.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_changelogreader_agent wird in Transaktionsreplikationen verwendet.

sp_changelogreader_agent dient zum Ändern des Windows-Kontos, unter dem ein Protokolllese-Agent ausgeführt wird. Sie können das Kennwort eines vorhandenen Windows-Anmeldenamens ändern oder einen neuen Windows-Anmeldenamen mit zugehörigem Kennwort angeben.

Nachdem Sie den Anmeldenamen oder das Kennwort für einen Agent geändert haben, müssen Sie den Agent beenden und neu starten, damit die Änderungen wirksam werden.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin oder der festen Datenbankrolle db_owner können sp_changelogreader_agent ausführen.