16.11 Metadaten *
Von einer Datenbank können verschiedene Informationen ausgelesen werden. Zum einen sind dies Informationen zu einer bestimmten Tabelle, zum anderen Informationen über die Datenbank selbst.
16.11.1 Metadaten über die Tabelle
Bei der Abfrage über alle Spalten müssen wir die Struktur der Datenbank kennen, insbesondere dann, wenn wir allgemeine Abfragen vornehmen und die passenden Daten herauslesen wollen. So liefert SELECT * FROM Item ein ResultSet mit der Anzahl der Spalten, wie sie die Tabelle Item hat. Doch bevor wir nicht die Anzahl und die Art der Spalten kennen, können wir nicht auf die Daten zugreifen.
Um diese Art von Informationen, sogenannte Metadaten, in Erfahrung zu bringen, befindet sich die Klasse ResultSetMetaData, mit der wir diese Informationen erhalten, unter den SQL-Klassen. Metadaten können für jede Abfrage angefordert werden. So lässt sich unter anderem leicht herausfinden:
- wie viele Spalten wir in einer Zeile abfragen können
- wie der Name der Spalte lautet
- welchen SQL-Typ die Spalte hat
- ob NULL für eine Spalte in Ordnung ist
- wie viele Dezimalzeichen eine Spalte hat
Einige Informationen über die Bestellelemente
Um Anzahl und Art der Spalten einer Bestelltabelle herauszufinden, werden wir zunächst ein ResultSet mit stmt.executeQuery("SELECT * FROM Item") erzeugen und dann via getMetaData() ein ResultSetMetaData-Objekt erfragen. Das ResultSetMetaData-Objekt besitzt viele Methoden, um Aussagen über die Tabelle und Spalten zu treffen. So fragen wir mit getColumnCount() nach, wie viele Spalten die Tabelle hat. Anschließend lässt sich für jede Spalte der Name und Typ erfragen:
Listing 16.9: com/tutego/insel/jdbc/TableMetaData.java, main()
Connection con = ((DataSource)
new InitialContext().lookup( "TutegoDS" )).getConnection();
try
{
ResultSet rs = con.createStatement().executeQuery( "SELECT * FROM ITEM" );
ResultSetMetaData meta = rs.getMetaData();
int numerics = 0;
for ( int i = 1; i <= meta.getColumnCount(); i++ )
{
System.out.printf( "%-20s %-20s%n", meta.getColumnLabel( i ),
meta.getColumnTypeName( i ) );
if ( meta.isSigned( i ) )
numerics++;
}
System.out.println();
System.out.println( "Spalten: " + meta.getColumnCount() +
", Numerisch: " + numerics );
}
finally
{
con.close ();
}
interface java.sql.ResultSet |
- ResultSetMetaData getMetaData() throws SQLException
Liefert die Eigenschaften eines ResultSet in einem ResultSetMetaData zurück.
interface java.sql.ResultSetMetaData |
- int getColumnCount()
Liefert die Anzahl der Spalten im aktuellen ResultSet. Das ist praktisch für SQL-Anweisungen wie SELECT *.
Allen folgenden Methoden wird ein int übergeben, das die Spalte kennzeichnet:
- String getCatalogName(int column)
Gibt den String mit dem Katalognamen der Tabelle für die angegebene Spalte zurück. - String getColumnName(int column)
Liefert den Spaltennamen der Tabelle. - int getColumnDisplaySize(int column)
Maximale Anzahl der Zeichen, die die Spalte einnimmt. So ist bei einer Spalte vom Typ VARCHAR(11) mit einer maximalen Spaltenbreite von zehn Zeichen zu rechnen. Bei numerischen Spalten variiert der Wert. - String getColumnLabel(int column)
Gibt einen String zurück, der den Titel der angegebenen Spalte enthält. Der Titel gibt an, welche Überschrift für die Spalte angezeigt werden soll. Einige Datenbanken erlauben die Unterscheidung zwischen Spaltennamen und Spaltentitel. - int getColumnType(int column)
Der Typ der Spalte wird ermittelt. Der Spaltentyp ist dabei eine Konstante aus der Klasse java.sql.Types. Sie deklariert Konstanten nach dem XOPEN-Standard. Die Reihenfolge der Datentypen ist: ARRAY_LOCATOR, BIGINT, BINARY, BIT, BLOB_LOCATOR, CHAR, CLOB_LOCATOR, DATE, DECIMAL, DISTINCT, DOUBLE, FLOAT, INTEGER, JAVA_OBJECT (benutzerdefinierter Datentyp), LONGVARBINARY, LONGVARCHAR, NULL, NUMERIC, REAL, REF, SMALLINT, STRUCT, STRUCT_LOCATOR, TIME, TIMESTAMP, TINYINT, VARBINARY, VARCHAR. Die Konstante OTHER zeigt ein datenbankspezifisches Element an und wird auf ein Java-Objekt abgebildet, falls ein Zugriff mittels getObject() oder setObject() erfolgt. - String getColumnTypeName(int column)
Liefert den Namen der Spalte, so wie sie die Datenbank definiert. - int getPrecision(int column)
Liefert die Dezimalgenauigkeit der Spalte, zurückgegeben als Anzahl der Ziffern. - int getScale(int column)
Liefert die Genauigkeit der Spalte. Dies ist die Anzahl der Stellen, die nach dem Dezimalpunkt verwendet werden können. - String getSchemaName(int column)
Der Name des Tabellenschemas. Wird von den Methoden des DatabaseMetaData-Objekts benutzt. Falls kein Schema vorhanden ist, wird "" zurückgegeben. - String getTableName(int column)
Liefert den Tabellennamen der angegebenen Spalte. - boolean isAutoIncrement(int column)
Stellt fest, ob eine Spalte eine Auto-Increment-Spalte ist. Diese nimmt dann automatisch den nächsten freien Wert an, wenn ein neuer Datensatz eingefügt wird. Ist die erste Zeile einer Tabelle mit einer Auto-Increment-Spalte eingefügt, so nimmt die Spalte den Wert 1 an. In den meisten Datenbanken ist es allerdings nicht möglich, eigene Werte in diesen Spalten einzutragen. - boolean isCaseSensitive(int column)
Berücksichtigt die Spalte die Groß- beziehungsweise Kleinschreibung? - boolean isCurrency(int column)
Enthält die Spalte Geldwerte? Nur einige Datenbanken bieten diesen Spaltentyp. - boolean isNullable(int column)
Ist ein SQL-NULL in der Spalte erlaubt? - boolean isSearchable(int column)
Kann die Spalte in einer SQL-WHERE-Klausel verwendet werden? - boolean isSigned(int column)
Enthält die Spalte vorzeichenbehaftete Datentypen? Vorzeichenbehaftete Typen sind unter anderem INT, LONGINT und SMALLINT. Vorzeichenlose Typen sind unter anderem UINT, ULONG und UBYTE. - boolean isReadOnly(int column)
Ist es möglich, auf die Spalte definitiv nicht schreibend zuzugreifen? Ist das Ergebnis true, kann der Wert also nicht aktualisiert werden. - boolean isWritable(int column)
Ist es prinzipiell möglich, auf die Spalte schreibend zuzugreifen? Häufig wird das als !isReadOnly(column) implementiert. - boolean isDefinitelyWritable(int column)
Kann auf die Spalte definitiv schreibend zugegriffen werden? Viele Datenbanken liefern die gleichen Ergebnisse bei isDefinitelyWritable() und isWritable(). Prinzipiell könnte der Zustand von isWritable() abweichen, wenn sich zum Beispiel die Schreibbarkeit dynamisch ändert.
Alle Methoden können eine SQLException auslösen.
16.11.2 Informationen über die Datenbank
Metadaten sind auch für die gesamte Datenbank abfragbar. Beispiele für diese Informationen sind:
- Welche Tabellen liegen in der Datenbank?
- Wer ist mit der Datenbank verbunden?
- Kann die Datenbank nur gelesen oder kann auch in die Datenbank geschrieben werden?
- Wie lauten die Primärschlüssel für eine Tabelle?
- Sind gespeicherte Prozeduren auf der Datenbankseite erlaubt?
- Lassen sich äußere Joins (outer joins) durchführen?
Sind Informationen über die Datenbank gefragt, so lassen sich über Metadaten eines DatabaseMetaData-Objekts beispielsweise Datenbankeigenschaften des Herstellers herausfinden. Zunächst benötigen wir dazu ein DatabaseMetaData-Objekt, das uns getMetaData() von einer Connection gibt. Das DatabaseMetaData-Objekt deklariert eine große Anzahl Methoden:
Listing 16.10: com/tutego/insel/jdbc/DBMetaData.java, Ausschnitt
DatabaseMetaData meta = con.getMetaData();
System.out.println( "Product name " + meta.getDatabaseProductName() );
System.out.println( "Version: " + meta.getDatabaseProductVersion() );
System.out.println( "Maximum number of connections: " + meta.getMaxConnections() );
System.out.println( "JDBC driver version: " + meta.getDriverVersion() );
System.out.println( "Supports update in batch: " + meta.supportsBatchUpdates() );
System.out.println( "Supports stored procedures: " + meta.supportsStoredProcedures() );
Ihr Kommentar
Wie hat Ihnen das <openbook> gefallen? Wir freuen uns immer über Ihre freundlichen und kritischen Rückmeldungen.
