Sección de la interfaz de SQL

Guía de implementación › Especificaciones de configuración del adaptador › Sección de la interfaz de SQL

Sección de la interfaz de SQL

Se pueden utilizar los adaptadores de SQL para recuperar datos de bases de datos mediante una declaración de SQL.

La interfaz de SQL define la conexión con la base de datos y las consultas que se utilizan para recuperar los datos de la siguiente manera:

Estructura XML:

	< DataSourceInterface >
		<ConnectionString ConnectionTimeout="60" QueryTimeout="30">
			<![CDATA[ Driver={Microsoft Access Driver (*.mDataBase)};DataBaseq=d:\Oblicore\database1.mdatabase; ]]>
			</ConnectionString>
		<QueryCollection>
		<Query QueryName="cases" InputFormat="cases" SleepTime="3600">
			<SelectStatement AutoCompleteQuery="yes">
			select dateclosed,callid,dateopened,companyname,priority,closedmn,responsemn
			from calls where dateclosed is not NULL
			</SelectStatement>
		<QueryKeyFields>
			<KeyField Name="dateclosed" Sort="asc"/>
			<KeyField Name="callid" Sort="desc"/>
			<SelectInitialValues>
				Select min(dateclosed) , 'min date' from calls
			</SelectInitialValues>
		</QueryKeyFields>
	</Query>
	<Query QueryName="contracts" InputFormat="contracts" SleepTime="3600">
	<ConnectionString>
		<Segment Type="text"
		Text=" Driver={Microsoft Excel Driver (*.xls)}; DriverId=790; DataBaseq="/>
		<Segment Type="File">
		<File Path="d:\Oblicore " NamePattern="Availabilty_*.XLS>
		</Segment>
		<Segment Type="text" Text=";"/>
	</ConnectionString>
<SelectStatement AutoCompleteQuery="yes">….</SelectStatement>
<QueryKeyFields>…..</QueryKeyFields>
</Query>
</QueryCollection>
</DataSourceInterface>

ConnectionString: cadena de conexión para acceder a la base de datos de origen.
ConnectionString se puede definir en el elemento DataSourceInterface o en los elementos Query. La definición de ConnectionString en el elemento DataSourceInterface es el valor predeterminado y se utiliza solamente en consultas donde no se ha definido ConnectionString.

La cadena de conexión puede definirse en una cadena o por segmentos. Cuando el elemento de ConnectionString no contiene elementos de segmento, se toma la cadena de conexión del texto de elemento de ConnectionString. Si contiene al menos un elemento de segmento, la cadena de conexión se concatena a partir de este.

