begin_download_deletes テーブル・イベント

リモート・データベース内の指定したテーブルから削除するローのリストをフェッチする直前に、そのテーブルに関連した文を処理します。

パラメータ

次の表の説明では、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

デフォルトのアクション

なし

備考

このイベントは、リモート・データベースの指定したテーブルから削除するローのリストをフェッチする直前に実行されます。

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

参照

SQL の例

リモート・データベース上のデータ量を最小限に抑えるために、このイベントを使用して、download_delete_cursor の実行時に削除するデータにフラグを設定できます。次の例では、リモート・デバイスの 10 週以上経過した売上データに、削除対象を示すフラグを設定します。次の例は、SQL Anywhere 11 データベースで使用できます。

次の Mobile Link システム・プロシージャ・コールは、スクリプト・バージョン ver1 を同期するときに、BeginDownloadDeletes ストアド・プロシージャを begin_download_deletes イベントに割り当てます。

CALL ml_add_table_script (
  'ver1', 
  'Leads', 
  'begin_download_deletes',
  'CALL BeginDownloadDeletes (
    {ml s.last_table_download}, 
    {ml s.username}, 
    {ml s.table})' );

次の SQL 文は BeginDownloadDeletes ストアド・プロシージャを作成します。

CREATE PROCEDURE BeginDownloadDeletes( 
  LastDownload timestamp, 
  MLUser varchar(128), 
  TableName varchar(128) )
BEGIN
  execute immediate 'update ' || TableName ||
  ' set delete_flag = 1 where
  days(creation_time, CURRENT DATE) > 70 and Owner = '
  || MLUser;
END;

Java の例

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

CALL ml_add_java_table_script(
   'ver1',
   'table1',
   'begin_download_deletes',
   'ExamplePackage.ExampleClass.beginDownloadDeletes' )

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

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

.NET の例

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

CALL ml_add_dnet_table_script (
  'ver1', 'table1', 'begin_download_deletes',
  'TestScripts.Test.BeginDownloadDeletes'
)

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

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