download_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)。在 SYNCHRONIZATION USER 定义中指定的 MobiLink 用户名。	1
s.table	VARCHAR(128)。表名。	2
s.warnings	INTEGER。发出的警告的数目。	3
s.errors	INTEGER。发生的错误的数目，包括已处理的错误。	4
s.fetched_rows	INTEGER。download_cursor 脚本读取的行数。	5
s.deleted_rows	INTEGER。download_delete_cursor 脚本读取的行数。	6
s.filtered_rows	INTEGER。从 fetched_rows 中过滤出的行的数量。它反映了已上载的值的下载过滤。	7
s.bytes	INTEGER。作为下载发送到远程数据库的字节数。	8

无。

download_statistics 事件可用于为所有用户和表收集关于下载（当它们应用于该表时）的统计信息。download_statistics 表脚本紧接在下载事务结束时执行提交操作之前被调用。

注意

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

以下示例将同步统计插入一个名为 download_audit 的表中。在审计表中插入重要的统计信息之后，您将可以使用这些统计信息监控同步过程并在条件允许时进行优化。

CALL ml_add_table_script(
 'ver1',
 'table1',
 'download_statistics',
 'INSERT INTO download_audit (
   user_name, 
   table, warnings, 
   errors,
   fetched_rows,
   deleted_rows,  
   filtered_rows, 
   bytes)
  VALUES (
   {ml s.username}, 
   {ml s.table}, 
   {ml s.warnings}, 
   {ml s.errors}, 
   {ml s.fetched_rows}, 
   {ml s.deleted_rows}, 
   {ml s.filtered_rows}, 
   {ml s.bytes})')

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

CALL ml_add_java_table_script(
  'ver1',
  'table1',
  'download_statistics',
  'ExamplePackage.ExampleClass.downloadStatisticsTable' )

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

package ExamplePackage;
public class ExampleClass {
  String _curUser = null;
public String downloadStatisticsTable(
  String user,
  String table,
  int warnings,
  int errors,
  int fetchedRows,
  int deletedRows,
  int filteredRows,
  int bytes ) {
  java.lang.System.out.println( "download table stats "
   + "table: " + table + "bytes: " + bytes );
  return ( null );
}}

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

CALL ml_add_dnet_table_script(
 'ver1',
 'table1',
 'download_statistics',
 'TestScripts.Test.DownloadTableStats'
)

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

namespace TestScripts {
public class Test {
  string _curUser = null;       
public string DownloadTableStats(
  string user,
  string table,
  int warnings,
  int errors,
  int fetchedRows,
  int deletedRows,
  int filteredRows,
  int bytes ) {
  System.Console.WriteLine( "download table stats "
   + "table: " + table + "bytes: " + bytes );
  return ( null );
}}}

download_statistics 表事件

参数

缺省操作

注释

注意

另请参见

SQL 示例

Java 示例

.NET 示例