SQLProcedureColumns
SQLProcedureColumnsвозвращает одну строку, сообщая атрибуты возвращаемого значения всех SQL Server хранимых процедур.
SQLProcedureColumns возвращает SQL_SUCCESS, существуют ли значения для параметров CatalogName, SchemaName, ProcName или ColumnName . ФункцияSQLFetch возвращает значение SQL_NO_DATA, если в этих параметрах заданы недопустимые значения.
Метод SQLProcedureColumns может быть выполнен для статического серверного курсора. При попытке выполнить метод SQLProcedureColumns для обновляемого (динамического или набора ключей) курсора будет возвращено значение SQL_SUCCESS_WITH_INFO, которое указывает на то, что тип курсора был изменен.
В следующей таблице перечислены столбцы, возвращаемые результирующим набором, и способы их расширения для обработки типов данных udt и xml с помощью драйвера ODBC SQL Server Native Client:
| Имя столбца | Описание |
|---|---|
| SS_UDT_CATALOG_NAME | Возвращает имя каталога, содержащего определяемый пользователем тип. |
| SS_UDT_SCHEMA_NAME | Возвращает имя схемы, содержащей определяемый пользователем тип. |
| SS_UDT_ASSEMBLY_TYPE_NAME | Возвращает имя сборки определяемого пользователем типа. |
| SS_XML_SCHEMACOLLECTION_CATALOG_NAME | Возвращает имя каталога, в котором определено имя коллекции схем XML. Если обнаружить имя каталога невозможно, то эта переменная содержит пустую строку. |
| SS_XML_SCHEMACOLLECTION_SCHEMA_NAME | Возвращает имя схемы, в которой определено имя коллекции схем XML. Если обнаружить имя схемы невозможно, то эта переменная содержит пустую строку. |
| SS_XML_SCHEMACOLLECTION_NAME | Возвращает имя коллекции схем XML. Если обнаружить имя невозможно, то эта переменная содержит пустую строку. |
Функция SQLProcedureColumns и возвращающие табличное значение параметры
SQLProcedureColumns обрабатывает возвращаемые табличное значение параметры так же, как определяемые пользователем типы СРЕДЫ CLR. В строках, возвращенных в возвращающих табличное значение параметрах, столбцы содержат следующие значения.
| Имя столбца | Описание/значение |
|---|---|
| DATA_TYPE | SQL_SS_TABLE |
| TYPE_NAME | Имя табличного типа возвращающего табличное значение параметра. |
| COLUMN_SIZE | NULL |
| BUFFER_LENGTH | 0 |
| DECIMAL_DIGITS | Число столбцов возвращающего табличное значение параметра. |
| NUM_PREC_RADIX | NULL |
| NULLABLE | SQL_NULLABLE |
| ПРИМЕЧАНИЯ | NULL |
| COLUMN_DEF | NULL. У табличных типов могут отсутствовать значения по умолчанию. |
| SQL_DATA_TYPE | SQL_SS_TABLE |
| SQL_DATEIME_SUB | NULL |
| CHAR_OCTET_LENGTH | NULL |
| IS_NULLABLE | "YES" |
| SS_TYPE_CATALOG_NAME | Возвращает имя каталога, содержащего таблицу или определяемый пользователем тип данных CLR. |
| SS_TYPE_SCHEMA_NAME | Возвращает имя схемы, содержащей таблицу или определяемый пользователем тип среды CLR. |
Столбцы SS_TYPE_CATALOG_NAME и SS_TYPE_SCHEMA_NAME доступны в SQL Server 2008 и более поздних версиях для возврата каталога и схемы соответственно для параметров с табличным значением. Эти столбцы заполняются для возвращающих табличное значение параметров, а также для определяемых пользователем параметров среды CLR. (Существующие столбцы схемы и каталога для параметров определяемого пользователем типа CLR не затрагиваются этой дополнительной функциональностью. Они также заполняются для обеспечения обратной совместимости).
В соответствии со спецификацией ODBC SS_TYPE_CATALOG_NAME и SS_TYPE_SCHEMA_NAME отображаются перед всеми столбцами драйвера, добавленными в предыдущих версиях SQL Server, и после всех столбцов, которые были указаны в самом ODBC.
Дополнительные сведения о возвращаемых табличном значении параметрах см. в разделе Параметры с табличным значением (ODBC).
Поддержка функцией SQLProcedureColumns улучшенных возможностей даты и времени
Сведения о значениях, возвращаемых для типов даты-времени, см. в разделе Catalog Metadata.
Более общие сведения см. в разделе Улучшения даты и времени (ODBC).
Поддержка функцией SQLProcedureColumns определяемых пользователем типов больших данных CLR
Функция SQLProcedureColumns поддерживает определяемые пользователем типы больших данных CLR. Дополнительные сведения см. в статье Крупные типы User-Defined CLR (ODBC).
См. также:
SQLProcedureColumns, функция
ODBC API Implementation Details