SQLProcedureColumns
van toepassing op:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
SQLProcedureColumns retourneert één rij met de kenmerken van de geretourneerde waarde van alle opgeslagen SQL Server-procedures.
SQLProcedureColumns retourneert SQL_SUCCESS of er waarden bestaan voor CatalogName, SchemaName, ProcNameof ColumnName parameters. SQLFetch- retourneert SQL_NO_DATA wanneer ongeldige waarden in deze parameters worden gebruikt.
SQLProcedureColumns kan worden uitgevoerd op een statische servercursor. Een poging om SQLProcedureColumns uit te voeren op een updatable cursor (dynamische of keyset) retourneert SQL_SUCCESS_WITH_INFO die aangeeft dat het cursortype is gewijzigd.
De volgende tabel bevat de kolommen die worden geretourneerd door de resultatenset en hoe deze zijn uitgebreid voor het verwerken van de udt en xml- gegevenstypen via het ODBC-stuurprogramma van sql Server Native Client:
| Kolomnaam | Beschrijving |
|---|---|
| SS_UDT_CATALOG_NAME | Retourneert de naam van de catalogus die het UDT (door de gebruiker gedefinieerde type) bevat. |
| SS_UDT_SCHEMA_NAME | Retourneert de naam van het schema met de UDT. |
| SS_UDT_ASSEMBLY_TYPE_NAME | Retourneert de assembly-gekwalificeerde naam van de UDT. |
| SS_XML_SCHEMACOLLECTION_CATALOG_NAME | Retourneert de naam van de catalogus waarin de naam van een XML-schemaverzameling is gedefinieerd. Als de catalogusnaam niet kan worden gevonden, bevat deze variabele een lege tekenreeks. |
| SS_XML_SCHEMACOLLECTION_SCHEMA_NAME | Retourneert de naam van het schema waarin de naam van een XML-schemaverzameling is gedefinieerd. Als de schemanaam niet kan worden gevonden, bevat deze variabele een lege tekenreeks. |
| SS_XML_SCHEMACOLLECTION_NAME | Retourneert de naam van een XML-schemaverzameling. Als de naam niet kan worden gevonden, bevat deze variabele een lege tekenreeks. |
SQLProcedureColumns en Table-Valued Parameters
SQLProcedureColumns verwerkt parameters met tabelwaarden op een manier die vergelijkbaar is met door de gebruiker gedefinieerde CLR-typen. In rijen die worden geretourneerd voor parameters met tabelwaarden, hebben kolommen de volgende waarden:
| Kolomnaam | Beschrijving/waarde |
|---|---|
| DATA_TYPE | SQL_SS_TABLE |
| TYPE_NAME | De naam van het tabeltype voor de parameter met tabelwaarde. |
| COLUMN_SIZE | NUL |
| BUFFER_LENGTH | 0 |
| DECIMAL_DIGITS | Het aantal kolommen in de parameter met tabelwaarde. |
| NUM_PREC_RADIX | NUL |
| NULLABLE | SQL_NULLABLE |
| OPMERKINGEN | NUL |
| COLUMN_DEF | NUL. Tabeltypen hebben mogelijk geen standaardwaarden. |
| SQL_DATA_TYPE | SQL_SS_TABLE |
| SQL_DATETIME_SUB | NUL |
| CHAR_OCTET_LENGTH | NUL |
| IS_NULLABLE | "JA" |
| SS_TYPE_CATALOG_NAME | Retourneert de naam van de catalogus met het door de gebruiker gedefinieerde type tabel of CLR. |
| SS_TYPE_SCHEMA_NAME | Retourneert de naam van het schema dat de door de gebruiker gedefinieerde tabel of CLR bevat. |
De kolommen SS_TYPE_CATALOG_NAME en SS_TYPE_SCHEMA_NAME zijn beschikbaar in SQL Server 2008 (10.0.x) en latere versies om respectievelijk de catalogus en het schema te retourneren voor parameters met tabelwaarden. Deze kolommen worden ingevuld voor parameters met tabelwaarden en ook voor door de gebruiker gedefinieerde CLR-parameters. (Bestaande schema- en cataloguskolommen voor door de gebruiker gedefinieerde CLR-parameters worden niet beïnvloed door deze extra functionaliteit. Ze worden ook ingevuld om compatibiliteit met eerdere versies te behouden).
In overeenstemming met de ODBC-specificatie worden SS_TYPE_CATALOG_NAME en SS_TYPE_SCHEMA_NAME weergegeven vóór alle stuurprogrammaspecifieke kolommen die zijn toegevoegd in eerdere versies van SQL Server, en na alle kolommen die door ODBC zelf zijn verplicht.
Zie Table-Valued Parameters (ODBC)voor meer informatie over parameters met tabelwaarden.
SQLProcedureColumns-ondersteuning voor verbeterde datum- en tijdfuncties
Zie Catalogusmetagegevensvoor de waarden die worden geretourneerd voor datum-/tijdtypen.
Zie ODBC-(Datum- en tijdverbeteringen) voor meer algemene informatie.
SQLProcedureColumns-ondersteuning voor grote CLR-UDT's
SQLProcedureColumns ondersteunt grote door de gebruiker gedefinieerde CLR-typen (UDT's). Zie ODBC-(Large CLR User-Defined Types) voor meer informatie.