22.12 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.

22.12.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, so genannte 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 und

• 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 22.12 com/tutego/insel/jdbc/TableMetaData.java

package com.tutego.insel.jdbc; 
 
import java.sql.*; 
import javax.naming.InitialContext; 
import javax.sql.DataSource; 
 
public class TableMetaData 
{ 
  public static void main( String[] args ) throws Exception 
  { 
    Connection con = ((DataSource) new InitialContext().lookup( 
          "UllisDS" )).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 
extends Wrapper

• ResultSetMetaData getMetaData() throws SQLException Liefert die Eigenschaften eines ResultSet in einem ResultSetMetaData zurück.

interface java.sql.ResultSetMetaData 
extends Wrapper

• int getColumnCount() Liefert die Anzahl der Spalten im aktuellen ResultSet. 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 ) Der Name der Spalte, so wie sie die Datenbank definiert.

• int getPrecision( int column ) 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 ) Der Tabellenname der angegebenen Spalte.

• boolean isAutoIncrement( int column ) Stellt fest, ob eine Spalte eine AutoIncrement-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 AutoIncrement-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 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 implementiert als !isReadOnly(column).

• 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.

22.12.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 Data-baseMetaData-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 22.13 com/tutego/insel/jdbc/DBMetaData.java, Ausschnitt

DatabaseMetaData meta = con.getMetaData(); 
 
System.out.println( "Produktname der Datenbank: " + 
                     meta.getDatabaseProductName() ); 
 
System.out.println( "Version der Datenbank: " + 
                     meta.getDatabaseProductVersion()  ); 
 
System.out.println( "Anzahl erlaubter Verbindungen: " + 
                     meta.getMaxConnections() ); 
 
System.out.println( "Version des DB-Treibers: " + 
                     meta.getDriverVersion() ); 
 
System.out.println( "Update im Batchbetrieb: " + 
                     meta.supportsBatchUpdates() ); 
 
System.out.println( "Gespeicherte Prozeduren: " + 
                     meta.supportsStoredProcedures() );

Ihr Kommentar