Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (中文) » MobiLink - 服务器管理 » MobiLink 事件 » 同步事件

 

report_error 连接事件

可用于记录错误以及 handle_error 脚本选择的操作。

参数

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

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

SQL 脚本的参数名称

说明

顺序

s.action_code

INTEGER。这是一个 INOUT 参数。此参数是强制性的。

1

s.error_code

INTEGER。

2

s.error_message

TEXT。

3

s.remote_id VARCHAR(128)。MobiLink 远程 ID。只有在使用已命名的参数时才能引用远程 ID。 不适用

s.username

VARCHAR(128)。MobiLink 用户名。

4

s.table

VARCHAR(128)。

5

缺省操作

无。

注释

此脚本可用于记录错误以及 handle_error 脚本选择的操作。不管是否定义了 handle_error 脚本,此脚本都在 handle_error 事件之后执行。在与同步连接(管理/信息连接)不同的数据库连接上,它总是在其自己的事务中执行。

错误代码和错误消息可用于标识错误的性质。针对导致当前错误的 SQL 操作,对错误处理脚本的最后一次调用将返回操作代码值。

如果错误是作为同步的一部分发生的,则提供用户名。否则该值为空。

如果在操作某特定表时发生错误,则提供表名称。否则该值为空。表名是远程数据库中表的名称。此名称在统一数据库中是否存在直接对应的名称取决于同步系统的设计。

另请参见
SQL 示例

以下示例在 SQL Anywhere 统一数据库中运行。它将行插入用于记录同步错误的表中。

CALL ml_add_connection_script(
 'ver1',
 'report_error',
 'INSERT INTO sync_error(
   action_code,
   error_code,
   error_message,
   user_name,
   table_name )
  VALUES ( 
   {ml s.action_code}, 
   {ml s.error_code}, 
   {ml s.error_message}, 
   {ml s.username}, 
   {ml s.table} )'  )
Java 示例

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

CALL ml_add_java_connection_script(
   'ver1',
   'report_error',
   'ExamplePackage.ExampleClass.reportError' )

以下是 Java 方法 reportError 示例。它使用 MobiLink 提供的 JDBC 连接将错误记录到表中。它还将设置操作代码。

public String reportError(
  ianywhere.ml.script.InOutInteger actionCode,
  int errorCode, 
  String errorMessage, 
  String user,
  String table )
  throws java.sql.SQLException {
   // Insert error information in a table,
   JDBCLogError( _syncConn, errorCode, errorMessage,
    user, table );
   actionCode.setValue( getActionCode( errorCode ) );
   return( null ); 
}
.NET 示例

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

CALL ml_add_dnet_connection_script(
   'ver1',
   'report_error,
   'TestScripts.Test.ReportError' )

以下是 .NET 方法 ReportError 示例。它使用 .NET 方法将错误记录到表中。

public string ReportError(
  ref int actionCode,
  int errorCode, 
  string errorMessage, 
  string user,
  string table ) {
  LogError(_syncConn, errorCode, errorMessage, user, table);
}