提供有关正被同步的发布的有用信息。
在下表中,说明部分提供 SQL 数据类型。如果您使用 Java 或 .NET 编写脚本,则应该使用相应的数据类型。请参见SQL-Java 数据类型和SQL-.NET 数据类型。
在 SQL 脚本中,可以按名称或使用问号指定事件参数。不建议使用问号,建议您使用命名参数。不能在一个脚本中混合使用名称和问号。如果使用问号,则参数必须按照如下所示的顺序并且仅当没有指定任何后继参数时才是可选的(例如,如果您想使用参数 2,则必须使用参数 1)。如果使用命名参数,则可以按照任何顺序指定任意参数子集。
SQL 脚本的参数名称 | 说明 | 顺序(不建议用于 SQL) |
---|---|---|
s.generation_number |
INTEGER。如果部署不使用基于文件的下载,则可以忽略此参数。缺省值是 1。 |
1 |
s.remote_id | VARCHAR(128)。MobiLink 远程 ID。只有在使用命名参数时才能引用远程 ID。 | 不适用 |
s.username |
VARCHAR(128)。MobiLink 用户名。 |
2 |
s.publication_name |
VARCHAR(128) |
3 |
s.last_publication_upload |
TIMESTAMP。此发布上次成功上载的时间。 |
4 |
s.last_publication_download |
TIMESTAMP。此发布的上一次下载时间。 |
5 |
s.subscription_id |
VARCHAR(128)。远程预订 ID。 |
6 |
无。
此事件使您可以根据当前正在同步的发布来设计同步逻辑。此事件与 end_synchronization 事件在相同的事务中并在 end_synchronization 事件之前被调用。对于当前正在同步的每个发布,将调用此事件一次。
如果当前同步成功应用了上载,则 last_upload 参数将包含应用此最新上载的时间。last_publication_download 与作为上次下载时间传递给下载脚本的值相同。
如果一个 UltraLite 远程数据库在与 UL_SYNC_ALL 进行同步,则将使用 'unknown' 这一名称调用此事件一次。
generation_number 参数专用于基于文件的下载。在基于文件的下载中,世代号的更改用于强制在下载之前,在远程端应用文件时进行上载。该编号存储在下载文件中。
世代号的输出值从 begin_publication 脚本传递到 end_publication 脚本。generation_number 的意义取决于是否在使用当前同步来创建一个下载文件,或者当前同步是否具有上载。
您可能要为每个正被同步的发布记录该信息。以下示例调用 ml_add_connection_script,将事件指派给名为 RecordPubEndSync 的存储过程。
CALL ml_add_connection_script( 'version1', 'end_publication', 'CALL RecordPubEndSync( {ml s.generation_number}, {ml s.username}, {ml s.publication_name}, {ml s.last_publication_upload}, {ml s.last_publication_download} )' ); |
以下对 MobiLink 系统过程的调用在同步脚本版本 ver1 时将名为 endPublication 的 Java 方法注册为 end_publication 连接事件的脚本。
CALL ml_add_java_connection_script( 'ver1', 'end_publication', 'ExamplePackage.ExampleClass.endPublication' ) |
以下是 Java 方法 endPublication 示例。它将向 MobiLink 消息日志输出一条消息。(请注意:将消息输出到 MobiLink 消息日志在开发时可能会有帮助,但会降低生产服务器的性能。)
public String endPublication( int generation_number, String user, String pub_name, Timestamp last_publication_upload, Timestamp last_publication_download ) { java.lang.System.out.println( "Finished synchronizing publication " + pub_name ); return ( null ); } |
以下对 MobiLink 系统过程的调用在同步脚本版本 ver1 时将名为 EndPub 的 .NET 方法注册为 end_publication 连接事件的脚本。
CALL ml_add_dnet_connection_script( 'ver1', 'end_publication', 'TestScripts.Test.EndPub' ) |
以下是 .NET 方法 endPub 示例。它将向 MobiLink 消息日志输出一条消息。(请注意:将消息输出到 MobiLink 消息日志在开发时可能会有帮助,但会降低生产服务器的性能。)
public string EndPub( int generation_number, string user, string pub_name, DateTime last_publication_upload, DateTime last_publication_download ) { System.Console.Write( "Finished synchronizing publication " + pub_name ); return ( null ); } |
![]() |
使用DocCommentXchange 讨论此页。
|
版权 © 2010, iAnywhere Solutions, Inc. - SQL Anywhere 12.0.0 |