挿入、更新、削除のダウンロードを準備する直前に、特定のテーブルに関連した文を処理します。

パラメータ

次の表の説明では、SQL データ型を示します。Java または .NET でスクリプトを作成する場合、適切なデータ型を使用してください。SQL データ型と Java データ型とSQL データ型と .NET データ型を参照してください。

SQL スクリプトでは、名前または疑問符を使用してイベント・パラメータを指定できますが、スクリプト内に名前と疑問符を混在させることはできません。疑問符を使用する場合、パラメータは以下に示す順に指定する必要があり、後続のパラメータが指定されていない場合のみ省略可能です (たとえば、パラメータ 2 を使用する場合は、パラメータ 1 を使用してください)。名前付きパラメータを使用する場合は、パラメータの任意のサブセットを任意の順に指定できます。

デフォルトのアクション

なし

備考

Mobile Link サーバは、特定のテーブルのダウンロード情報を準備する最初の手順として、このイベントを実行します。ダウンロード情報は、専用トランザクションで準備されます。このイベントの実行が、このトランザクションで最初のテーブル固有のアクションとなります。

リモート・データベースのテーブルごとに、begin_download スクリプトを 1 つ指定できます。このスクリプトは、テーブルが同期されている場合にのみ呼び出されます。

参照

• スクリプトのパラメータ
• スクリプトの追加と削除
• end_download テーブル・イベント
• スクリプトでのリモート ID と Mobile Link ユーザ名の使用
• スクリプトでの最終ダウンロード時刻の使用

SQL の例

次の Mobile Link システム・プロシージャ procedure ml_add_table_script の呼び出しは BeginTableDownload プロシージャを呼び出します。これは SQL Anywhere 11 統合データベース用の構文です。

CALL ml_add_table_script( 
   'version1', 
   'Leads', 
   'begin_download',
   'CALL BeginTableDownLoad( 
     {ml s.last_table_download},
     {ml s.username},
     {ml s.table} )' );

次の SQL 文は BeginTableDownload プロシージャを作成します。

CREATE PROCEDURE BeginTableDownload( 
   LastDownload timestamp, 
   MLUser varchar(128), 
   TableName varchar(128) )
BEGIN
  EXECUTE IMMEDIATE 'update ' || TableName ||
' set last_download_check = CURRENT TIMESTAMP
  WHERE Owner = ' ||MLUser;
END

Java の例

次の Mobile Link システム・プロシージャ・コールは、スクリプト・バージョン ver1 を同期するときに、beginDownloadTable という Java メソッドを begin_download テーブル・イベント用のスクリプトとして登録します。

CALL ml_add_java_table_script( 
   'ver1', 
   'table1',
   'begin_download',
   'ExamplePackage.ExampleClass.beginDownloadTable' )

次に示すのは、サンプルの Java メソッド beginDownloadTable です。このメソッドは、後のメソッド呼び出しで使用するために現在のテーブルの名前を保存します。

public String beginDownloadTable( 
  Timestamp ts,
  String user, 
  String table ) {  
  _curTable = table;
  return ( null );
}

.NET の例

次の Mobile Link システム・プロシージャ・コールは、スクリプト・バージョン ver1 とテーブル table1 を同期するときに、BeginTableDownload という .NET メソッドを begin_download テーブル・イベント用のスクリプトとして登録します。

CALL ml_add_dnet_table_script(
  'ver1', 'table1', 'begin_download',
  'TestScripts.Test.BeginTableDownload'
)

次に示すのは、サンプルの .NET メソッド BeginTableDownload です。このメソッドは、後のメソッド呼び出しで使用するために現在のテーブルの名前を保存します。

public string BeginTableDownload(
  DateTime timestamp,
  string user,
  string table ) {  
  _curTable = table;
  return ( null );
}