sp_addscriptexec (Transact-SQL)

Stellt ein SQL-Skript (SQL-Datei) für alle Abonnenten einer Publikation bereit. Diese gespeicherte Prozedur wird beim Verleger mit der Publikationsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_addscriptexec [ @publication = ] publication
    [ , [ @scriptfile = ] 'scriptfile' ]
    [ , [ @skiperror = ] 'skiperror' ]
    [ , [ @publisher = ] 'publisher' ]

Argumente

• [ @publication= ] 'publication'
  Der Name der Publikation. publication ist vom Datentyp sysname und hat keinen Standardwert.

• [ @scriptfile= ] 'scriptfile'
  Der vollständige Pfad zur SQL-Skriptdatei. scriptfile ist vom Datentyp nvarchar(4000) und hat keinen Standardwert.

• [ @skiperror= ] 'skiperror'
  Zeigt an, ob der Verteilungs- oder Merge-Agent beendet werden soll, wenn ein Fehler bei der Skriptausführung festgestellt wird. SkipError ist vom bit-Datentyp und hat den Standardwert 0.

  0 = Der Agent wird angehalten.

  1 = Der Agent setzt die Ausführung des Skripts fort und ignoriert den Fehler.

• [ @publisher= ] 'publisher'
  Gibt einen Nicht-Microsoft SQL Server-Verleger an. publisher ist vom Datentyp sysname und hat den Standardwert NULL.

  Hinweis:
  publisher sollte nicht verwendet werden, wenn ein SQL Server-Verleger verwendet wird.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_addscriptexec wird bei der Transaktions- und Mergereplikation verwendet.

sp_addscriptexec wird für die Snapshotreplikation nicht verwendet.

Zum Verwenden von sp_addscriptexec muss das SQL Server-Dienstkonto über Lese- und Schreibberechtigungen für den Snapshotspeicherort und Leseberechtigungen für den Ort verfügen, an dem Skripts gespeichert sind.

Das Dienstprogramm sqlcmd wird zum Ausführen des Skripts auf dem Abonnenten verwendet, und das Skript wird in dem Sicherheitskontext ausgeführt, der vom Verteilungs-Agent oder Merge-Agent beim Herstellen einer Verbindung mit der Abonnementdatenbank verwendet wird. Wenn der Agent in einer früheren Version von SQL Server ausgeführt wird, wird das Dienstprogramm osql anstelle von sqlcmd verwendet.

sp_addscriptexec ist bei der Anwendung von Skripts auf Abonnenten hilfreich und verwendet sqlcmd, um den Inhalt des Skripts auf den Abonnenten anzuwenden. Da die Abonnentenkonfiguration jedoch variieren kann, ist es möglich, dass Skripts, die vor der Bereitstellung für den Verleger getestet wurden, zu Fehlern auf einem Abonnenten führen. skiperror bietet die Möglichkeit, dass der Verteilungs- oder der Merge-Agent die Fehler ignorieren und die Ausführung fortsetzen kann. Verwenden Sie sqlcmd, um Skripts zu testen, bevor Sie sp_addscriptexec ausführen.

Hinweis:
Ausgelassene Fehler werden aus Referenzgründen weiterhin im Verlauf des Agents protokolliert.

Das Verwenden von sp_addscriptexec zum Bereitstellen einer Skriptdatei für Publikationen mithilfe von FTP für die Snapshotübermittlung wird nur für Microsoft SQL Server-Abonnenten unterstützt.

Berechtigungen

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

Siehe auch

Verweis

Gespeicherte Systemprozeduren (Transact-SQL)

Andere Ressourcen

How to: Execute Scripts During Synchronization (Replication Transact-SQL Programming)
Synchronisieren von Daten

Hilfe und Informationen

Informationsquellen für SQL Server 2005