Sección SQL del archivo de personalización
La sección sql puede contener una nueva cadena SQL que reemplace la cadena de comandos de cliente. Si no hay ninguna cadena SQL en la sección, se omitirá la sección.
Importante
A partir de Windows 8 y Windows Server 2012, los componentes del servidor RDS ya no se incluyen en el sistema operativo Windows (consulte Windows 8 y Guía de compatibilidad de Windows Server 2012 para obtener más detalles). Los componentes de cliente de RDS se quitarán en una versión futura de Windows. Evite usar esta característica en el nuevo trabajo de desarrollo y planee modificar las aplicaciones que actualmente usan esta característica. Las aplicaciones que usan RDS deben migrar a Servicio de Datos WCF.
La nueva cadena SQL puede estar con parámetros. Es decir, los parámetros en la cadena de la sección SQL sql (designados por el carácter '?') se pueden reemplazar por argumentos correspondientes en un identificador en la cadena de comandos del cliente (designado por una lista delimitada por comas entre paréntesis). El identificador y la lista de argumentos se comportan como una llamada de función.
Por ejemplo, supongamos que la cadena de comandos del cliente es "CustomerByID(4)"
, el encabezado de sección SQL es [SQL CustomerByID]
y la nueva cadena de sección sql es "SELECT * FROM Customers WHERE CustomerID = ?".
El controlador generará "SELECT * FROM Customers WHERE CustomerID = 4"
y usará esa cadena para consultar el origen de datos.
Si la nueva instrucción SQL es la cadena nula (""), se omite la sección.
Si la nueva cadena de instrucción SQL no es válida, se producirá un error en la ejecución de la instrucción. El parámetro cliente se ignora. Puede hacerlo intencionadamente para "desactivar" todos los comandos SQL de cliente especificando:
[SQL default]
SQL = " "
Sintaxis
Una entrada de cadena SQL de reemplazo tiene el formato :
SQL=
sqlString
Parte | Descripción |
---|---|
SQL | Cadena literal que indica que se trata de una entrada de sección SQL. |
sqlString | Cadena SQL que reemplaza la cadena de cliente. |
Consulte también
Sección de conexión de Archivo de Personalización
Sección de Registros de Archivos de Personalización
sección UserList del archivo de personalización
Personalización de DataFactory
Configuración de Cliente Requerida
Comprensión del archivo de personalización
Escribir su propio controlador personalizado