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).
См. также