begin_download 表事件

紧接在准备下载插入、更新和删除操作之前处理与某一特定的表有关的语句。

参数

在下表中，说明部分提供 SQL 数据类型。如果您使用 Java 或 .NET 编写脚本，则应该使用相应的数据类型。请参见SQL-Java 数据类型和SQL-.NET 数据类型。

在 SQL 脚本中，可以使用名称或问号指定事件参数，但不能在一个脚本中混合使用名称和问号。如果使用问号，则参数必须按照如下所示的顺序并且仅当没有指定任何后继参数时才是可选的（例如，如果您想使用参数 2，则必须使用参数 1）。如果使用命名参数，则可以按照任何顺序指定任意参数子集。

SQL 脚本的参数名称	说明	顺序
s.last_table_download	TIMESTAMP。表的上一次下载时间。	1
s.remote_id	VARCHAR(128)。MobiLink 远程 ID。只有在使用命名参数时才能引用远程 ID。	不适用
s.username	VARCHAR(128)。MobiLink 用户名。	2
s.table	VARCHAR(128)。表名。	3

缺省操作

无。

注释

MobiLink 服务器执行此事件是为特定的表准备下载信息的第一步。下载信息是在单独的一个事务中进行准备的。执行此事件是此事务中的第一步表特定的操作。

您可以为远程数据库的每个表编写一个 begin_download 脚本。只有在对表进行同步时才会调用相应的脚本。

另请参见

SQL 示例

以下对 MobiLink 系统过程 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 示例

以下对 MobiLink 系统过程的调用在同步脚本版本 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 示例

以下对 MobiLink 系统过程的调用在同步脚本版本 ver1 和表 table1 时将名为 BeginTableDownload 的 .NET 方法注册为 begin_download 表事件的脚本。

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

以下是 .NET 方法 BeginDownload 示例。它保存当前表的名称以用于以后的方法调用。

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