time_statistics (Verbindungsereignis)

Verfolgt die statistischen Zeitdaten nach Benutzern und Ereignissen.

Parameter

In der folgenden Tabelle stellt die Beschreibung den SQL-Datentyp bereit. Wenn Sie Ihr Skript in Java oder .NET schreiben, müssen Sie den entsprechenden Datentyp benutzen. Weitere Hinweise finden Sie unter SQL-Java-Datentypen und SQL-.NET-Datentypen.

In SQL-Skripten können Sie Ereignisparameter mit ihrem Namen oder mit einem Fragezeichen angeben. Namen und Fragezeichen dürfen jedoch in einem Skript nicht gemischt verwendet werden. Wenn Sie Fragezeichen verwenden, müssen die Parameter in der nachfolgend gezeigten Reihenfolge stehen und sind nur dann optional, wenn keine nachfolgenden Parameter angegeben wurden (z.B. müssen Sie Parameter 1 verwenden, wenn Sie Parameter 2 verwenden möchten). Wenn Sie benannte Parameter verwenden, können Sie beliebige Teilmengen der Parameter in beliebiger Reihenfolge angeben.

Parametername für SQL-Skripten	Beschreibung	Reihenfolge
s.remote_id	VARCHAR(128). Die entfernte ID von MobiLink. Sie können die entfernte ID nur dann referenzieren, wenn Sie benannte Parameter verwenden.	Nicht anwendbar
s.username	VARCHAR(128). Der MobiLink-Benutzername	1
s.event_name	VARCHAR(128)	2
s.num_of_calls	INTEGER. Gibt an, wie häufig das Skript aufgerufen wurde.	3
s.minimum_time	INTEGER. Millisekunden. Die kürzeste Zeit, die zum Ausführen eines Skripts während dieser Synchronisation benötigt wird.	4
s.maximum_time	INTEGER. Millisekunden. Die längste Zeit, die zum Ausführen eines Skripts während dieser Synchronisation benötigt wird.	5
s.total_time	INTEGER. Millisekunden. Die Gesamtzeit, die zum Ausführen aller Skripten während der Synchronisation benötigt wird. (Dies ist nicht identisch mit der Länge/Dauer der Synchronisation.)	6

Standardaktion

Keine.

Bemerkungen

Mit dem Ereignis time_statistics können Sie während der Synchronisation für jeden beliebigen Benutzer statistische Zeitdaten sammeln. Die statistischen Daten werden nur für die Ereignisse gesammelt, für die es entsprechende Skripten gibt. Mit dem Skript werden in Fällen, wo ein Einzelereignis mehrmals eintritt, Aggregatdaten gesammelt. Das Skript kann besonders nützlich sein, wenn Zeitvergleiche zwischen Benutzern, Ereignissen und Tabellen durchgeführt werden sollen.

Siehe auch

SQL-Beispiel

Das folgende Beispiel fügt statistische Informationen in die Tabelle time_statistics ein.

CALL ml_add_connection_script(
  'ver1',
  'time_statistics',
  'INSERT INTO time_statistics (
    id, 
    ml_user, 
    table,
    event_name, 
    number_of_calls, 
    minimum_time, 
    maximum_time, 
    total_time)
   VALUES (
    ts_id.nextval,
    {ml s.username}, 
    {ml s.event_name}, 
    {ml s.number_of_calls}, 
    {ml s.minimum_time}, 
    {ml s.maximum_time}, 
    {ml s.total_time} ) ' )

Java-Beispiel

Der folgende Aufruf einer MobiLink-Systemprozedur registriert eine Java-Methode namens timeStatisticsConnection als das Skript für das Verbindungsereignis time_statistics, wenn die Skriptversion ver1 synchronisiert wird.

CALL ml_add_java_connection_script(
  'ver1',
  'time_statistics',
  'ExamplePackage.ExampleClass.timeStatisticsConnection' )

Im Folgenden sehen Sie die Java-Beispielmethode timeStatisticsConnection. Sie gibt Statistiken für das Ereignis prepare_for_download aus. (Die Ausgabe von Statistiken in das MobiLink-Nachrichtenlog ist zum Zeitpunkt der Entwicklung möglicherweise nützlich, verlangsamt aber einen Produktionsserver.)

public String timeStatisticsConnection(
  String username,
  String tableName,
  String eventName,
  int numberOfCalls, 
  int minimumTime, 
  int maximumTime,
  int totalTime ) {
  if( eventName.equals( "prepare_for_download") ) {
    java.lang.System.out.println(
     "prepare_for_download num_calls: " + numCalls +
     "total_time: " + totalTime ); 
  }
  return ( null );
}

.NET-Beispiel

Der folgende Aufruf einer MobiLink-Systemprozedur registriert eine .NET-Methode namens TimeStats als das Skript für das Verbindungsereignis time_statistics, wenn die Skriptversion ver1 synchronisiert wird.

CALL ml_add_dnet_connection_script(
  'ver1',
  'time_statistics',
  'TestScripts.Test.TimeStats'
)

Im Folgenden sehen Sie die .NET-Beispielmethode TimeStats. Sie gibt Statistiken für das Ereignis prepare_for_download aus. (Die Ausgabe von Statistiken in das MobiLink-Nachrichtenlog ist zum Zeitpunkt der Entwicklung möglicherweise nützlich, verlangsamt aber einen Produktionsserver.)

public string TimeStats(
  string user,
  string eventName,
  int numberOfCalls,
  int minimumTime,
  int maximumTime,
  int totTime ) {
  if( event_name=="prepare_for_download") {
    System.Console.WriteLine(
     "prepare_for_download num_calls: " + num_calls +
     "total_time: " + total_time ); 
  } 
  return ( null );
}

Kommentieren Sie diese Seite in DocCommentXchange.
Senden Sie uns Feedback über diese Seite via E-Mail.