sp_hook_dbmlsync_sql

sp_hook_dbmlsync_sql_error

このストアドプロシージャーを使用して、同期中に発生したデータベースエラーを処理します。たとえば、sp_hook_dbmlsync_sql_error フックを実装すると、特定の SQL エラーが発生した場合に、特定のアクションを実行することができます。

#hook_dict テーブルのロー

名前	値	説明
publication_n (in)	パブリケーション	廃止予定。代わりに subscription_n を使用します。同期されているパブリケーション (n は整数)。同期されるパブリケーションごとに 1 つの publication_n エントリがあります。n の番号は 0 から始まります。
MobiLink user (in)	Mobile Link ユーザー名	同期対象となる Mobile Link ユーザー。
script version (in)	スクリプトバージョン名	同期に使用される Mobile Link スクリプトバージョン。
error message (in)	エラーメッセージテキスト	これは、dbmlsync ログに表示されるテキストと同じです。
error id (in)	数値	メッセージをユニークに識別する ID。
error hook user state (in\|out)	整数	この値はフックによって設定して、今後の呼び出しに対するステータス情報を、sp_hook_dbmlsync_all_error、sp_hook_dbmlsync_communication_error、sp_hook_dbmlsync_misc_error、sp_hook_dbmlsync_sql_error、または sp_hook_dbmlsync_end フックに渡すことができます。これらのフックの 1 つが最初に呼び出されるとき、ローの値は 0 です。フックがローの値を変更した場合は、次回のフックの呼び出しには新しい値が使用されます。
SQLCODE (in)	SQLCODE	操作が失敗したときにデータベースから返される SQLCODE。 SQL Anywhere のエラーメッセージ (SQLCODE 順)を参照してください。
SQLSTATE (in)	SQLSTATE 値	操作が失敗したときにデータベースから返される SQLSTATE。
subscription_n (in)	サブスクリプション名	同期されているサブスクリプションの名前 (n は整数)。これは、同期される各サブスクリプションの subscription_n エントリです。n の番号は 0 から始まります。

備考

同期を開始する前の起動中にエラーが発生した場合、#hook_dict 内の Mobile Link ユーザーとスクリプトバージョンのエントリは空の文字列に設定され、#hook_dict テーブルで設定される publication_n ローや subscription_n ローはありません。

SQL エラーは、SQL Anywhere の SQLCODE または ANSI SQL 規格の SQLSTATE を使用して識別できます。 SQLCODE または SQLSTATE 値のリストについては、SQL Anywhere のエラーメッセージを参照してください。

error hook user state ローは、エラーの内容を sp_hook_dbmlsync_end フックに渡す場合に役立つメカニズムを提供します。フックでは、この情報を使用して同期をリトライするかどうかを決定できます。

このプロシージャーは別個の接続で実行されるため、同期接続でロールバックが実行されても、このプロシージャーで実行する操作が失われることはありません。dbmlsync が別個の接続を確立できないと、プロシージャーは呼び出されません。

このフックは別の接続で実行されるため、フックプロシージャーで同期されているテーブルにアクセスする場合は注意してください。これらのテーブルは dbmlsync によってロックされている可能性があるためです。これらのロックが原因で、フック内の操作が失敗したり、無期限に待機したりすることがあります。

このプロシージャーのアクションは、実行直後にコミットされます。

参照

DocCommentXchange で意見交換できます