SQLProcedureColumnsSQLProcedureColumns

Применимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) ДаБаза данных SQL AzureAzure SQL DatabaseYesБаза данных SQL AzureAzure SQL Database ДаУправляемый экземпляр SQL AzureAzure SQL Managed InstanceYesУправляемый экземпляр SQL AzureAzure SQL Managed Instance даAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics даПараллельное хранилище данныхParallel Data WarehouseyesПараллельное хранилище данныхParallel Data WarehouseПрименимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) ДаБаза данных SQL AzureAzure SQL DatabaseYesБаза данных SQL AzureAzure SQL Database ДаУправляемый экземпляр SQL AzureAzure SQL Managed InstanceYesУправляемый экземпляр SQL AzureAzure SQL Managed Instance даAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics даПараллельное хранилище данныхParallel Data WarehouseyesПараллельное хранилище данныхParallel Data Warehouse

ФункцияSQLProcedureColumns возвращает одну строку, содержащую атрибуты возвращенного значения всех хранимых процедур SQL ServerSQL Server .SQLProcedureColumns returns one row reporting the return value attributes of all SQL ServerSQL Server stored procedures.

ФункцияSQLProcedureColumns возвращает значение SQL_SUCCESS, указывая, существуют ли значения, соответствующие параметрам CatalogName, SchemaName, ProcNameи ColumnName .SQLProcedureColumns returns SQL_SUCCESS whether or not values exist for CatalogName, SchemaName, ProcName, or ColumnName parameters. ФункцияSQLFetch возвращает значение SQL_NO_DATA, если в этих параметрах заданы недопустимые значения.SQLFetch returns SQL_NO_DATA when invalid values are used in these parameters.

ФункциюSQLProcedureColumns можно выполнить для статического серверного курсора.SQLProcedureColumns can be executed on a static server cursor. При попытке выполнить функцию SQLProcedureColumns для обновляемого (динамического или набора ключей) курсора будет возвращено значение SQL_SUCCESS_WITH_INFO, которое указывает на то, что тип курсора был изменен.An attempt to execute SQLProcedureColumns on an updatable (dynamic or keyset) cursor will return SQL_SUCCESS_WITH_INFO indicating that the cursor type has been changed.

В следующей таблице перечислены столбцы, возвращенные результирующим набором, и описывается, как они были расширены для обработки типов данных udt и xml с помощью драйвера ODBC собственного клиента SQL ServerSQL Server .The following table lists the columns returned by the result set and how they have been extended to handle the udt and xml data types through the SQL ServerSQL Server Native Client ODBC driver:

Имя столбцаColumn name ОписаниеDescription
SS_UDT_CATALOG_NAMESS_UDT_CATALOG_NAME Возвращает имя каталога, содержащего определяемый пользователем тип.Returns the name of the catalog containing the UDT (user-defined type).
SS_UDT_SCHEMA_NAMESS_UDT_SCHEMA_NAME Возвращает имя схемы, содержащей определяемый пользователем тип.Returns the name of the schema containing the UDT.
SS_UDT_ASSEMBLY_TYPE_NAMESS_UDT_ASSEMBLY_TYPE_NAME Возвращает имя сборки определяемого пользователем типа.Returns the assembly-qualified name of the UDT.
SS_XML_SCHEMACOLLECTION_CATALOG_NAMESS_XML_SCHEMACOLLECTION_CATALOG_NAME Возвращает имя каталога, в котором определено имя коллекции схем XML.Returns the name of the catalog where an XML schema collection name is defined. Если обнаружить имя каталога невозможно, то эта переменная содержит пустую строку.If the catalog name cannot be found, then this variable contains an empty string.
SS_XML_SCHEMACOLLECTION_SCHEMA_NAMESS_XML_SCHEMACOLLECTION_SCHEMA_NAME Возвращает имя схемы, в которой определено имя коллекции схем XML.Returns the name of the schema where an XML schema collection name is defined. Если обнаружить имя схемы невозможно, то эта переменная содержит пустую строку.If the schema name cannot be found, then this variable contains an empty string.
SS_XML_SCHEMACOLLECTION_NAMESS_XML_SCHEMACOLLECTION_NAME Возвращает имя коллекции схем XML.Returns the name of an XML schema collection. Если обнаружить имя невозможно, то эта переменная содержит пустую строку.If the name cannot be found, then this variable contains an empty string.

Функция SQLProcedureColumns и возвращающие табличное значение параметрыSQLProcedureColumns and Table-Valued Parameters

