Histogramm-Dienstprogramm (dbhist)

Konvertiert ein Histogramm in ein Microsoft Excel-Diagramm mit Informationen über die Selektivität von Prädikaten

Syntax

dbhist [ Optionen ] -t Tabellenname [ Excel_Ausgabe_Dateiname ]

Option	Beschreibung
@data	Liest Optionen aus der angegebenen Umgebungsvariablen oder Konfigurationsdatei ein. Siehe Konfigurationsdateien verwenden. 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 Optionen	Legt Verbindungsparameter fest. Siehe Verbindungsparameter.
-n Spaltenname	Gibt den Namen der Spalte an, mit der das Histogramm verknüpft werden soll. Wenn Sie keine Spalte angeben, werden alle Spalten in der Tabelle, die Histogramme haben, zurückgegeben.
-t Tabellenname	Gibt den den Namen der Tabelle oder materialisierten Ansicht an, für die ein Diagramm erstellt werden soll.
-u Eigentümer	Gibt den Eigentümer der Tabelle oder materialisierten Ansicht an.
Excel-Ausgabename	Gibt den Namen der generierten Microsoft Excel-Datei an. Wenn kein Name angegeben wird, werden Sie von Microsoft Excel mit dem Fenster Speichern unter zur Eingabe eines Namens aufgefordert.

Histogramme werden in der Systemtabelle ISYSCOLSTAT gespeichert und können auch mit der Prozedur sa_get_histogram abgerufen werden. Das Histogramm-Dienstprogramm konvertiert ein Histogramm in ein Microsoft Excel-Diagramm mit Informationen über die Selektivität von Prädikaten. Das Histogramm-Dienstprogramm (dbhist) funktioniert nur unter Windows. Außerdem muss Microsoft Excel 97 oder später installiert sein.

Statistiken (einschließlich Histogramme) sind möglicherweise für eine Tabelle oder materialisierte Ansicht nicht vorhanden, beispielsweise wenn Statistiken kürzlich gelöscht wurden. In diesem Fall gibt das Histogramm-Dienstprogramm die Meldung Histogramm enthält keine Daten, Vorgang wird abgebrochen zurück. In diesem Fall müssen Sie die Statistiken erstellen und dann das Histogramm-Dienstprogramm neuerlich ausführen. Um Statistiken für eine Tabelle oder eine materialisierte Ansicht zu erstellen, führen Sie eine CREATE STATISTICS-Anweisung aus. Siehe CREATE STATISTICS-Anweisung.

Um die Selektivität eines Prädikats über eine Zeichenfolgenspalte zu ermitteln, müssen Sie die Funktionen ESTIMATE oder ESTIMATE_SOURCE verwenden. Wenn Sie versuchen, ein Histogramm aus Zeichenfolgenspalten abzurufen, geben sa_get_histogram und das Histogramm-Dienstprogramm einen Fehler aus.

Die Tabellen werden mit dem Spaltennamen benannt. Spaltennamen werden ab 24 Zeichen gekürzt. Jedes Auftreten von "\", "/", "?", "*", "[", "]" und ":" (die in Microsoft Excel nicht zulässig sind) wird durch Unterstriche ( _ ) ersetzt. Diagrammnamen wird das Wort "chart" vorangestellt, gefolgt von denselben Namenskonventionen wie oben. Doppelt vorkommende Namen (aufgrund von Zeichenersetzungen, Kürzungen oder mit "chart" beginnenden Spaltennamen) ergeben einen Microsoft Excel-Fehler, der besagt, dass keine Duplikatnamen verwendet werden dürfen. Die Tabelle wird dennoch mit jenen Namen erstellt, die mit ihrer früheren Version erstellt wurden (Sheet1, Chart1 usw.).

Beendigungscodes sind 0 (Erfolg) oder eine von 0 verschiedene Zahl (Fehlschlag). Siehe Beendigungscodes der Softwarekomponenten.

Sie können Histogramme auch mit der gespeicherten Prozedur sa_get_histogram abrufen.

Beispiel

Der folgende Befehl (auf einer Zeile eingegeben) erstellt ein Microsoft Excel-Diagramm für die Spalte "ProductID" in der Tabelle "SalesOrderItems" für die Datenbank demo.db und speichert es unter histogram.xls.

dbhist -c "UID=DBA;PWD=sql;DBF=Beispielverzeichnis\demo.db" -n ProductID -t SalesOrderItems histogram.xls

Die folgende Anweisung generiert für jede Spalte mit einem Histogramm in der Tabelle SalesOrders Diagramme. Dies geschieht unter der Annahme, dass die Beispieldatenbank bereits gestartet ist. Diese Anweisung versucht außerdem, eine Verbindung mittels UID=DBA und PWD=sql herzustellen. Für die Ausgabedatei ist kein Name angegeben, daher werden Sie von Microsoft Excel aufgefordert, einen Namen einzugeben.

dbhist -t SalesOrders -c "UID=DBA;PWD=sql"

Hinweise zum Beispielverzeichnis finden Sie unter Beispielverzeichnis.

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.