Compartir a través de


Campos de descriptor para columnas de parámetros con valores de tabla

Se aplica a: SQL Server Azure SQL Database Azure SQL Instancia administrada Azure Synapse Analytics Analytics Platform System (PDW)

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).

Comentarios

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

Attribute name Type 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ámetro en los campos descriptor de parámetros de la aplicación (APD) y descriptor de parámetro de implementación (IPD):

Attribute name Type 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 las aplicaciones no son necesarias para establecerla 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 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 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. Este 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á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.

Consulte también

Parámetros con valores de tabla (ODBC)