ATTACH TRACING-Anweisung

ATTACH TRACING TO { LOCAL DATABASE | connect-string } 
 [ LIMIT { size | history } ]

connect-string : Die Verbindungszeichenfolge für die Datenbank

size : SIZE nnn { MB | GB }

history : HISTORY nnn { MINUTES | HOURS | DAYS }

nnn : integer

connect-string Die Verbindungszeichenfolge ist zur Herstellung einer Verbindung mit der Datenbank erforderlich, die die Protokollierungsinformationen empfängt. Dieser Parameter ist nur erforderlich, wenn die Datenbank, deren Profil erstellt wird, eine andere als die Datenbank ist, die die Daten empfängt.
Die folgenden Verbindungsparameter sind in connect-string zulässig: DBF, DBKEY, DBN, Host, Server, ENG, LINKS, PWD, UID.

Geben Sie DBF relativ zu dem Datenbankserver an, mit dem Sie eine Verbindung herstellen möchten. Wenn Sie keinen anderen Datenbankserver angeben, versucht der Datenbankserver, mit dem Sie gerade verbunden sind, die durch den Verbindungsparameter DBF identifizierte Protokollierungsdatenbank zu starten.

Ein Fehler wird zurückgegeben, wenn Sie den DBF-Parameter mit den Verbindungsparametern LINKS oder SERVER angeben.
LIMIT-Klausel Die Umfangsbeschränkung für Daten, die in der Protokollierungsdatenbank gespeichert werden, entweder nach Größe oder nach Dauer.

Die ATTACH TRACING-Anweisung wird verwendet, um eine Protokollierungssitzung für die Datenbank zu starten, deren Profil Sie erstellen möchten. Sie können sie erst verwenden, nachdem eine Protokollierungsstufe gesetzt wurde. Sie setzen die Protokollierungsstufe, indem Sie entweder Sybase Central oder die sa_set_tracing_level-Systemprozedur verwenden.

Wenn eine Sitzung gestartet ist, werden Protokollierungsinformationen entsprechend den Protokollierungsstufen generiert, die in der sa_diagnostic_tracing_level-Tabelle festgelegt sind. Sie können die Protokollierungsdaten an Protokollierungstabellen in der Datenbank senden, deren Profil erstellt wird, indem Sie LOCAL DATABASE angeben. Oder Sie können die Protokollierungsdaten an eine separate Protokollierungsdatenbank senden, indem Sie eine Verbindungszeichenfolge (connect-string) für diese Datenbank angeben. Die Protokollierungsdatenbank muss bereits bestehen, und Sie müssen Zugriff darauf haben.

Sie können die Menge an Protokollierungsdaten beschränken, indem Sie die LIMIT SIZE- oder LIMIT HISTORY-Klauseln verwenden. Verwenden Sie die LIMIT SIZE-Klausel, wenn Sie den Umfang der Protokollierungsdaten auf eine bestimmte Größe, in MB oder GB, beschränken wollen. Verwenden Sie die LIMIT HISTORY-Klausel, um den Umfang der Protokollierungsdaten auf eine Zeitperiode, in Minuten, Stunden oder Tagen gemessen, beschränken wollen. Beispiel: HISTORY 8 DAYS beschränkt die Menge der Protokollierungsdaten in der Protokollierungsdatenbank auf 8 Tage.

Um eine Protokollierungssitzung zu starten, muss TCP/IP auf dem/den Datenbankserver(n) laufen, auf dem die Protokollierungsdatenbank und die Produktionsdatenbank ausgeführt werden.

Pakete, die potenziell sensitive Daten enthalten, sind auf der Netzwerkschnittstelle sichtbar, selbst wenn die Protokollierung eine lokale Datenbank verwendet. Für Sicherheitszwecke können Sie eine Verschlüsselung in der Verbindungszeichenfolge festlegen.

Die aktuellen für eine Datenbank gesetzten Protokollierungsstufen finden Sie in der sa_diagnostic_tracing_level-Tabelle.

Um festzustellen, wohin Protokollierungsdaten gesendet werden, untersuchen Sie die Datenbankeigenschaft SendingTracingTo.

Sie müssen mit der Datenbank verbunden sein, deren Profil erstellt wird, um diese Anweisung ausführen zu können.

Sie müssen die DIAGNOSTICS-Systemrolle und das MANAGE PROFILING-Systemprivileg haben.

Keine.

SQL/2008 Erweiterung des Herstellers.

Das folgende Beispiel setzt die Protokollierungsstufe auf 1, wobei die Systemprozedur sa_set_tracing_level verwendet wird. Dann wird eine Protokollierungssitzung gestartet. Für die lokale Datenbank generierte Protokollierungsdaten werden an die Protokollierungsdatenbank mytracingdb auf einem anderen Computer gesendet, wie durch die angegebene Verbindungszeichenfolge angezeigt. Ein Maximum von zwei Stunden an Protokollierungsdaten wird während der Protokollierungssitzung aufrecht erhalten. Das ATTACH TRACING-Anweisungsbeispiel wird in einer einzigen Zeile eingegeben.

CALL sa_set_tracing_level( 1 );
ATTACH TRACING TO 'uid=DBA;pwd=sql;server=remotedbsrv;dbn=mytracingdb;host=winxp-32'
 LIMIT HISTORY 2 HOURS;

ATTACH TRACING-Anweisung

Syntax

Parameter

Bemerkungen

Privilegien

Nebenwirkungen

Siehe auch

Standards und Kompatibilität

Beispiele