report_error 连接事件

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

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

SQL 脚本的参数名称	说明	顺序（不建议用于 SQL）
s.action_code	INTEGER。这是一个 INOUT 参数。此参数是强制性的。	1
s.error_code	INTEGER。本地 DBMS 错误代码。	2
s.error_message	TEXT。本地 DBMS 错误消息。	3
s.remote_id	VARCHAR(128)。MobiLink 远程 ID。只有在使用命名参数时才能引用远程 ID。	不适用
s.username	VARCHAR(128)。MobiLink 用户名。	4
s.table	VARCHAR(128)。引起错误的脚本所属的表。	5
s.script_version	VARCHAR(128)。可选的 IN 参数，可指定 MobiLink 服务器将用于当前同步的脚本版本字符串传递到此参数。不能使用问号指定此参数。	不适用

无。

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

如果错误是可恢复的，MobiLink 服务器会始终报告该错误，且 MobiLink 服务器将计划调用 handle_error 或 handle_odbc_error 脚本。例如，如果在 MobiLink 服务器尝试上载插入时发生错误，MobiLink 服务器会报告该错误并调用 handle_error 脚本。如果从 handle_script 返回的操作是 1000，则服务器会忽略该错误并继续同步。但是，如果 MobiLink 服务器在向统一数据库发送任何数据前检测到错误，则服务器不会报告错误，因为该错误是不可恢复的。更确切地说，MobiLink 服务器会报告由 ODBC 驱动程序和统一数据库生成的错误。

错误代码和错误消息可用于标识错误的性质。针对导致当前错误的 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} )'  )

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

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

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

package ExamplePackage; 
import java.sql.*;
import ianywhere.ml.script.*;
public class ExampleClass
{
    DBConnectionContext _cc;
    
    public ExampleClass( DBConnectionContext cc ) 
    {
	_cc = cc;
    }

    public void reportError( ianywhere.ml.script.InOutInteger	actionCode,
			     int				errorCode, 
			     String				errorMessage, 
			     String				user,
			     String				table )
	throws SQLException 
    {
	actionCode.setValue( errorCode );
	// Insert error information in a table,
	Connection conn = _cc.getConnection();
	PreparedStatement stmt = conn.prepareStatement( 
		"INSERT INTO sync_error( action_code, error_code, error_message, " +
		"user_name, table_name ) VALUES ( ?, ?, ?, ?, ? )" );
	stmt.setInt( 1, actionCode.getValue() );
	stmt.setInt( 2, errorCode );
	stmt.setString( 3, errorMessage );
	stmt.setString( 4, user );
	stmt.setString( 5, table ); 
	stmt.executeUpdate();
	stmt.close();
    }
}

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

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

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

using System;
using iAnywhere.MobiLink.Script;
namespace TestScripts
{ 
    public class Test
    {
	DBConnectionContext _cc;

	public Test( DBConnectionContext cc )
	{
	    _cc = cc;
	}
	
	public void ReportError( ref int actionCode,
				 int errorCode, 
				 string errorMessage, 
				 string user,
				 string table )
	{
	    actionCode = errorCode;
	    DBConnection conn = _cc.GetConnection();

	    DBCommand cmd = conn.CreateCommand();
	    cmd.CommandText = 
		"INSERT INTO sync_error( action_code, error_code, error_message, " +
		"user_name, table_name ) VALUES ( ?, ?, ?, ?, ? )";
	    cmd.Parameters[0] = actionCode;
	    cmd.Parameters[1] = errorCode;
	    cmd.Parameters[2] = errorMessage;
	    cmd.Parameters[3] = user;
	    cmd.Parameters[4] = table;
	    cmd.ExecuteNonQuery(); 
	} 
    }
}

report_error 连接事件

参数

缺省操作

注释

另请参见

SQL 示例

Java 示例

.NET 示例