begin_download_rows 表事件

紧接在读取将要在远程数据库的指定表中插入或更新行的列表之前，处理与该特定表有关的语句。

参数

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

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

SQL 脚本的参数名称	说明	顺序（不建议用于 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
s.script_version	VARCHAR(128)。可选的 IN 参数，可指定 MobiLink 服务器将用于当前同步的脚本版本字符串传递到此参数。不能使用问号指定此参数。	不适用

缺省操作

注释

此事件将在读取将要在远程数据库的指定表中插入或更新的行之前执行。

注意

对于每个下载表，会依次调用 begin_download_deletes、download_delete_cursor 和 end_download_deletes 事件。考虑在作为单个存储过程实现的 download_delete_cursor 事件（将返回包含要从远程表中删除的所有行的结果集）中实现表的所有下载删除逻辑。脚本调用数量的减少可能带来下载性能的提升。

您可以为远程数据库的每个表编写一个 begin_download_rows 脚本。

另请参见

使用DocCommentXchange讨论此页。