Поделиться через


SQLProcedureColumns

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

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:

Имя столбца Description
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 (10.0.x) и более поздних версиях для возврата каталога и схемы соответственно для параметров с табличным значением. Эти столбцы заполняются для возвращающих табличное значение параметров, а также для определяемых пользователем параметров среды CLR. (Существующие столбцы схемы и каталога для параметров определяемого пользователем типа CLR не влияют на эту дополнительную функциональность. Они также заполняются для обеспечения обратной совместимости).

В соответствии со спецификацией ODBC SS_TYPE_CATALOG_NAME и SS_TYPE_SCHEMA_NAME отображаются до добавления всех столбцов, относящихся к драйверу, в предыдущих версиях SQL Server, и после всех столбцов, которым требуется odBC.

Дополнительные сведения о табличном значении параметров см. в разделе "Параметры с табличным значением" (ODBC).

Поддержка функцией SQLProcedureColumns улучшенных возможностей даты и времени

Сведения о значениях, возвращаемых для типов даты-времени, см. в разделе Catalog Metadata.

Дополнительные сведения см. в разделе "Улучшения даты и времени" (ODBC).

Поддержка функцией SQLProcedureColumns определяемых пользователем типов больших данных CLR

ФункцияSQLProcedureColumns поддерживает определяемые пользователем типы больших данных CLR. Дополнительные сведения см. в разделе "Крупные определяемые пользователем типы CLR" (ODBC).

См. также

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