getProcedureColumns-Methode (SQLServerDatabaseMetaData)

Artikel
2025-01-02

Ruft eine Beschreibung der Parameter gespeicherter Prozeduren und Ergebnisspalten ab.

Syntax

  
public java.sql.ResultSet getProcedureColumns(java.lang.String sCatalog,  
                                              java.lang.String sSchema,  
                                              java.lang.String proc,  
                                              java.lang.String col)

Parameter

sCatalog

Ein String-Objekt, das den Katalognamen enthält. Durch Festlegen dieses Parameters auf NULL wird angegeben, dass der Katalogname nicht verwendet werden muss.

sSchema

Ein String-Objekt, das das Schemanamenmuster enthält. Durch Festlegen dieses Parameters auf NULL wird angegeben, dass der Schemaname nicht verwendet werden muss.

proc

Ein String-Objekt, das das Prozedurnamenmuster enthält.

col

Ein String-Objekt, das das Spaltennamensmuster enthält. Wird für diesen Parameter NULL angegeben, wird für jede Spalte eine Zeile zurückgegeben.

Rückgabewert

Ein SQLServerResultSet-Objekt.

Ausnahmen

SQLServerException

Bemerkungen

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

Das von der getProcedureColumns-Methode zurückgegebene Resultset enthält folgende Informationen:

Name	Typ	Beschreibung
PROCEDURE_CAT	String	Der Name der Datenbank, in der sich die angegebene gespeicherte Prozedur befindet.
PROCEDURE_SCHEM	String	Das Schema für die gespeicherte Prozedur.
PROCEDURE_NAME	String	Name der gespeicherten Prozedur
COLUMN_NAME	String	Der Name der Spalte.
COLUMN_TYPE	short	Der Typ der Spalte. Es kann sich um einen der folgenden Werte handeln: procedureColumnUnknown (0) procedureColumnIn (1) procedureColumnInOut (2) procedureColumnOut (4) procedureColumnReturn (5) procedureColumnResult (3)
DATA_TYPE	smallint	Der SQL-Datentyp aus "java.sql.Types".
TYPE_NAME	String	Der Name des Datentyps.
PRECISION	int	Die Gesamtanzahl von signifikanten Stellen.
LENGTH	int	Die Länge der Daten in Bytes
SCALE	short	Die Anzahl der Ziffern rechts vom Dezimaltrennzeichen.
RADIX	short	Die Basis für numerische Typen.
NULLABLE	short	Gibt an, ob die Spalte einen NULL-Wert enthalten kann. Es kann sich um einen der folgenden Werte handeln: procedureNoNulls (0) procedureNullable (1) procedureNullableUnknown (2)
ANMERKUNGEN	String	Die Beschreibung der Prozedurspalte. Hinweis: SQL Server gibt für diese Spalte keinen Wert zurück.
COLUMN_DEF	String	Der Standardwert der Spalte.
SQL_DATA_TYPE	smallint	Diese Spalte entspricht der DATA_TYPE-Spalte mit Ausnahme der datetime- und ISO-interval-Datentypen.
SQL_DATETIME_SUB	smallint	Wenn SQL_DATA_TYPE den Wert SQL_DATETIME oder SQL_INTERVAL aufweist, enthält diese Spalte den Subcode für datetime ISO interval. Bei anderen Datentypen als datetime und ISO interval ist diese Spalte NULL.
CHAR_OCTET_LENGTH	int	Die maximale Anzahl von Bytes in der Spalte.
ORDINAL_POSITION	int	Der Index der Spalte innerhalb der Tabelle.
IS_NULLABLE	String	Gibt an, ob in der Spalte NULL-Werte zulässig sind.
SS_TYPE_CATALOG_NAME	String	Der Name des Katalogs, der den benutzerdefinierten Typ (UDT) enthält.
SS_TYPE_SCHEMA_NAME	String	Der Name des Schemas, der den benutzerdefinierten Typ (UDT) enthält.
SS_UDT_CATALOG_NAME	String	Der benutzerdefinierte Typ (UDT) für den vollqualifizierten Namen.
SS_UDT_SCHEMA_NAME	String	Der Name des Katalogs, in dem ein XML-Schemasammlungsname definiert ist. Wenn der Katalogname nicht gefunden werden kann, enthält diese Variable eine leere Zeichenfolge.
SS_UDT_ASSEMBLY_TYPE_NAME	String	Der Name des Schemas, in dem eine XML-Schemaauflistung definiert ist. Wenn der Schemaname nicht gefunden werden kann, handelt es sich dabei um eine leere Zeichenfolge.
SS_XML_SCHEMACOLLECTION_CATALOG_NAME	String	Name der XML-Schemaauflistung. Wenn der Name nicht gefunden werden kann, handelt es sich dabei um eine leere Zeichenfolge.
SS_XML_SCHEMACOLLECTION_SCHEMA_NAME	String	Der Name des Katalogs, der den benutzerdefinierten Typ (UDT) enthält.
SS_XML_SCHEMACOLLECTION_NAME	String	Der Name des Schemas, der den benutzerdefinierten Typ (UDT) enthält.
SS_DATA_TYPE	tinyint	Der SQL Server-Datentyp, der von erweiterten gespeicherten Prozeduren verwendet wird. Hinweis: Weitere Informationen zu den Datentypen, die von SQL Server zurückgegeben werden, finden Sie in der SQL Server-Onlinedokumentation unter „Datentypen (Transact-SQL)“.

Hinweis

Weitere Informationen zu den Daten, die von der getProcedureColumns-Methode zurückgegeben werden, finden Sie in der SQL Server-Onlinedokumentation unter „sp_sproc_columns (Transact-SQL)“.

Beispiel

Das folgende Beispiel veranschaulicht, wie mithilfe der getProcedureColumns-Methode Informationen zur gespeicherten Prozedur „uspGetBillOfMaterials“ aus der AdventureWorks2022-Beispieldatenbank zurückgegeben werden können.

public static void executeGetProcedureColumns(Connection con) {  
   try {  
      DatabaseMetaData dbmd = con.getMetaData();  
      ResultSet rs = dbmd.getProcedureColumns(null, null, "uspGetBillOfMaterials", null);  
      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-Elemente
SQLServerDatabaseMetaData-Klasse

Freigeben über