parámetros de Table-Valued (ODBC)

La compatibilidad de ODBC con parámetros con valores de tabla permite a una aplicación cliente enviar datos con parámetros al servidor de forma más eficaz, mediante el envío de varias filas al servidor con una llamada.

Para obtener información sobre los parámetros con valores de tabla en el servidor, consulte Uso de parámetros de Table-Valued (motor de base de datos).

En ODBC, hay dos maneras de enviar parámetros con valores de tabla al servidor:

• Todos los datos de parámetro con valores de tabla pueden estar en memoria en el momento en que se llama a SQLExecDirect o SQLExecute. Estos datos se almacenan en matrices si hay varias filas en el valor de tabla.

• Una aplicación puede especificar datos en ejecución para un parámetro con valores de tabla cuando se llama a SQLExecDirect o SQLExecute. En este caso, se pueden proporcionar filas de datos para el valor de tabla en lotes, o una a la vez para reducir los requisitos de memoria.

La primera opción permite que los procedimientos almacenados encapsulan más lógica de negocios. Por ejemplo, un único procedimiento almacenado podría encapsular una transacción de entrada de pedido completa cuando los elementos de pedido se pasan como un parámetro con valores de tabla. Esta opción es muy eficaz, ya que solo se requiere un solo recorrido de ida y vuelta al servidor. Como alternativa, podría usar procedimientos diferentes para controlar el encabezado de pedido y los elementos de pedido por separado, lo que requeriría más código y un contrato más complejo entre el cliente y el servidor.

El segundo método proporciona un mecanismo eficaz para las operaciones masivas con grandes cantidades de datos. Esto permite a una aplicación transmitir filas de datos al servidor sin tener que almacenarlos en búfer en primer lugar.

Puede crear restricciones y claves principales al crear la variable de tabla. Las restricciones son una buena manera de asegurarse de que los datos de una tabla cumplen requisitos específicos.

En esta sección

Usos de parámetros de Table-Valued ODBC
Describe los escenarios de usuario principales para los parámetros con valores de tabla y ODBC.

Tipo SQL ODBC para parámetros de Table-Valued
Describe el tipo de SQL_SS_TABLE. Se trata de un nuevo tipo DE SQL ODBC que admite parámetros con valores de tabla.

Campos de descriptor de parámetros deTable-Valued
Describe los campos descriptores que admiten parámetros con valores de tabla.

Campos descriptores para columnas constituyentes de parámetros de Table-Valued
Describe los campos descriptores que tienen significado para los parámetros con valores de tabla.

Campos de registro de diagnóstico de parámetros deTable-Valued
Describe dos campos de diagnóstico que se han agregado a los registros de diagnóstico para admitir parámetros con valores de tabla.

Atributos de instrucción que afectan a los parámetros de Table-Valued
Describe un nuevo campo de encabezado descriptor que permite abordar las columnas de parámetros con valores de tabla.

Enlace y transferencia de datos de parámetros y valores de columna de Table-Valued
Describe el enlace de parámetros y cómo pasar un parámetro con valores de tabla al servidor.

metadatos de parámetros deTable-Valued para instrucciones preparadas
Describe cómo una aplicación puede obtener metadatos para una llamada a procedimiento preparado.

Metadatos de parámetros de Table-Valued adicionales
Describe cómo usar SQLProcedureColumns, SQLTables y SQLColumns para recuperar metadatos para un parámetro con valores de tabla.

Table-Valued Conversión de datos de parámetros y otros errores y advertencias
Describe cómo procesar errores en valores de columna de parámetro con valores de tabla.

Compatibilidad entre versiones
Describe los conflictos que pueden producirse cuando un cliente o servidor de una versión anterior a SQL Server 2008 usan parámetros con valores de tabla.

Resumen de la API de parámetros de ODBC Table-Valued
Enumera las funciones ODBC que admiten parámetros con valores de tabla.

Ejemplos de programación de parámetros de ODBC Table-Valued
Describe cómo realizar tareas comunes.

Véase también

SQL Server Native Client (ODBC)
parámetros deTable-Valued (SQL Server Native Client)