sp_changelogreader_agent (Transact-SQL)

Gilt für:SQL ServerAzure SQL Managed Instance

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

Wichtig

Beim Konfigurieren 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. 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 Aktivieren von verschlüsselten Verbindungen zur Datenbank-Engine (SQL Server-Konfigurations-Manager).

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' Ist die Anmeldung für das Konto, unter dem der Agent ausgeführt wird. job_login ist nvarchar(257), wobei der Standardwert NULL ist. Verwenden Sie in Azure SQL verwaltete Instanz ein SQL Server-Konto. Dies kann für einen Nicht-Microsoft SQL Server-Herausgeber nicht geändert werden.

[ @job_password = ] 'job_password' Ist das Kennwort für das Konto, unter dem der Agent ausgeführt wird. job_password ist "sysname" mit dem Standardwert 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

Hinweis

Microsoft Entra-ID wurde zuvor als Azure Active Directory (Azure AD) bezeichnet.

Der vom Agent beim Herstellen der Verbindung mit dem Verleger 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 = ] 'publisher_login' Ist die Anmeldung, die beim Herstellen einer Verbindung mit dem Publisher verwendet wird. publisher_login ist "sysname" mit dem Standardwert NULL. publisher_login muss angegeben werden, wenn publisher_security_mode 0 ist. Wenn publisher_login NULL ist und publisher_security_mode 1 ist, wird das in job_login angegebene Windows-Konto beim Herstellen einer Verbindung mit Publisher verwendet.

[ @publisher_password = ] 'publisher_password' Ist das Kennwort, das beim Herstellen einer Verbindung mit dem Publisher verwendet wird. publisher_password ist "sysname" mit dem Standardwert 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 = ] 'publisher' Ist der Name des Herausgebers. Publisher ist "sysname" mit dem 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 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 sp_changelogreader_agent ausführen.

Weitere Informationen

Anzeigen und Ändern von Replikationssicherheitseinstellungen
sp_helplogreader_agent (Transact-SQL)
sp_addlogreader_agent (Transact-SQL)