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