フックが呼び出される直前に、dbmlsync は次の CREATE 文を使用してリモートデータベースに #hook_dict テーブルを作成します。テーブル名の前の # は、そのテーブルがテンポラリであることを意味します。

CREATE TABLE #hook_dict(
name VARCHAR(128) NOT NULL UNIQUE,
value VARCHAR(10240) NOT NULL)

dbmlsync ユーティリティは #hook_dict テーブルを使用してフック関数に値を渡し、フック関数は #hook_dict テーブルを使用して dbmlsync に値を戻します。

各フックは、パラメータ値を受け取ります。パラメータ値の中には、新しい値を返すように変更できるものがあります。それ以外のものは、読み込み専用です。このテーブルの各ローには、1 つのパラメータの値があります。

たとえば、2 つのサブスクリプションが次のように定義されているとします。

CREATE SYNCHRONIZATION SUBSCRIPTION sub1
TO pub1
FOR  MyUser;
SCRIPT VERSION 'v1'

CREATE SYNCHRONIZATION SUBSCRIPTION sub2
TO pub2
FOR  MyUser;
SCRIPT VERSION 'v1'

sp_hook_dbmlsync_begin フックが、次の dbmlsync コマンドラインに対して呼び出されるとします。

dbmlsync -c 'DSN=MyDsn' -s sub1,sub2

#hook_dict テーブルには、次のローが含まれます。

フックを使用して、#hook_dict テーブルから値を取り出したり、その動作をカスタマイズしたりできます。たとえば、Mobile Link ユーザを取り出すには、次のように SELECT 文を使用します。

SELECT value
FROM #hook_dict
WHERE name = 'MobiLink user'

In/out パラメータは、dbmlsync の動作をフックで修正することによって更新できます。たとえば、次のような文を使用してテーブルの abort synchronization ローを更新することで、同期のアボートを sp_hook_dbmlsync_abort フックから dbmlsync に指示することができます。

UPDATE #hook_dict
SET value='true'
WHERE name='abort synchronization'

各フックの記述には、#hook_dict テーブルのローがリストされます。

 権限

 例

CREATE PROCEDURE sp_hook_dbmlsync_delay()
BEGIN
   DECLARE delay_val integer;
 SET delay_val=DATEDIFF(
   second, CURRENT TIME, '19:00');
 IF (delay_val>0 AND
     delay_val<3600)
 THEN
 UPDATE #hook_dict SET value=delay_val
   WHERE name='delay duration';
 END IF;
END

CREATE PROCEDURE sp_hook_dbmlsync_begin()
BEGIN
   DECLARE MLuser VARCHAR(150);
   SELECT '>>>MLuser = ' || value INTO MLuser
      FROM #hook_dict
      WHERE name ='MobiLink user';
   MESSAGE MLuser TYPE INFO TO CONSOLE;
END