Testet Verbindungen zu Datenbankservern und optional zu Datenbanken.
Syntaxdbping [ options ]| Option | Beschreibung | ||||
|---|---|---|---|---|---|
| @data |
Liest Optionen aus der angegebenen Umgebungsvariablen oder Konfigurationsdatei ein. Siehe Konfigurationsdateien. Wenn Sie Kennwörter oder andere Informationen in einer Konfigurationsdatei schützen möchten, können Sie das Dienstprogramm zum Verschleiern von Dateien (dbfhide) verwenden. Siehe Dienstprogramm zum Verschleiern von Dateien (dbfhide). |
||||
| -c "keyword=value; ..." |
Gibt die Verbindungsparameter an, die für die Verbindung mit dem Server und optional der Datenbank verwendet werden. Standardmäßig stellt dbping eine Verbindung zu einem laufenden Server her. Geben Sie die Option -d an, um eine Verbindung mit der Datenbank herzustellen. Siehe Testen, ob ein Datenbankserver gefunden werden kann (dbping). |
||||
| -d |
Testet die Verbindung mit der Datenbank. Falls erforderlich, kann dbping automatisch den Server und die Datenbank starten. Bei -d verhält sich dbping wie eine reguläre Clientanwendung, die eine Verbindung herstellt. Wenn Sie die Option -d angeben, meldet dbping nur dann einen Erfolg, wenn das Dienstprogramm eine Verbindung mit dem Server und auch mit einer Datenbank aufnehmen kann. Wenn Sie die Option -d nicht angeben, meldet dbping einen Erfolg, wenn der Server gefunden wird. Wenn zum Beispiel die Beispieldatenbank auf einem Datenbankserver namens blair läuft, ist der folgende Befehl erfolgreich, da dbping eine Verbindung mit dem Server blair aufnehmen kann:
Der folgende Befehl scheitert mit der Meldung
|
||||
| -en | Gibt an, dass dbping mit einem Fehlschlag-Rückgabecode beenden soll, wenn NULL für eine der angegebenen Eigenschaften zurückgegeben wird. Standardmäßig gibt dbping NULL aus, wenn der Wert einer durch die Optionen -pc, -pd oder -ps angegebenen Eigenschaften unbekannt ist, und beendet mit einem Erfolgs-Rückgabecode. Diese Option kann nur zusammen mit den Optionen -pc, -pd und -ps verwendet werden. | ||||
| -l library |
Gibt die zu verwendende ODBC-Bibliothek (ohne Dateierweiterung) an. Diese Option vermeidet die Verwendung des ODBC-Treibermanagers und ist daher unter Unix-Betriebssystemen nützlich. Beispiel: Der folgende Befehl lädt den ODBC-Treiber direkt:
Wenn Sie unter Unix eine Verbindungsbibliothek mit Threads verwenden wollen, müssen Sie die Thread-Version des Ping-Dienstprogramms, dbping_r, verwenden. |
||||
| -m | Stellt eine Verbindung mithilfe von ODBC her. Standardmäßig stellt das Dienstprogramm die Verbindung unter Verwendung der Embedded SQL-Schnittstelle her. | ||||
| -o filename | Schreibt Meldungen in die angegebene Datei. | ||||
| -pc property,... |
Zeigt die angegebenen Verbindungseigenschaften. Geben Sie die Eigenschaften in einer von Kommas unterteilten Liste ein. Sie müssen ausreichende Verbindungsinformationen angeben, um eine Datenbankverbindung herzustellen, wenn Sie diese Option verwenden. Siehe Zugreifen auf Werte von Verbindungseigenschaften. Beispiel: Der folgende Befehl zeigt die fire_triggers-Optionseinstellung, die als Verbindungseigenschaft verfügbar ist.
|
||||
| -pd property[@db-name],... |
Zeigt die angegebenen Datenbankeigenschaften. Geben Sie die Eigenschaften in einer von Kommas unterteilten Liste ein. Siehe Zugreifen auf Werte von Datenbankeigenschaften. Beispiel: Der folgende Befehl zeigt die Seitengröße an, die in der Datenbank verwendet wird.
Optional können Sie den Namen einer Datenbank angeben, die auf dem Datenbankserver läuft, von dem Sie den Wert beziehen wollen. Wenn der Datenbankname nicht durch Anhängen von @db-name an die Eigenschaft angegeben wurde, wird bei jeder aufgelisteten Eigenschaft der für die vorherige Eigenschaft verwendete Datenbankname verwendet. Der folgende Befehl zeigt die Seitengröße und Kollatierung der Datenbank mydb an:
|
||||
| -ps property,... |
Zeigt die angegebenen Datenbankservereigenschaften. Geben Sie die Eigenschaften in einer von Kommas unterteilten Liste ein. Sie müssen ausreichende Verbindungsinformationen angeben, um eine Datenbankverbindung herzustellen, wenn Sie diese Option verwenden. Siehe Zugreifen auf Werte von Datenbankservereigenschaften. Beispiel: Der folgende Befehl zeigt die Anzahl der lizenzierten Arbeitsplätze oder Prozessoren für den Datenbankserver an:
|
||||
| -q | Läuft im stillen Modus - Meldungen werden nicht angezeigt. | ||||
| -s | Gibt Informationen über die Performance des Netzwerks zwischen dem Computer, auf dem dbping ausgeführt wird, und dem Computer, der den Datenbankserver ausführt, zurück. Angenäherte Verbindungsgeschwindigkeit, Wartezeit und Durchsatz werden angezeigt. Die Option -c wird üblicherweise benötigt, um die Verbindungsparameter zum Verbinden mit einer Datenbank auf dem Server anzugeben. Sie können "dbping -s" nur bei Embedded SQL-Verbindungen verwenden. Diese Option wird ignoriert, wenn ebenfalls die Option -m oder -l angegeben ist. Standardmäßig führt "dbping -s" Schleifen durch die Anforderung für zumindest eine Sekunde bei jeder gemessenen Statistik durch. Es werden höchstens 200 Verbindungsherstellungen und -abbrüche durchgeführt, unabhängig von ihrer Dauer, um den Verbrauch zu großer Ressourcen zu verhindern. Auf langsameren Netzwerken kann es mehrere Sekunden dauern, um die Mindestanzahl an Wiederholungen bei jeder Statistik durchzuführen. Die Performancestatistiken sind angenäherte Statistiken. Sie sind genauer, wenn sowohl der Client- und der Servercomputer verhältnismäßig untätig sind. Siehe Performance der Embedded SQL- und Netzwerkverbindung prüfen (dbping). | ||||
| -st time | Diese Option gibt dieselben Informationen wie die Option -s zurück, nur dass die Option -st die Zeitspanne (in Sekunden) angibt, in der dbping die Anforderungen für die einzelnen Statistiken in Schleifen durchläuft. Diese Option ermöglicht es, genauere Zeitfolgeinformationen abzurufen als mit der Option -s. Siehe Performance der Embedded SQL- und Netzwerkverbindung prüfen (dbping). | ||||
| -z | Zeigt die Netzwerkkommunikationsprotokolle, die verwendet werden, um eine Verbindung zu versuchen, sowie andere Diagnosemeldungen an. Diese Option steht nur zur Verfügung, wenn eine Embedded SQL-Verbindung hergestellt wird. Das heißt, sie kann nicht mit -m oder -l kombiniert werden. |
BemerkungenDas Dienstprogramm dbping ist ein Tool, das zur Fehlersuche bei Verbindungsproblemen bereitgestellt wird. Es übernimmt eine vollständige oder teilweise Verbindungszeichenfolge und gibt eine Meldung zurück, in der angegeben wird, ob der Versuch zur Ermittlung des Serverstandorts oder der Verbindung zur Datenbank erfolgreich war.
Das Dienstprogramm kann bei Embedded SQL- oder ODBC-Verbindungen verwendet werden. Es kann nicht bei jConnect (TDS)-Verbindungen benutzt werden.
Beendigungscodes sind 0 (Erfolg) oder eine von 0 verschiedene Zahl (Fehlschlag).
Siehe auch |
Kommentieren Sie diese Seite in DocCommentXchange.
|
Copyright © 2012, iAnywhere Solutions, Inc. - SQL Anywhere 12.0.1 |