download_statistics テーブルイベント

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

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

SQL スクリプトのパラメーター名	説明	順序 (SQL では非推奨)
s.remote_id	VARCHAR(128)。Mobile Link リモート ID。名前付きパラメーターを使用している場合のみ、リモート ID を参照できます。	適用不可
s.username	VARCHAR(128)。SYNCHRONIZATION USER 定義に指定した Mobile Link ユーザー名。	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})')

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

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

次に示すのは、サンプルの Java メソッド downloadStatisticsTable です。このメソッドは、このテーブルの統計を Mobile Link メッセージログに出力します (テーブルの統計を Mobile Link メッセージログに出力すると、開発時には便利ですが、運用サーバーのパフォーマンスが遅くなります)。

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 );
}}

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

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

次に示すのは、サンプルの .NET メソッド DownloadTableStats です。このメソッドは、このテーブルの統計を Mobile Link メッセージログに出力します (テーブルの統計を Mobile Link メッセージログに出力すると、開発時には便利ですが、運用サーバーのパフォーマンスが遅くなります)。

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 の例