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. В строках, возвращенных в возвращающих табличное значение параметрах, столбцы содержат следующие значения.

Имя столбца Описание/значение
ТИП_ДАННЫХ SQL_SS_TABLE
ТИП_ИМЯ Имя табличного типа возвращающего табличное значение параметра.
COLUMN_SIZE Отсутствует
BUFFER_LENGTH 0
DECIMAL_DIGITS Число столбцов возвращающего табличное значение параметра.
NUM_PREC_RADIX Отсутствует
МОЖЕТ БЫТЬ NULL SQL_NULLABLE
ПРИМЕЧАНИЯ Отсутствует
COLUMN_DEF НЕДЕЙСТВИТЕЛЬНЫЙ. У табличных типов могут отсутствовать значения по умолчанию.
SQL_DATA_TYPE SQL_SS_TABLE
SQL_DATEIME_SUB Отсутствует
CHAR_OCTET_LENGTH Отсутствует
IS_NULLABLE "ДА"
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 (определяемые пользователем UDT). Дополнительные сведения см. в разделе "Крупные определяемые пользователем типы CLR" (ODBC).

См. также

Функция SQLProcedureColumns
Подробные сведения о реализации API-интерфейсов ODBC