iAnywhere.com - download_statistics 表事件

download_statistics 表事件

功能

按照表跟踪有关下载操作的同步统计信息。

参数

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

只有当未指定任何后续参数时，事件参数才是可选的。例如，如果要使用参数 2，您必须使用参数 1。

项	参数	说明
1	ml_username	VARCHAR(128)。这是在 SYNCHRONIZATION USER 定义中指定的 MobiLink 用户名。
2	table	VARCHAR(128)。表名。
3	warnings	INTEGER。发出的警告的数目。
4	errors	INTEGER。发生的错误的数目，包括已处理的错误。
5	fetched_rows	INTEGER。download_cursor 脚本读取的行数。
6	deleted_rows	INTEGER。download_deletes 脚本读取的行数。
7	filtered_rows	INTEGER。从 (6) 实际发送到远程数据库的行数。它反映了已上载的值的下载过滤。
8	bytes	INTEGER。作为下载发送到远程数据库的字节数。

缺省操作

无。

说明

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

另请参见

SQL 示例

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

call ml_add_java_table_script(
  'ver1',
  'table1',
  'download_statistics',
'INSERT INTO download_audit (
  user_name, table, warnings, errors,
  deleted_rows, fetched_rows, download_rows, bytes)
VALUES (?,?,?,?,?,?,?,?)')

Java 示例

下面的存储过程调用在同步脚本版本 ver1 时将名为 downloadStatisticsTable 的 Java 方法注册为 download_statistics 表事件的脚本。

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

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

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

.NET 示例

下面的存储过程调用在同步脚本版本 ver1 和表 table1 时将名为 DownloadTableStats 的 .NET 方法注册为 download_statistics 表事件的脚本。

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

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

public void DownloadTableStats(
  string user,
  string table,
  int warnings,
  int errors,
  int deletedRows,
  int fetchedRows,
  int downloadRows,
  int bytes )
{  System.Console.WriteLine( "download table stats "
   + "table: " + table + "bytes: " + bytes );
   return( null ); }