begin_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

デフォルトのアクション

なし

備考

このイベントは、リモート・データベース内の指定したテーブルで挿入または更新されるローのストリームをフェッチする直前に、実行されます。

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

参照

SQL の例

begin_download_rows テーブル・イベントを使用すると、このテーブルでダウンロードする必要がなくなったローにフラグを設定できます。次の例では、7 日以上経過した売上データをアーカイブします。

次の Mobile Link システム・プロシージャ・コールは、begin_download_rows イベント用の BeginDownloadRows ストアド・プロシージャを登録します。

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

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

CREATE PROCEDURE BeginDownloadRows (
  LastDownload timestamp, MLUser varchar(128),
  TableName varchar(128) )
BEGIN
  execute immediate 'update ' || TableName ||
  ' set download_flag = 0 where
  days(creation_time, CURRENT DATE) > 7 and Owner = '
  || MLUser;
END;

Java の例

次の Mobile Link システム・プロシージャ・コールは、スクリプト・バージョン ver1 を同期するときに、beginDownloadRows という Java メソッドを begin_download_rows テーブル・イベント用のスクリプトとして登録します。これは SQL Anywhere 統合データベース用の構文です。

CALL ml_add_java_table_script(
   'ver1',
   'table1',
   'begin_download_rows',
   'ExamplePackage.ExampleClass.beginDownloadRows' )

次に示すのは、サンプルの Java メソッド beginDownloadRows です。このメソッドは、Mobile Link が実行するテーブルとユーザを使用して UPDATE 文を生成します。

public String beginDownloadRows( 
  Timestamp ts,
  String user, 
  String table ) {  
  return( "update " + table + " set download_flag = 0 "
   + " where days(creation_time, CURRENT DATE) > 7 " +
   " and Owner = '" + user + "'" ); 
}

.NET の例

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

CALL ml_add_dnet_table_script(
  'ver1', 'table1', 'begin_download_rows',
  'TestScripts.Test.BeginDownloadRows'
)

次に示すのは、サンプルの .NET メソッド BeginDownloadRows です。このメソッドは、Mobile Link が実行するテーブルとユーザを使用して UPDATE 文を生成します。

public string BeginDownloadRows(
  DateTime timestamp,
  string user,
  string table ) {  
  return( "update " + table + " set download_flag = 0 "
   + " where days(creation_time, CURRENT DATE) > 7 " +
   " and Owner = '" + user + "'" ); 
}