synchronization_statistics 连接事件

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

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

SQL 脚本的参数名称	说明	顺序（不建议用于 SQL）
s.remote_id	VARCHAR(128)。MobiLink 远程 ID。只有在使用命名参数时才能引用远程 ID。	不适用
s.username	VARCHAR(128)。MobiLink 用户名。	1
s.warnings	INTEGER。同步过程中发出的警告的数目。	2
s.errors	INTEGER。同步过程中发生的错误数。	3
s.deadlocks	INTEGER。统一数据库中为同步已检测到的死锁的数目。	4
s.synchronized_tables	INTEGER。同步中涉及的客户端表数。	5
s.connection_retries	INTEGER。MobiLink 服务器重试连接统一数据库的次数。	6

无。

synchronization_statistics 事件可用于为任何用户和连接收集有关当前同步的各种统计信息。synchronization_statistics 连接脚本在最终同步事务结束时执行提交操作之前被调用。

注意

并不是所有警告都被记录下来，是否记录取决于命令行。传递到该脚本的警告计数是在未禁用任何警告时将被记录的警告的数量，该数量可能大于已记录警告的数量。

下面的示例在 sync_con_audit 表中插入同步统计信息。

CALL ml_add_connection_script(
  'ver1',
  'synchronization_statistics',
 'INSERT INTO sync_con_audit(
   ml_user, 
   warnings, 
   errors,
   deadlocks, 
   synchronized_tables,
   connection_retries)
  VALUES (
   {ml s.username}, 
   {ml s.warnings}, 
   {ml s.errors}, 
   {ml s.deadlocks}, 
   {ml s.synchronized_tables}, 
   {ml s.connection_retries})' )

在审计表中插入统计信息之后，您将可以使用这些统计信息监控同步过程，并在条件允许时进行优化。

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

CALL ml_add_java_connection_script(
  'ver1',
  'synchronization_statistics',
  'ExamplePackage.ExampleClass.synchronizationStatisticsConnection'
)

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

package ExamplePackage;
public class ExampleClass {
    String _curUser = null;
public String synchronizationStatisticsConnection(
  String user, 
  int warnings, 
  int errors, 
  int deadlocks,
  int synchronizedTables, 
  int connectionRetries ) {
  java.lang.System.out.println( 
   "synch statistics number of deadlocks: " 
   + deadlocks );
  return( null ); 
}}

以下对 MobiLink 系统过程的调用在同步脚本版本 ver1 时将名为 SyncStats 的 .NET 方法注册为 synchronization_statistics 连接事件的脚本。

CALL ml_add_dnet_connection_script(
  'ver1',
  'synchronization_statistics',
  'TestScripts.Test.SyncStats'
)

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

namespace TestScripts
{
    public class Test
    {
	public void SyncStats( string	user,
			       int	warnings,
			       int	errors,
			       int	deadLocks,
			       int	syncedTables,
			       int	connRetries ) 
	{
	    System.Console.WriteLine( "synch statistics number of deadlocks: " + deadLocks );
	}
    }
}

synchronization_statistics 连接事件

参数

缺省操作

注释

注意

另请参见

SQL 示例

Java 示例

.NET 示例