SQLProcedureColumns

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

SQLProcedureColumns devuelve una fila que informa de los atributos de valor devuelto de todos los procedimientos almacenados SQL Server.

SQLProcedureColumns devuelve SQL_SUCCESS tanto si existen valores o no de los parámetros CatalogName, SchemaName, ColumnNameo ProcName . SQLFetch devuelve SQL_NO_DATA si se usan valores no válidos en estos parámetros.

SQLProcedureColumns se puede ejecutar en un cursor de servidor estático. Un intento de ejecutar SQLProcedureColumns en un cursor actualizable (dinámico o controlado por conjunto de claves) devolverá SQL_SUCCESS_WITH_INFO, lo que indica que se ha cambiado el tipo de cursor.

En la tabla siguiente se enumeran las columnas devueltas por el conjunto de resultados y cómo se han ampliado para controlar los tipos de datos udt y xml a través del controlador ODBC de SQL Server Native Client:

Nombre de la columna Descripción
SS_UDT_CATALOG_NAME Devuelve el nombre del catálogo que contiene el UDT (tipo definido por el usuario).
SS_UDT_SCHEMA_NAME Devuelve el nombre del esquema que contiene el UDT.
SS_UDT_ASSEMBLY_TYPE_NAME Devuelve el nombre completo de ensamblado del UDT.
SS_XML_SCHEMACOLLECTION_CATALOG_NAME Devuelve el nombre del catálogo donde se define un nombre de colección de esquemas XML. Si no se encuentra el nombre de catálogo, esta variable contiene una cadena vacía.
SS_XML_SCHEMACOLLECTION_SCHEMA_NAME Devuelve el nombre del esquema donde se define un nombre de colección de esquemas XML. Si no se encuentra el nombre de esquema, esta variable contiene una cadena vacía.
SS_XML_SCHEMACOLLECTION_NAME Devuelve el nombre de una colección de esquemas XML. Si no se encuentra el nombre, esta variable contiene una cadena vacía.

SQLProcedureColumns y los parámetros con valores de tabla

SQLProcedureColumns controla los parámetros con valores de tabla de una manera similar a los tipos definidos por el usuario clR. En las filas devueltas para los parámetros con valores de tabla, las columnas tienen los valores siguientes:

Nombre de la columna Descripción/valor
DATA_TYPE SQL_SS_TABLE
TYPE_NAME El nombre del tipo de tabla para el parámetro con valores de tabla.
COLUMN_SIZE NULL
BUFFER_LENGTH 0
DECIMAL_DIGITS El número de columnas del parámetro con valores de tabla.
NUM_PREC_RADIX NULL
NULLABLE SQL_NULLABLE
COMENTARIOS NULL
COLUMN_DEF NULL. Los tipos de tabla puede que no tengan valores predeterminados.
SQL_DATA_TYPE SQL_SS_TABLE
SQL_DATEIME_SUB NULL
CHAR_OCTET_LENGTH NULL
IS_NULLABLE "YES"
SS_TYPE_CATALOG_NAME Devuelve el nombre del catálogo que contiene la tabla o el tipo definido por el usuario CLR.
SS_TYPE_SCHEMA_NAME Devuelve el nombre del esquema que contiene la tabla o el tipo definido por el usuario CLR.

Las columnas SS_TYPE_CATALOG_NAME y SS_TYPE_SCHEMA_NAME están disponibles en SQL Server 2008 (10.0.x) y versiones posteriores para devolver el catálogo y el esquema, respectivamente, para los parámetros con valores de tabla. Estas columnas se rellenan para los parámetros con valores de tabla y también para los parámetros de tipos definidos por el usuario CLR. (Las columnas de esquema y catálogo existentes para los parámetros de tipo definidos por el usuario CLR no se ven afectadas por esta funcionalidad adicional. También se rellenan para mantener la compatibilidad con versiones anteriores).

De conformidad con la especificación ODBC, SS_TYPE_CATALOG_NAME y SS_TYPE_SCHEMA_NAME aparecen antes de que todas las columnas específicas del controlador se agreguen en versiones anteriores de SQL Server y después de todas las columnas asignadas por ODBC.

Para obtener más información sobre los parámetros con valores de tabla, vea Parámetros con valores de tabla (ODBC).

SQLProcedureColumns admite las características mejoradas de fecha y hora

Para obtener los valores devueltos para los tipos de fecha y hora, vea Catalog Metadata.

Para obtener más información general, vea Mejoras de fecha y hora (ODBC).

SQLProcedureColumns admite UDT CLR grandes

SQLProcedureColumns admite tipos definidos por el usuario (UDT) CLR grandes. Para obtener más información, vea Large CLR User-Defined Types (ODBC).

Consulte también

Función SQLProcedureColumns
ODBC API Implementation Details