sa_user_defined_counter_add-Systemprozedur

sa_user_defined_counter_add( 
counter_name 
[, delta
[, apply_to_con
[, appy_to_db
[, apply_to_server ] ] ] ]
)

counter_name Verwenden Sie diesen VARCHAR(128)-Parameter, um den Namen des benutzerdefinierten Zählers anzugeben, dessen Wert Sie ändern wollen. Beispiele für Namen benutzerdefinierter Zähler sind UserDefinedCounterRate01 und UserDefinedCounterRaw01.
delta Verwenden Sie diesen BIGINT-Parameter, um den Betrag anzugeben, um den der benutzerdefinierte Zähler erhöht bzw. verringert werden soll. Standardwert ist "1".
apply_to_con Verwenden Sie diesen INTEGER-Parameter, um anzugeben, ob der Zählerwert für die aktuelle Verbindung angepasst werden soll. 0 bedeutet, dass der Wert nicht angepasst werden soll, und 1 bedeutet, dass der Wert angepasst werden soll. Standardwert ist "1".
apply_to_db Verwenden Sie diesen INTEGER-Parameter, um anzugeben, ob der Zählerwert für die Datenbank angepasst werden soll. 0 bedeutet, dass der Wert nicht angepasst werden soll, und 1 bedeutet, dass der Wert angepasst werden soll. Standardwert ist "1".
apply_to_server Verwenden Sie diesen INT-Parameter, um anzugeben, ob der Zählerwert für den Datenbankserver angepasst werden soll. 0 bedeutet, dass der Wert nicht angepasst werden soll, und 1 bedeutet, dass der Wert angepasst werden soll. Standardwert ist "1".

Diese Funktion gibt einen INTEGER-Statuscode zurück.

Diese Funktion gibt den Wert 1 zurück, wenn delta definiert ist, 0, wenn delta nicht definiert ist, und einen Fehlercode, wenn ein Fehler auftritt. Beispiele für Fehler:

Ein ungültiger Zählername
Ein ungültiger Wert für den apply_to_server-, apply_to_db- oder apply_to_con-Parameter.

Gleichzeitige Zugriffe auf Zähler werden in kleinsten Einheiten angewendet, sodass ein Zählerwert aus mehreren gleichzeitigen Anforderungen inkrementiert werden kann.

Benutzerdefinierte Zähler werden als 32-Bit-UNSIGNED INTEGER-Werte implementiert.

Sie müssen das SERVER OPERATOR-Systemprivileg haben.

Keine

Die folgende Anweisung erhöht den Wert von UserDefinedCounterRate01 für die aktuelle Verbindung, die aktuelle Datenbank und den aktuellen Datenbankserver um 2:

SELECT sa_user_defined_counter_add( 'UserDefinedCounterRate01', 2, 1, 1, 1 );

sa_user_defined_counter_add-Systemprozedur

Syntax

Argumente

Rückgabe

Bemerkungen

Privilegien

Nebenwirkungen

Siehe auch

Beispiel