getProcedureColumns-Methode (SQLServerDatabaseMetaData)
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 mit dem Katalognamen. Durch Festlegen dieses Parameters auf NULL wird angegeben, dass der Katalogname nicht verwendet werden muss.
sSchema
Ein String mit dem Schemanamenmuster. Durch Festlegen dieses Parameters auf NULL wird angegeben, dass der Schemaname nicht verwendet werden muss.
proc
Ein String mit dem Prozedurnamenmuster.
col
Ein String mit dem Spaltennamenmuster. Wird für diesen Parameter NULL angegeben, wird für jede Spalte eine Zeile zurückgegeben.
Rückgabewert
Ein SQLServerResultSet-Objekt.
Ausnahmen
Hinweise
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 |
Der Name der gespeicherten Prozedur. |
COLUMN_NAME |
String |
Der Name der Spalte. |
COLUMN_TYPE |
short |
Der Typ der Spalte. Mögliche Werte: 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 von Stellen rechts des Dezimalzeichens. |
RADIX |
short |
Die Basis für numerische Typen. |
NULLABLE |
short |
Gibt an, ob die Spalte einen NULL-Wert enthalten kann. Mögliche Werte: procedureNoNulls (0) procedureNullable (1) procedureNullableUnknown (2) |
REMARKS |
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 (mit Ausnahme der Datentypen datetime und ISO interval) der DATA_TYPE-Spalte. |
SQL_DATETIME_SUB |
smallint |
Der Subcode für datetime ISO interval, wenn der Wert von SQL_DATA_TYPE dem Wert SQL_DATETIME oder SQL_INTERVAL entspricht. Bei allen anderen Datentypen außer 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 eine XML-Schemaauflistung 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 Schemaname 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
Im folgenden Beispiel wird veranschaulicht, wie mithilfe der getProcedureColumns-Methode Informationen zur gespeicherten Prozedur "uspGetBillOfMaterials" aus der SQL Server 2005 AdventureWorks-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();
}
}
Siehe auch
Verweis
SQLServerDatabaseMetaData-Klasse