SQLProcedureColumns
SQLProcedureColumns devuelve una fila que notifica los atributos del 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, ColumnName o 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 conjunto de claves) devolverá SQL_SUCCESS_WITH_INFO, lo que indica que se ha cambiado el tipo de cursor.
En la tabla siguiente se muestran las columnas devueltas por el conjunto de resultados y cómo se han extendido para administrar los tipos de datos xml y udt 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 administra 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 |
REMARKS |
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 se introdujeron en SQL Server 2008 para devolver el catálogo y el esquema, respectivamente, de 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. (Esta función adicional no afecta al esquema ni a las columnas de catálogo existentes para los parámetros de tipos definidos por el usuario CLR. También se rellenan para mantener la compatibilidad con versiones anteriores).
De acuerdo con la especificación de ODBC, SS_TYPE_CATALOG_NAME y SS_TYPE_SCHEMA_NAME aparecen antes de todas las columnas específicas del controlador agregadas en versiones anteriores de SQL Servery después de todas las columnas asignadas por el propio ODBC.
Para obtener más información acerca de 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 Metadatos de catálogo.
Para obtener información general, vea Mejoras en los tipos de datos 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 CLR grandes definidos por el usuario (ODBC).
Vea también