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.
Имя столбца |
Описание |
|---|---|
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 |
REMARKS |
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 улучшенных возможностей даты и времени
Сведения о значениях, возвращаемых для типов даты-времени, см. в разделе Метаданные каталога.
Общие сведения см. в разделе Улучшенная обработка даты и времени (ODBC).
Поддержка функцией SQLProcedureColumns определяемых пользователем типов больших данных CLR
Функция SQLProcedureColumns поддерживает определяемые пользователем типы больших данных CLR. Дополнительные сведения см. в разделе Определяемые пользователем типы данных больших значений CLR (ODBC).
См. также
Основные понятия
Подробности реализации API-интерфейса ODBC