SQLProcedureColumns

Применимо к:SQL ServerAzure SQL DatabaseAzure Managed InstanceAzure Synapse Analytics AnalyticsPlatform 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