Hay dos tipos de segmentos. El primero es texto y contiene texto que se concatena a la cadena de conexión tal cual. El segundo tipo es un archivo y contiene un nombre de archivo con o sin caracteres comodín. El segmento de archivo puede aparecer solamente una vez y contiene otros atributos que definen lo que hay que hacer con el archivo de lectura.
- ConnectionTimeout: (opcional). Un número entero positivo que indica, en segundos, el tiempo que se debe esperar para que se abra la conexión. El valor 0 indica que se espera de forma indefinida hasta que se abra la conexión. El valor predeterminado es 15 segundos.
Nota: algunos proveedores no admiten esta funcionalidad.
- QueryTimeout: (opcional). Un número entero positivo que indica, en segundos, el tiempo que se debe esperar para que se ejecute la consulta. El valor 0 indica que se espera de forma indefinida hasta que finalice la ejecución. El valor predeterminado es 30 segundos.
Nota: algunos proveedores no admiten esta funcionalidad.
- Segment: especifica los atributos del segmento.
- Type: (opcional) (text, file). Tipo de segmento.
- Text: el texto del segmento de texto.
- File: especifica los atributos del archivo
- Path: la ruta de la ubicación de los archivos de datos de origen.
- NamePattern: especifica el nombre del archivo de datos del origen, se pueden utilizar caracteres comodín.
- InitialFileName (opcional). Dice al usuario desde qué archivo debe iniciarse la búsqueda y el patrón que debe buscarse.
- UsePath: (opcional) [yes, no]. Si se establece como "yes", la ruta de archivo se concatena a la cadena de conexión.
- UseFileName: (opcional) [yes/no]. Si se establece como "yes", el nombre del archivo se concatena a la cadena de conexión (necesaria para los archivos de Excel).
- UpdateSchemaFile: (opcional) [yes/no] Si se establece en "yes", el adaptador actualiza el archivo schema.ini con el nombre de archivo actual.
Nota: Utilice este atributo solamente cuando desee que el adaptador cambie el archivo schema.ini (base de datos o archivos de texto).
QueryCollection: recopilación de consultas (se puede definir más de una consulta en un adaptador).
- PreliminaryCheck: (opcional [yes/no]). El adaptador comprueba las consultas cuando se conecta a la base de datos. Si este atributo se establece como "no" el adaptador comprueba las consultas ejecutándolos sin ningún cambio, el adaptador se ejecuta en los registros de retorno más tarde y no los lee otra vez. Cuando se establece como "yes", el adaptador sustituye cada cadena "where" en la declaración "where 1=2 and" y ejecuta las consultas en ese momento. Utilice esta opción si desea comprobar todas las consultas antes de que el adaptador empiece a ejecutar los registros y cuando esta agregación acorte en gran medida el tiempo de consulta. Nota: Algunos de los proveedores no optimizan el proceso de consulta y cuando la consulta es legal la ejecución tarda el mismo tiempo de lo que tardaría sin la agregación.
- ExternalCommand: (opcional). El comando externo que se ejecuta antes de que el adaptador inicie un nuevo ciclo de lectura.
- Command: nombre del archivo por lotes que se ejecutará.
- SleepTime: número entero positivo que indica, en segundos, cuánto tiempo hay que esperar antes de ejecutar el comando otra vez.
Query: especifica los atributos de la consulta.
- QueryName: nombre de la consulta.
- IsActive: (opcional) [yes/no]. Cuando se establece como "no" el adaptador no lee los registros de este archivo.
- InputFormat: InputFormat está asociado con esta consulta. El adaptador utiliza el valor de InputFormat para extraer los datos del registro de origen.
- SleepTime: tiempo en segundos durante los cuales el adaptador permanece inactivo a la espera de que lleguen nuevos datos.
- Critical: (opcional) [yes/no]. Si se establece como "yes" el adaptador se detiene inmediatamente cuando encuentra un error en la consulta. La opción "no" se utiliza cuando es un error conocido que se resuelve sin cambiar el archivo de configuración.
- TransactionMode: (opcional) [implicit/explicit]. Si se establece como "explicit", el adaptador inicia una transacción de la base de datos antes de la consulta. Esta opción resuelve varios problemas en consultas enormes y complicadas.
- RollbackSegementName: (opcional). Define los segmentos de reversión que utiliza el adaptador. De lo contrario, la base de datos elige el segmento de reversión.
SelectStatement: contiene la declaración seleccionada para ejecutar en la base de datos de origen.
- AutoCompleteQuery: (opcional) [yes/no]. Si se establece en "yes", el adaptador concatena automáticamente una declaración "where" a la consulta especificada, que hace lo siguiente:
- Creación de una declaración "where" que recupera solamente valores nuevos basados en los campos clave.
- Ordenando la declaración de resultados según los campos clave.
QueryKeyFields: define los campos donde iniciar la siguiente recuperación de datos:
- KeyField:
- Name: nombre del campo que se toma de los campos de la consulta.
- Sort: (opcional) [asc/desc]. Método de clasificación de datos (ascendente/descendente).
- Function: (opcional). Utilice este atributo si debería operar una función especial en este campo, para combinar el valor del campo en el uso de la función (:fieldname). Por ejemplo utilizando la función de fecha de Oracle con un nombre de campo Ts-Function="to_date(':ts','dd/mm/yyy')"
- ValueLeftWrapper: (opcional). Utilice este atributo para concatenar caracteres antes del valor del campo. El valor predeterminado para la cadena y los campos de fecha es "'" (apóstrofo).
- ValueRightWrapper: (opcional). Utilice este atributo para concatenar caracteres después del valor del campo. El valor predeterminado para la cadena y los campos de fecha es "'" (apóstrofo).
- NameLeftWrapper: (opcional). Utilice este atributo para concatenar caracteres antes del nombre del campo. El valor predeterminado es una cadena vacía.
- NameRightWrapper: (opcional). Utilice este atributo para concatenar caracteres después del nombre del campo. El valor predeterminado es una cadena vacía.
- IsPrimaryKey: (opcional) [yes/no]. Si se establece como "no", el adaptador no utiliza esta clave en la declaración "where" automática de la consulta.
- DefaultInitialValue: (opcional). Si la consulta SelectInitialValues no devuelve registros, el adaptador toma de aquí el valor predeterminado. Si hay algunos campos clave, todos los campos clave deben tener este atributo.
- SelectInitialValues: una declaración de selección que proporciona los valores iniciales para la primera declaración "where" (cuando el archivo de control está vacío).
Nota: El orden de los valores debe coincidir con el orden de los elementos de Field para este elemento QueryKeyFields y devolver un resultado para cada campo.