sp_hook_dbmlsync_sql

sp_hook_dbmlsync_sql_error

Benutzen Sie diese gespeicherte Prozedur, um Datenbankfehler zu verarbeiten, die während der Synchronisation auftreten. Sie können beispielsweise den Hook sp_hook_dbmlsync_sql_error implementieren, um beim Eintreten eines bestimmten SQL-Fehlers eine bestimmte Aktion durchzuführen.

Zeilen in der Tabelle #hook_dict

Name	Wert	Beschreibung
publication_n (in)	Publikation	Nicht mehr empfohlen. Verwenden Sie stattdessen subscription_n. Die synchronisierten Publikationen, wobei n eine Ganzzahl ist. Es gibt einen publication_n-Eintrag für jede synchronisierte Publikation. Die Nummerierung von n beginnt bei Null.
MobiLink user (in)	MobiLink-Benutzername	Der MobiLink-Benutzer, für den Sie synchronisieren
script version (in)	Skriptversionsname	Die MobiLink-Skriptversion, die für die Synchronisation verwendet werden soll
error message (in)	Fehlermeldungstext	Dies ist der Text, der auch im dbmlsync-Log angezeigt wird.
error id (in)	Nummerisch	Eine ID, die die Meldung eindeutig identifiziert.
error hook user state (in\|out)	Ganzzahl	Dieser Wert kann vom Hook eingestellt werden, um Statusinformationen in zukünftigen Aufrufen an die Hooks sp_hook_dbmlsync_all_error, sp_hook_dbmlsync_communication_error, sp_hook_dbmlsync_misc_error, sp_hook_dbmlsync_sql_error oder sp_hook_dbmlsync_end zu übergeben. Wenn einer dieser Hooks zum ersten Mal aufgerufen wird, ist der Wert der Zeile 0. Wenn ein Hook den Wert der Zeile ändert, wird der neue Wert im nächsten Hook-Aufruf verwendet.
SQLCODE (in)	SQLCODE	Der SQLCODE, der von der Datenbank zurückgegeben wird, wenn der Vorgang fehlgeschlagen ist. Siehe SQL Anywhere-Fehlermeldungen - sortiert nach SQLCODE.
SQLSTATE (in)	SQLSTATE-Wert	Der SQLSTATE, der von der Datenbank zurückgegeben wird, wenn der Vorgang fehlgeschlagen ist.
subscription_n (in)	Subskriptionsname(n)	Die synchronisierten Subskriptionen, wobei n eine Ganzzahl ist. Dies ist ein subscription_n-Eintrag für jede synchronisierte Subskription. Die Nummerierung von n beginnt bei Null.

Bemerkungen

Wenn beim Start ein Fehler auftritt, bevor eine Synchronisation initiiert werden konnte, werden die #hook_dict-Einträge für den MobiLink-Benutzer und die Skriptversion auf eine leere Zeichenfolge zurückgesetzt, und in der #hook_dict-Tabelle werden keine publication_n- oder subscription_n-Zeilen eingestellt.

Sie können SQL-Fehler mit SQL Anywhere SQLCODE oder dem ANSI SQL-Standard SQLSTATE ermitteln. Eine Liste der SQLCODE- oder SQLSTATE-Werte finden Sie unter SQL Anywhere - Fehlermeldungen.

Die Zeile "error hook user state" bietet ein nützliches Verfahren für die Übergabe der Informationen über die Art des Fehlers an den Hook sp_hook_dbmlsync_end. Anhand dieser Informationen können Sie entscheiden, ob die Synchronisation erneut ausgeführt werden soll.

Diese Prozedur wird in einer eigenen Verbindung ausgeführt, damit sichergestellt ist, dass die dadurch bewirkten Vorgänge nicht verloren gehen, wenn ein Zurücksetzen der Synchronisationsverbindung erfolgt. Wenn dbmlsync keine getrennte Verbindung herstellen kann, wird die Prozedur nicht aufgerufen.

Da dieser Hook in einer eigenen Verbindung ausgeführt wird, sollten Sie beim Zugriff auf Tabellen vorsichtig sein, die in Ihrer Hook-Prozedur synchronisiert werden, denn diese Tabellen werden von dbmlsync möglicherweise gesperrt. Diese Sperren können zum Fehlschlagen von Vorgängen im Hook oder zu unbegrenzten Wartezeiten führen.

Die Aktionen dieser Prozedur werden sofort nach ihrer Ausführung festgeschrieben.

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.