end_upload テーブルイベント

Mobile Link サーバがアップロードされた挿入、更新、削除の処理を終了した直後に、特定のテーブルに関連した文を処理します。

パラメータ

次の表の説明では、SQL データ型を示します。Java または .NET でスクリプトを作成する場合、適切な対応するデータ型を使用します。 SQL データ型と Java データ型とSQL データ型と .NET データ型を参照してください。

SQL スクリプトでは、名前または疑問符を使用してイベントパラメータを指定できます。疑問符の使用は推奨されなくなりました。名前付きパラメータを使用することをおすすめします。1 つのスクリプト内で名前と疑問符を混在させることはできません。疑問符を使用する場合、パラメータは以下に示す順に指定する必要があり、後続のパラメータが指定されていない場合のみ省略可能です (たとえば、パラメータ 2 を使用する場合は、パラメータ 1 を使用してください)。名前付きパラメータを使用する場合は、パラメータの任意のサブセットを任意の順に指定できます。

パラメータ	説明	順序 (SQL では非推奨)
s.remote_id	VARCHAR(128)。Mobile Link リモート ID。名前付きパラメータを使用している場合のみ、リモート ID を参照できます。	適用外
s.username	VARCHAR(128)。Mobile Link ユーザ名。	1
s.table	VARCHAR(128)。テーブル名。	2
s.script_version	VARCHAR(128)。Mobile Link サーバが現在の同期に使用しているスクリプトバージョン文字列をこのパラメータに渡すことを指定する、オプションの IN パラメータ。このパラメータの指定に疑問符を使用することはできません。	適用外

デフォルトのアクション

備考

Mobile Link サーバは、アップロードした情報を処理する最後の手順としてこのスクリプトを実行します。アップロード情報は別のトランザクションで処理されます。このスクリプトの実行が、このトランザクションで最後のテーブル固有のアクションになります。

リモートデータベースのテーブルごとに、end_upload スクリプトを 1 つ指定できます。

参照

SQL の例

次の Mobile Link システムプロシージャコールは end_upload イベントを、ULCustomerIDPool_maintain というストアドプロシージャに割り当てます。

CALL ml_add_table_script(
   'custdb',
   'ULCustomerIDPool',
   'end_upload', 
   '{ CALL ULCustomerIDPool_maintain( {ml s.username} ) }' )

次の SQL 文は ULCustomerIDPool_maintain ストアドプロシージャを作成します。このプロシージャは、新しいプライマリキーをプライマリキープールに挿入して、アップロードしたばかりのローで使用されているキーを置き換えます。プライマリキープールは、後で同じ同期でリモートデータベースにダウンロードされます。

CREATE PROCEDURE ULCustomerIDPool_maintain ( IN syncuser_id INTEGER )
BEGIN
    DECLARE pool_count INTEGER;

    -- Determine how many ids to add to the pool
    SELECT COUNT(*) INTO pool_count
        FROM ULCustomerIDPool WHERE pool_emp_id = syncuser_id;

    -- Top up the pool with new ids
    WHILE pool_count < 20 LOOP
        INSERT INTO ULCustomerIDPool ( pool_emp_id ) VALUES ( syncuser_id );
        SET pool_count = pool_count + 1;
    END LOOP;
END

Java の例

次の Mobile Link システムプロシージャコールは、スクリプトバージョン ver1 を同期するときに、endUploadTable という Java メソッドを end_upload テーブルイベント用のスクリプトとして登録します。

CALL ml_add_java_table_script(
   'ver1',
   'table1',
   'end_upload',
   'ExamplePackage.ExampleClass.endUploadTable' )

次に示すのは、サンプルの Java メソッド endUploadTable です。このメソッドは、渡されたテーブル名と関連する名前のテーブルに対する削除を生成します。これは SQL Anywhere 統合データベース用の構文です。

package ExamplePackage;
public class ExampleClass {
  String _curUser = null; 
public void endUploadTable(
  String user,
  String table ) {
  return( "DELETE from '" + table + "_temp'" ); 
}}

.NET の例

次の Mobile Link システムプロシージャコールは、スクリプトバージョン ver1 とテーブル table1 を同期するときに、EndUpload という .NET メソッドを end_upload テーブルイベント用のスクリプトとして登録します。

CALL ml_add_dnet_table_script(
   'ver1',
   'table1',
   'end_upload',
   'TestScripts.Test.EndUpload'
)

次の .NET サンプルは、テンポラリテーブルに挿入されたローを、スクリプトに渡されたテーブルに移動します。

using iAnywhere.MobiLink.Script;
namespace TestScripts 
{
    public class Test 
    {
	DBConnection	_curConn = null;
	
	public Test( DBConnectionContext cc ) 
	{
	    _curConn = cc.GetConnection();
	}
	public void EndUpload( string user, string table ) 
	{
	    DBCommand stmt = _curConn.CreateCommand();
	    // Move the uploaded rows to the destination table.
	    stmt.CommandText = "INSERT INTO "
		    + table
		    + " SELECT * FROM dnet_ul_temp";
	    stmt.ExecuteNonQuery();
	    stmt.Close();
	}
    }
}

DocCommentXchange で意見交換できます