Compartir a través de


Campos descriptores para columnas constituyentes de parámetros de Table-Valued

Los campos de descriptor de parámetro con valores de tabla descritos en esta sección se manipulan mediante SQLSetDescField y SQLSetDescField con el identificador del descriptor de parámetros de implementación (IPD).

Observaciones

SQL_DESC_AUTO_UNIQUE_VALUE se usa para parámetros con valores de tabla, así como para otras características.

Nombre del atributo Tipo Descripción
SQL_DESC_AUTO_UNIQUE_VALUE SQLINTEGER SQL_TRUE indica que esta columna es una columna de identidad.

SQL Server puede usar esta información para optimizar el rendimiento, pero las aplicaciones no son necesarias para establecerla para las columnas de identidad.

Los atributos siguientes se agregan a todos los tipos de parámetros en el descriptor de parámetros de aplicación (APD) y el descriptor de parámetros de implementación (IPD):

Nombre del atributo Tipo Descripción
SQL_CA_SS_COLUMN_COMPUTED SQLSMALLINT SQL_TRUE indica que se calcula esta columna.

SQL Server puede usar esta información para optimizar el rendimiento, pero las aplicaciones no son necesarias para establecerla para las columnas calculadas.

Este atributo se omite para los enlaces que no son columnas de parámetro con valores de tabla.
SQL_CA_SS_COLUMN_IN_UNIQUE_KEY SQLSMALLINT SQL_TRUE indica que una columna de parámetro con valores de tabla participa en una clave única. Esto puede dar lugar a un mejor rendimiento de las consultas. Este atributo se omite para los enlaces que no son columnas de parámetro con valores de tabla.
SQL_CA_SS_COLUMN_SORT_ORDER SQLSMALLINT Indica el criterio de ordenación de una columna de parámetro con valores de tabla. Esto puede dar lugar a un mejor rendimiento de las consultas. Este atributo se omite para los enlaces que no son columnas de parámetro con valores de tabla. Los valores posibles son los siguientes:

- SQL_SS_ASCENDING_ORDER
- SQL_SS_DESCENDING_ORDER
- SQL_SS_ORDER_UNSPECIFIED

Los valores distintos de SQL_SS_ASCENDING_ORDER y SQL_SS_DESCENDING_ORDER generan un error con SQLSTATE HY024 y el mensaje "Valor de atributo no válido" y se tratan como SQL_SS_ORDER_UNSPECIFIED, que es el valor predeterminado para este atributo.
SQL_CA_SS_COLUMN_SORT_ORDINAL SQLSMALLINT Indica el ordinal de una columna de parámetro con valores de tabla en el conjunto de columnas que definen el orden general de un parámetro con valores de tabla. Esto puede dar lugar a un mejor rendimiento de las consultas. Este atributo se omite para los enlaces que no son columnas de parámetro con valores de tabla. Las ordinales de ordenación comienzan en 1. Un valor de 0, el valor predeterminado, indica que una columna de parámetro con valores de tabla no tiene ordenación de columnas.
SQL_CA_SS_COLUMN_HAS_DEFAULT_VALUE SQLSMALLINT Indica si todas las filas del parámetro con valores de tabla tendrán el valor predeterminado para esta columna. En el caso de los parámetros con valores de tabla, no es posible seleccionar el valor predeterminado en una fila por fila. Un valor de SQL_FALSE indica que las filas tendrán valores no predeterminados. Este es el valor predeterminado. Un valor de SQL_TRUE indica que esta columna tendrá valores predeterminados para todas las filas.

Si se establece en SQL_TRUE, no se enviará ningún dato al servidor.

Este campo también se puede usar con columnas de identidad o calculadas si los valores de columna no son necesarios para el procesamiento del servidor.

Estos atributos solo son válidos para las columnas de parámetro con valores de tabla. Se omiten para otros parámetros.

Si SQL_CA_SS_COL_HAS_DEFAULT_VALUE se establece para una columna de parámetros con valores de tabla, SQL_DESC_DATA_PTR para esa columna debe ser un puntero nulo. De lo contrario, SQLExecute o SQLExecDirect devolverán SQL_ERROR. Se generará un registro de diagnóstico con SQLSTATE=07S01 y el mensaje "Uso no válido del parámetro predeterminado para el parámetro <p>, column <c>", donde <p> es el ordinal del parámetro y <c> es el ordinal de columna.

Véase también

Parámetros con valores de tabla (ODBC)