upload_fetch_column_conflict 表事件

数据脚本，用于为检测列级冲突而从统一数据库的已同步表中读取行。

参数

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

SQL 脚本的参数名称	说明	顺序（不建议用于 SQL）
s.remote_id	VARCHAR(128)。MobiLink 远程 ID。只有在使用命名参数时才能引用远程 ID。	N/A
s.username	VARCHAR(128)。MobiLink 用户名。此参数为可选参数。	可选
r. pk-column-1	必需。第一个主键列值，由列名或列编号引用。	1（如果引用用户名则为 2）
...	...	...
r. pk-column-N	必需。最后一个主键列值，由列名或列编号引用。	N（如果引用用户名则为 N + 1）
r. column-1	必需。第一个非主键列值，由列名或列编号引用。	N + 1（如果引用用户名则为 N+2）
...	...	...
r. column-M	必需。最后一个非主键列值，由列名或列编号引用。	N + M（如果引用用户名则为 N+M+1）

缺省操作

注释

upload_fetch_column_conflict 脚本随 upload_update 事件使用。

只能为没有 BLOB 的远程表定义该脚本。

使用该脚本，MobiLink 服务器只会在上次同步后远程数据库和统一数据库上更新相同的列时，检测行冲突。不同的用户可更新同一行，只要他们不更新同一列，就不会产生冲突。

例如，当您的一个远程用户更新 ULOrder 表的 quant 列而另一个远程用户更新同一行的 notes 列时，使用 upload_fetch_column_conflict 脚本可以避免检测到冲突。仅在他们两人都更新 quant 列时，您才会检测到冲突。

注意

当通过 upload_update 脚本一次性执行所有冲突检测时，通常速度会快很多。请参见upload_update 表事件。

当使用 upload_fetch_column_conflict 脚本而未检测到冲突时，传递到 upload_update 脚本的行值来自于远程数据库的上载或 upload_fetch_column_conflict 脚本中的当前统一值。远程数据库的值用于在远程数据库上更新的列，其他情况中会使用当前统一值。换言之，只有在远程更新的列才会在统一中更新。

您只能为远程数据库中的每个表编写一个 upload_fetch 脚本或一个 upload_fetch_column_conflict 脚本。

此脚本在未定义以下脚本时可以被忽略：upload_new_row_insert、upload_old_row_insert 和 resolve_conflict。

该脚本必须以 SQL 实现。对于行的 Java 或 .NET 处理，请参见直接行处理。

另请参见

使用DocCommentXchange 讨论此页。