このフックは、主に下位互換性のために提供されています。ScriptVersion 拡張オプションを使用していない場合は、START SYNCHRONIZATION SCHEMA CHANGE 文を使用することによって、このフックを使用せずにスキーマの変更を安全に実行することができます。

このフックを実装すると、dbmlsync はデフォルトで同期中のテーブルをロックします。

このストアドプロシージャは、配備されたリモートデータベースでスキーマの変更を行うためのものです。スキーマ更新のためにこのフックを使用すると、スキーマが更新される前にリモートデータベースのすべての変更が同期されます。そうされることによって、データベースの同期が確実に継続されます。このフックが使用中の場合、dbmlsync の拡張オプション LockTables を off に設定しないでください。

同期中に Mobile Link によってアップロードが正常に適用され、受信確認されると、このフックは sp_hook_dbmlsync_download_end フックの後、sp_hook_dbmlsync_end フックの前に呼び出されます。このフックは、ダウンロード専用の同期中、またはファイルベースのダウンロードが作成または適用されるときには呼び出されません。

このフックで実行されるアクションは、フックが完了した直後にコミットされます。このフックでコミットまたはロールバックを行っても安全です。

MANAGE REPLICATION システム権限を持つユーザが作成できるフックプロシージャ。ただし、フックによる情報のやり取りに使用される #hook_dict table にフックがアクセスできることを確認するには、フックが次のいずれかの要件を満たしている必要があります。

• START SYNCHRONIZATION SCHEMA CHANGE 文 [Mobile Link]
• リモート Mobile Link クライアントでのスキーマの変更

次の例では、sp_hook_dbmlsync_schema_upgrade プロシージャを使用して、リモートデータベース上の Dealer テーブルにカラムを追加します。アップグレードが成功すると、sp_hook_dbmlsync_schema_upgrade フックは削除されます。

CREATE PROCEDURE sp_hook_dbmlsync_schema_upgrade()
BEGIN
 -- Upgrade the schema of the Dealer table. Add a column:
 ALTER TABLE Dealer
  ADD dealer_description VARCHAR(128);

 -- Change the script version used to synchronize
 ALTER SYNCHRONIZATION SUBSCRIPTION sub1
  SET SCRIPT VERSION='v2';


 -- If the schema upgrade is successful, drop this hook:
 UPDATE #hook_dict
  SET value = 'on success'
  WHERE name = 'drop hook';
END;