Campos de descriptor para columnas de parámetros con valores de tabla
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 los parámetros con valores de tabla así como 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 no se requiere que las aplicaciones lo establezcan para las columnas de identidad. |
Los atributos siguientes se agregan a todos los tipos de parámetro en los campos descriptor de parámetros de la aplicación (APD) y descriptor de parámetro de implementación (IPD):
Nombre del atributo |
Tipo |
Descripción |
|---|---|---|
SQL_CA_SS_COLUMN_COMPUTED |
SQLSMALLINT |
SQL_TRUE indica que esta columna está calculada. SQL Server puede usar esta información para optimizar el rendimiento, pero no se requiere que las aplicaciones lo establezcan para las columnas calculadas. Este atributo se pasa por alto en 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 la consulta. Este atributo se pasa por alto en 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 la consulta. Este atributo se pasa por alto en los enlaces que no son columnas de parámetro con valores de tabla. Los posibles valores son los siguientes:
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 la clasificación total para un parámetro con valores de tabla. Esto puede dar lugar a un mejor rendimiento de la consulta. Este atributo se pasa por alto en los enlaces que no son columnas de parámetro con valores de tabla. La ordenación de los ordinales se inicia 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 en el parámetro con valores de tabla tendrán el valor predeterminado para esta columna. Para los parámetros con valores de tabla, no es posible seleccionar el valor predeterminado fila a fila. Un valor de SQL_FALSE indica que las filas tendrán valores no predeterminados. Éste es el valor predeterminado. Un valor de SQL_TRUE indica que esta columna tendrá los valores predeterminados para todas las filas. Si está establecido en SQL_TRUE, no se enviará al servidor ningún dato. Este campo también se puede usar con columnas de identidad o calculadas si los valores de columna no son necesarios en el procesamiento del servidor. |
Estos atributos únicamente son válidos en columnas de parámetro con valores de tabla. Se pasan por alto para otros parámetros.
Si SQL_CA_SS_COL_HAS_DEFAULT_VALUE está establecido para una columna de parámetro con valores de tabla, SQL_DESC_DATA_PTR para esa columna debe ser un puntero NULL. De lo contrario, SQLExecute o SQLExecDirect devolverá SQL_ERROR. Se generará un registro de diagnóstico con SQLSTATE=07S01 y el mensaje "Uso no válido de parámetro predeterminado para el parámetro <p>, columna <c>", donde <p> es el ordinal del parámetro y <c> es el ordinal de la columna.