リモート・データベース内の指定したテーブルから挿入と更新をアップロードする直前に、そのテーブルに関連した文を処理します。

パラメータ

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

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

デフォルトのアクション

なし

備考

このイベントは、2 番目のパラメータで指定したクライアント・テーブルに対する挿入と削除から生じる変更を適用する直前に、発生します。

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

参照

• スクリプトのパラメータ
• スクリプトの追加と削除
• end_upload_rows テーブル・イベント
• スクリプトでのリモート ID と Mobile Link ユーザ名の使用

SQL の例

begin_upload_rows 接続イベントを使って、特定のテーブルの挿入と更新をアップロードする前に行う必要がある手順を実行します。次のスクリプトは、統合データベースで Inventory テーブルへの挿入と更新を準備するストアド・プロシージャを呼び出します。

CALL ml_add_table_script(
 'MyCorp 1.0',
 'Inventory',
 'begin_upload_rows',
 'CALL PrepareForUpserts()' )

Java の例

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

CALL ml_add_java_table_script( 
  'ver1',
  'table1',
  'begin_upload_rows',
  'ExamplePackage.ExampleClass.beginUploadRows' )

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

public String beginUploadRows( 
  String user,
  String table )
  throws java.sql.SQLException {  
  java.lang.System.out.println( 
   "Starting upload rows for table: " + 
   table + " and user: " + user );
  return ( null );
}

.NET の例

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

CALL ml_add_dnet_table_script(
  'ver1', 
  'table1', 
  'begin_upload_rows',
  'TestScripts.Test.BeginUploadRows'
)

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

public string BeginUploadRows(
  string user,
  string table ) {  
  System.Console.WriteLine( 
   "Starting upload rows for table: " + 
   table + " and user: " + user );
  return ( null );
}