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. Weitere Hinweise finden Sie unter 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 verwenden. Weitere Hinweise finden Sie unter Dienstprogramm zum Verschleiern von Dateien (dbfhide).
-c Optionen	Legt Verbindungsparameter fest. Weitere Hinweise finden Sie unter 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 Exel-Datei an. Wenn kein Name angegeben wird, werden Sie von Excel mit einem Fenster Speichern unter zur Eingabe eines Namens aufgefordert.

Bemerkungen

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, und Sie müssen Excel 97 oder später installiert haben.

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. Weitere Hinweise finden Sie unter 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. Weitere Hinweise finden Sie unter ESTIMATE-Funktion [Verschiedene] und ESTIMATE_SOURCE-Funktion [Verschiedene].

Die Tabellen werden mit dem Spaltennamen benannt. Spaltennamen werden ab 24 Zeichen gekürzt, und jedes Auftreten von "\", "/", "?", "*", "[", "]" und ":" (die in 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 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). Weitere Hinweise finden Sie unter Beendigungscodes der Softwarekomponenten.

Sie können Histogramme auch mit der gespeicherten Prozedur sa_get_histogram abrufen. Weitere Hinweise finden Sie unter sa_get_histogram-Systemprozedur.

Beispiel

Der folgende Befehl (auf einer Zeile eingegeben) erstellt ein Excel-Diagramm für die Spalte ProductID in der Tabelle SalesOrderItems für die Datenbank demo.db und speichert es als 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 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.
Senden Sie uns Feedback über diese Seite via E-Mail.