dbmlsync エラーメッセージが生成されるたびに、次のフックが呼び出されます。

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

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

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

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

このプロシージャーのアクションは、フックが完了した直後にコミットされます。

• イベントフックプロシージャー内でのエラーと警告の処理
• sp_hook_dbmlsync_communication_error
• sp_hook_dbmlsync_misc_error
• sp_hook_dbmlsync_sql_error

次のテーブルを使用して、リモートデータベース内のエラーのログを取ります。

CREATE TABLE error_log
(
 pk INTEGER DEFAULT AUTOINCREMENT PRIMARY KEY,
 err_id INTEGER,
 err_msg VARCHAR(10240),
);

次の例では、sp_hook_dbmlsync_all_error を設定して、エラーログを取ります。

CREATE PROCEDURE sp_hook_dbmlsync_all_error()
BEGIN
 DECLARE msg VARCHAR(10240);
 DECLARE id INTEGER;

 // get the error message text
 SELECT value INTO msg
  FROM #hook_dict
  WHERE name ='error message';

 // get the error id
 SELECT value INTO id
  FROM #hook_dict
  WHERE name = 'error id';

 // log the error information
 INSERT INTO error_log(err_msg, err_id)
  VALUES (msg, id);
END;

エラーの可能性がある ID 値を表示するには、dbmlsync をテスト実行します。たとえば、dbmlsync が「Mobile Link サーバーに接続できません。」というエラーを返すと、sp_hook_dbmlsync_all_error が次のローを error_log に挿入します。

1,14173,
 'Unable to connect to MobiLink server'

これで、「Mobile Link サーバーに接続できません。」というエラーとエラー ID 14173 を関連付けることができます。

次の例では、エラー 14173 が発生したときに必ず同期をリトライするようにフックを設定します。

CREATE PROCEDURE sp_hook_dbmlsync_all_error()
BEGIN
 IF EXISTS( SELECT value FROM #hook_dict 
    WHERE name = 'error id' AND value = '14173' )
 THEN
    UPDATE #hook_dict SET value = '1' 
       WHERE name = 'error hook user state';
   END IF;
END;

CREATE PROCEDURE sp_hook_dbmlsync_end()
BEGIN
 IF EXISTS( SELECT value FROM #hook_dict 
    WHERE name='error hook user state' AND value='1')
 THEN
    UPDATE #hook_dict SET value = 'sync' 
       WHERE name='restart';
   END IF;
END;

sp_hook_dbmlsync_endを参照してください。