getCatalogs-Methode (SQLServerDatabaseMetaData)

JDBC-Treiber herunterladen

Ruft die Katalognamen ab, die auf dem Server verfügbar sind, mit dem eine Verbindung besteht.

Syntax

  
public java.sql.ResultSet getCatalogs()  

Rückgabewert

Ein SQLServerResultSet-Objekt.

Ausnahmen

SQLServerException

Bemerkungen

Diese getCatalogs-Methode wird von der getCatalogs-Methode in der java.sql.DatabaseMetaData-Schnittstelle angegeben.

Hinweis

Sie sollten in Azure SQL-Datenbank eine Verbindung mit der Datenbank master herstellen, um SQLServerDatabaseMetaData.getCatalogs aufzurufen. SQL-Datenbank unterstützt nicht die Rückgabe sämtlicher Kataloge aus einer Benutzerdatenbank. SQLServerDatabaseMetaData.getCatalogs verwendet die Ansicht sys.databases, um die Kataloge abzurufen.

Das von der getCatalogs-Methode zurückgegebene Resultset enthält die folgenden Informationen:

Name	Typ	BESCHREIBUNG
TABLE_CAT	String	Der Name des Katalogs, einschließlich der Systemdatenbanken in Microsoft SQL Server

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie die getCatalogs-Methode verwendet wird, um die Namen aller Datenbanken einschließlich der Systemdatenbanken zurückzugegeben, die in Microsoft SQL Server enthalten sind.

public static void executeGetCatalogs(Connection con) {  
   try {  
      DatabaseMetaData dbmd = con.getMetaData();  
      ResultSet rs = dbmd.getCatalogs();  
      ResultSetMetaData rsmd = rs.getMetaData();  
  
      // Display the result set data.  
      int cols = rsmd.getColumnCount();  
      while(rs.next()) {  
         for (int i = 1; i <= cols; i++) {  
            System.out.println(rs.getString(i));  
         }  
      }  
      rs.close();  
   }   
  
   catch (Exception e) {  
      e.printStackTrace();  
   }  
}  

Weitere Informationen

SQLServerDatabaseMetaData-Methoden
SQLServerDatabaseMetaData-Elemente
SQLServerDatabaseMetaData-Klasse