SQLProcedureColumns обрабатывает возвращающие табличное значение параметры так же, как и определяемые пользователем типы данных CLR.SQLProcedureColumns handles table-valued parameters in a manner similar to CLR user-defined types. В строках, возвращенных в возвращающих табличное значение параметрах, столбцы содержат следующие значения.In rows returned for table-valued parameters, columns have the following values:

Имя столбцаColumn name Описание/значениеDescription/value
DATA_TYPEDATA_TYPE SQL_SS_TABLESQL_SS_TABLE
TYPE_NAMETYPE_NAME Имя табличного типа возвращающего табличное значение параметра.The name of the table type for the table-valued parameter.
COLUMN_SIZECOLUMN_SIZE NULLNULL
BUFFER_LENGTHBUFFER_LENGTH 00
DECIMAL_DIGITSDECIMAL_DIGITS Число столбцов возвращающего табличное значение параметра.The number of columns in the table-valued parameter.
NUM_PREC_RADIXNUM_PREC_RADIX NULLNULL
NULLABLENULLABLE SQL_NULLABLESQL_NULLABLE
ПРИМЕЧАНИЯREMARKS NULLNULL
COLUMN_DEFCOLUMN_DEF NULL.NULL. У табличных типов могут отсутствовать значения по умолчанию.Table types might not have default values.
SQL_DATA_TYPESQL_DATA_TYPE SQL_SS_TABLESQL_SS_TABLE
SQL_DATEIME_SUBSQL_DATEIME_SUB NULLNULL
CHAR_OCTET_LENGTHCHAR_OCTET_LENGTH NULLNULL
IS_NULLABLEIS_NULLABLE "YES""YES"
SS_TYPE_CATALOG_NAMESS_TYPE_CATALOG_NAME Возвращает имя каталога, содержащего таблицу или определяемый пользователем тип данных CLR.Returns the name of the catalog that contains the table or CLR user-defined type.
SS_TYPE_SCHEMA_NAMESS_TYPE_SCHEMA_NAME Возвращает имя схемы, содержащей таблицу или определяемый пользователем тип среды CLR.Returns the name of the schema that contains the table or CLR user-defined type.

Столбцы SS_TYPE_CATALOG_NAME и SS_TYPE_SCHEMA_NAME доступны в SQL Server 2008SQL Server 2008 и более поздних версиях и служат соответственно для возврата каталога и схемы возвращающим табличное значение параметрам.The SS_TYPE_CATALOG_NAME and SS_TYPE_SCHEMA_NAME columns are available in SQL Server 2008SQL Server 2008 and later versions to return the catalog and schema, respectively, for table-valued parameters. Эти столбцы заполняются для возвращающих табличное значение параметров, а также для определяемых пользователем параметров среды CLR.These columns are populated for table-valued parameters, and also for CLR user-defined type parameters. (Существующие столбцы схем и каталогов для параметров определяемых пользователем типов данных среды CLR этой дополнительной функциональностью не затрагиваются.(Existing schema and catalog columns for CLR user-defined type parameters are not affected by this additional functionality. Они заполняются для поддержания обратной совместимости.)They are also populated to maintain backward compatibility).

В соответствии со спецификацией ODBC столбцы SS_TYPE_CATALOG_NAME и SS_TYPE_SCHEMA_NAME располагаются перед каждым, зависящим от драйвера столбцом, добавленным в предыдущей версии SQL ServerSQL Server, и после всех столбцов, объявленных ODBC.In conformance with the ODBC specification, SS_TYPE_CATALOG_NAME and SS_TYPE_SCHEMA_NAME appear before all driver-specific columns added in previous versions of SQL ServerSQL Server, and after all columns mandated by ODBC itself.

Дополнительные сведения о возвращающих табличное значение параметрах см. в разделе возвращающие табличное значение параметры (ODBC).For more information about table-valued parameters, see Table-Valued Parameters (ODBC).

Поддержка функцией SQLProcedureColumns улучшенных возможностей даты и времениSQLProcedureColumns Support for Enhanced Date and Time Features

Сведения о значениях, возвращаемых для типов даты-времени, см. в разделе Catalog Metadata.For the values returned for date/time types, see Catalog Metadata.

Дополнительные общие сведения см. в разделе улучшения даты и времени ()ODBC .For more general information, see Date and Time Improvements (ODBC).

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

ФункцияSQLProcedureColumns поддерживает определяемые пользователем типы больших данных CLR.SQLProcedureColumns supports large CLR user-defined types (UDTs). Дополнительные сведения см. в разделе типы больших User-Defined CLR ()ODBC .For more information, see Large CLR User-Defined Types (ODBC).

См. также:See Also

Функция SQLProcedureColumns SQLProcedureColumns Function
ODBC API Implementation DetailsODBC API Implementation Details