begin_upload 表事件

紧接在 MobiLink 服务器开始处理上载的插入、更新和删除操作的流之前，处理与特定的表有关的语句。

参数

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

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

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

缺省操作

无。

注释

MobiLink 服务器执行此事件是对上载的信息进行处理的第一步。上载信息在单独的事务中进行处理。执行此事件是此事务中的第一步表特定的操作。

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

另请参见

SQL 示例

在从远程数据库上载行时，您可能希望将所做的更改放入一个中间表中并亲自手工处理这些更改。您可以在此事件中填入一个全局临时表。

CALL ml_add_table_script( 
 'version1', 
 'Leads',
 'begin_upload', 
 'INSERT INTO T_Leads 
  SELECT * FROM Leads 
  WHERE Owner = @EmployeeID' )

Java 示例

以下对 MobiLink 系统过程的调用在同步脚本版本 ver1 时将名为 beginUploadTable 的 Java 方法注册为 begin_upload 表事件的脚本。

CALL ml_add_java_table_script( 
  'ver1',
  'table1',
  'begin_upload',
  'ExamplePackage.ExampleClass.beginUploadTable'
 )

以下是 Java 方法 beginUploadTable 示例。它将消息输出到 MobiLink 消息日志。（请注意：将消息输出到 MobiLink 消息日志在开发时可能会有帮助，但会降低生产服务器的性能。）

public String beginUploadTable( 
  String user, 
  String table ) {
  java.lang.System.out.println("Beginning to process upload for: " + table);
  return ( null );
}

.NET 示例

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

CALL ml_add_dnet_table_script(
  'ver1', 
  'table1', 
  'begin_upload',
  'TestScripts.Test.BeginTableUpload'
)

以下是 .NET 方法 BeginTableUpload 示例。它将消息输出到 MobiLink 消息日志。（请注意：将消息输出到 MobiLink 消息日志在开发时可能会有帮助，但会降低生产服务器的性能。）

public string BeginTableUpload(
  string user,
  string table ) {  
  System.Console.WriteLine("Beginning to process upload for: " + table);
  return ( null );
}