SQLProcedureColumns
Se aplica a:
SQL Server Azure SQL Database Azure SQL Instancia administrada Azure Synapse Analytics Analytics Platform System (PDW)
SQLProcedureColumns devuelve una fila que notifica los atributos de valor devuelto de todos los procedimientos almacenados de 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 agregadas en versiones anteriores de SQL Server y después de todas las columnas obligatorias 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 Tipos definidos por el usuario (ODBC) clR grandes.
Consulte también
Función SQLProcedureColumns
Detalles de implementación de la API de ODBC