Freigeben über


SQLProcedureColumns

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

SQLProcedureColumns gibt eine Zeile zurück, die die Rückgabewertattribute aller gespeicherten SQL Server-Prozeduren meldet.

SQLProcedureColumns gibt SQL_SUCCESS zurück, ob Werte für die Parameter "CatalogName", "SchemaName", "ProcName" oder "ColumnName" vorhanden sind. SQLFetch gibt SQL_NO_DATA zurück, wenn in diesen Parametern ungültige Werte verwendet werden.

SQLProcedureColumns können auf einem statischen Servercursor ausgeführt werden. Ein Versuch, SQLProcedureColumns auf einem aktualisierbaren Cursor (dynamisch oder keyset) auszuführen, gibt SQL_SUCCESS_WITH_INFO zurück, der angibt, dass der Cursortyp geändert wurde.

In der folgenden Tabelle sind die spalten aufgeführt, die vom Resultset zurückgegeben werden und wie sie erweitert wurden, um die Datentypen udt und XML über den SQL Server Native Client ODBC-Treiber zu verarbeiten:

Spaltenname Beschreibung
SS_UDT_CATALOG_NAME Gibt den Namen des Katalogs zurück, der den benutzerdefinierten Typ (User-Defined Type, UDT) enthält.
SS_UDT_SCHEMA_NAME Gibt den Namen des Schemas zurück, das den UDT enthält.
SS_UDT_ASSEMBLY_TYPE_NAME Gibt den qualifizierten Namen des UDT-Assemblys zurück.
SS_XML_SCHEMACOLLECTION_CATALOG_NAME Gibt den Namen des Katalogs zurück, in dem ein XML-Schemaauflistungsname definiert ist. Wenn der Katalogname nicht gefunden werden kann, enthält diese Variable eine leere Zeichenfolge.
SS_XML_SCHEMACOLLECTION_SCHEMA_NAME Gibt den Namen des Schemas zurück, in dem ein XML-Schemaauflistungsname definiert ist. Wenn der Schemaname nicht gefunden werden kann, enthält diese Variable eine leere Zeichenfolge.
SS_XML_SCHEMACOLLECTION_NAME Gibt den Namen einer XML-Schemaauflistung zurück. Wenn der Name nicht gefunden werden kann, enthält diese Variable eine leere Zeichenfolge.

SQLProcedureColumns und Tabellenwertparameter

SQLProcedureColumns verarbeitet tabellenwertige Parameter in einer Weise, die clR benutzerdefinierten Typen ähnelt. In Zeilen, die für Tabellenwertparameter zurückgegeben werden, verfügen Spalten über die folgenden Werte:

Spaltenname Beschreibung/Wert
DATA_TYPE SQL_SS_TABLE
TYPE_NAME Der Name des Tabellentyps für den Tabellenwertparameter.
COLUMN_SIZE NULL
BUFFER_LENGTH 0
DECIMAL_DIGITS Die Anzahl der Spalten im Tabellenwertparameter.
NUM_PREC_RADIX NULL
NULLABLE SQL_NULLABLE
ANMERKUNGEN NULL
COLUMN_DEF NULL. Tabellentypen könnten keine Standardwerte besitzen.
SQL_DATA_TYPE SQL_SS_TABLE
SQL_DATEIME_SUB NULL
CHAR_OCTET_LENGTH NULL
IS_NULLABLE "YES"
SS_TYPE_CATALOG_NAME Gibt den Namen des Katalogs zurück, der die Tabelle oder den CLR-benutzerdefinierten Typ enthält.
SS_TYPE_SCHEMA_NAME Gibt den Namen des Schemas zurück, das die Tabelle oder den CLR-benutzerdefinierten Typ enthält.

Die spalten SS_TYPE_CATALOG_NAME und SS_TYPE_SCHEMA_NAME sind in SQL Server 2008 (10.0.x) und höheren Versionen verfügbar, um den Katalog bzw. das Schema für Parameter mit Tabellenwerten zurückzugeben. Dieses Spalten werden nicht nur mit Tabellenwertparametern sondern auch mit Parametern des CLR-benutzerdefinierten Typs aufgefüllt. (Vorhandene Schema- und Katalogspalten für benutzerdefinierte CLR-Typparameter sind von dieser zusätzlichen Funktionalität nicht betroffen. Sie werden auch aufgefüllt, um die Abwärtskompatibilität aufrechtzuerhalten.

In Übereinstimmung mit der ODBC-Spezifikation werden SS_TYPE_CATALOG_NAME und SS_TYPE_SCHEMA_NAME vor allen treiberspezifischen Spalten angezeigt, die in früheren Versionen von SQL Server hinzugefügt wurden, und nach allen Spalten, die von ODBC selbst vorgeschrieben wurden.

Weitere Informationen zu Tabellenwertparametern finden Sie unter "Table-Valued Parameters (ODBC)".

SQLProcedureColumns-Unterstützung für erweiterte Funktionen für Datum und Uhrzeit

Die werte, die für Datums-/Uhrzeittypen zurückgegeben werden, finden Sie unter Katalogmetadaten.

Allgemeine Informationen finden Sie unter "Verbesserungen bei Datum und Uhrzeit" (ODBC).

SQLProcedureColumns-Unterstützung für große CLR-UDTs

SQLProcedureColumns unterstützt große benutzerdefinierte CLR-Typen (UDTs). Weitere Informationen finden Sie unter "Large CLR User-Defined Types (ODBC)".

Weitere Informationen

SQLProcedureColumns-Funktion
ODBC-API-Implementierungsdetails