end_download_rows テーブル・イベント

リモート・データベース内の指定されたテーブルで挿入または更新するローのリストを準備した直後に、そのテーブルに関連した文を処理します。

パラメータ

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

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

SQL スクリプトのパラメータ名	説明	順序
s.last_table_download	TIMESTAMP。テーブルの最後のダウンロード時刻。	1
s.remote_id	VARCHAR(128)。Mobile Link リモート ID。名前付きパラメータを使用している場合のみ、リモート ID を参照できます。	適用不可
s.username	VARCHAR(128)。Mobile Link ユーザ名。	2
s.table	VARCHAR(128)。テーブル名。	3

デフォルトのアクション

なし

備考

このスクリプトは、リモート・データベース内の指定されたテーブルで挿入または更新されるローのストリームを準備した直後に実行されます。

リモート・データベースのテーブルごとに、end_download_rows スクリプトを 1 つ指定できます。

参照

SQL の例

リモート・データベースへのダウンロードが成功したことを示すマークを、ローに付ける必要がある場合があります。次のスクリプトは、OnRemote という統合データベースのカラムを更新します。

注意

UPDATE の WHERE 句は、download_delete_cursor イベントのスクリプトに使用される WHERE 句に一致します。

CALL ml_add_table_script(
   'version1',
   'Leads',
   'end_download_rows',
   'UPDATE Leads SET OnRemote = 1 
    WHERE LastModified >= {ml s.last_table_download}
     AND Owner = {ml s.username} 
     AND DownloadFlag=1' );

Java の例

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

CALL ml_add_java_table_script(
   'ver1',
   'table1',
   'end_download_rows',
   'ExamplePackage.ExampleClass.endDownloadRows' )

次に示すのは、サンプルの Java メソッド endDownloadRows です。このメソッドは、Mobile Link メッセージ・ログにメッセージを出力します (メッセージを Mobile Link メッセージ・ログに出力すると、開発時には便利ですが、運用サーバのパフォーマンスが遅くなります)。

public String endDownloadRows(
  Timestamp ts,
  String user,
  String table ) {  
  java.lang.System.out.println( 
   "Done downloading inserts and updates for table " 
   + table );
  return ( null );
}

.NET の例

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

CALL ml_add_dnet_table_script(
 'ver1',
 'table1', 
 'end_download_rows',
 'TestScripts.Test.EndDownloadRows'
)

次に示すのは、サンプルの .NET メソッド EndDownloadRows です。このメソッドは、Mobile Link メッセージ・ログにメッセージを出力します (メッセージを Mobile Link メッセージ・ログに出力すると、開発時には便利ですが、運用サーバのパフォーマンスが遅くなります)。

public string EndDownloadRows(
  DateTime timestamp,
  string user,
  string table ) {
  System.Console.WriteLine( 
   "Done downloading inserts and updates for table " 
   + table );
  return ( null );
}