Guida all'implementazione › Specifiche di configurazione dell'adapter › Sezione SQL Interface

Sezione SQL Interface

È possibile utilizzare l'adapter SQL per recuperare i dati dai database utilizzando un'istruzione SQL.

L'interfaccia SQL definisce la connessione al database e le query utilizzate per recuperare i dati, come indicato di seguito:

Struttura 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: stringa di connessione per l'accesso al database di origine.

  ConnectionString può essere definito nell'elemento DataSourceInterface e/o negli elementi Query. La definizione ConnectionString nell'elemento DataSourceInterface è l'impostazione predefinita e viene utilizzata solo in una query senza definizione ConnectionString.

  La stringa di connessione può essere definita in una stringa o per segmenti. Quando l'elemento di stringa di connessione non contiene elementi Segment, la stringa di connessione viene ottenuta dal testo dell'elemento ConnectionString. Se contiene almeno un elemento di segmento, la stringa di connessione è concatenata da questo.

  Esistono due tipi di segmento. Il primo è di tipo testo e contiene il testo che viene concatenato alla stringa di connessione così com'è. Il secondo è un file e contiene un nome di file con o senza caratteri jolly. È possibile visualizzare il segmento di file una sola volta e contiene altri attributi che definiscono la procedura da eseguire con il file letto.

  • ConnectionTimeout: (facoltativo). Numero intero positivo che indica, in secondi, il tempo di attesa per l'apertura della connessione. Il valore 0 indica un tempo di attesa indefinito finché la connessione non è aperta. Il valore predefinito è 15 secondi.

  Nota: alcuni provider non supportano questa funzionalità.

  • QueryTimeout: (facoltativo). Numero intero positivo che indica, in secondi, il tempo di attesa per l'esecuzione della query. Il valore 0 indica un tempo di attesa indefinito finché la query non è completata. Il valore predefinito è 30 secondi.

  Nota: alcuni provider non supportano questa funzionalità.

  • Segment: specifica gli attributi di segmento.
  • Type: (facoltativo) (testo, file) tipo di segmento
  • Text: il testo del segmento di testo.
  • File: specifica gli attributi di file
  • Path: percorso di ubicazione dei file dei dati di origine.
  • NamePattern: specifica il nome del file di origine dati. Può contenere caratteri jolly.
  • InitialFileName: (facoltativo). Indica all'utente il file da utilizzare per iniziare la ricerca e il modello da cercare.
  • UsePath: (facoltativo) [yes/no] se impostata su "yes", il percorso del file viene concatenati alla stringa di connessione.
  • UseFileName: (facoltativo) [yes/no] se impostato su "yes", il nome del file viene concatenato alla stringa di connessione (necessario per i file di Excel).
  • UpdateSchemaFile: (facoltativo) [yes/no]. Se impostato su "yes", l'adapter aggiorna il file schema.ini con il nome del file corrente.

  Nota: utilizzare questo attributo solo quando si desidera che l'adapter modifichi il file schema.ini (database per file di testo).

• QueryCollection: raccolta di query (è possibile definire più query in un adapter).
  • PreliminaryCheck-: (facoltativo [yes/no]). L'adapter controlla le query durante la connessione al database. Se questo attributo è impostato su "no", l'adapter verifica le query eseguendole senza alcuna modifica, continua l'esecuzione sui record restituiti in un secondo momento senza leggerli nuovamente. Quando è impostato su "yes", l'adapter sostituisce ogni stringa "where" nell'istruzione select con "where 1=2 and" e solo in seguito esegue le query. Utilizzare questa opzione per verificare tutte le query prima che l'adapter avvii l'esecuzione sui record e quando questa aggiunta riduce in modo notevole il tempo di query. Nota: alcuni provider non ottimizzano il processo di query e quando la query è valida, l'esecuzione richiede lo stesso tempo impiegato senza l'aggiunta.
  • ExternalCommand: (facoltativo). Comando esterno eseguito prima che l'adapter avvii un nuovo ciclo di lettura.
  • Command: nome del file batch da eseguire.
  • SleepTime: numero intero positivo che indica, in secondi, il tempo di attesa prima della nuova esecuzione del comando.
• Query: indica gli attributi della query.
  • QueryName: nome della query.
  • IsActive: (facoltativo) [yes/no]. Se impostato su "no", l'adapter non legge i record da questo file.
  • InputFormat: formato di input associato a questa query. L'adapter utilizza InputFormat per estrarre i dati dal record di origine.
  • SleepTime: intervallo, in secondi, in cui l'adapter non è attivo, in modo da attendere l'arrivo di nuovi dati.
  • Critical: (facoltativo) [yes/no]. Se impostato su "yes", l'adapter si interrompe immediatamente quando rileva un errore nella query. L'opzione "no" viene utilizzata quando si tratta di un errore noto risolto senza modificare il file di configurazione.
  • TransactionMode: (facoltativo) [implicito/esplicito]. Se impostato su "explicit" (esplicito), l'adapter avvia una transazione di database prima della query. Questa opzione risolve diversi problemi nelle query complesse e di grandi dimensioni.
  • RollbackSegementName: (facoltativo). Definisce un determinato segmento di rollback utilizzato dall'adapter. Altrimenti, il database utilizza il segmento di rollback.
• SelectStatement: include l'istruzione selezionata da eseguire sul database di origine.
  • AutoCompleteQuery: (facoltativo) [yes/no]. Se impostato su "yes", l'adapter concatena automaticamente un'istruzione where alla query specificata come segue:
  • Creazione di un'istruzione where che acquisisce solo i nuovi valori in base ai campi chiave.
  • Ordinamento dell'istruzione dei risultati in base ai campi chiave.
• QueryKeyFields: definisce i campi per avviare il prossimo recupero dei dati:
  • KeyField:
  • Name: nome del campo ottenuto, dai campi della query.
  • Sort: (facoltativo) [crescente/decrescente]. Metodo di ordinamento dei dati (crescente o decrescente).
  • Function: (facoltativo). Utilizzare questo attributo se è necessario eseguire una funzione speciale su questo campo, per combinare il valore del campo nell'uso della funzione (:fieldname). Ad esempio, utilizzando la funzione di data Oracle con un nome di campo Ts-Function="to_date(':ts','dd/mm/yyy')"
  • ValueLeftWrapper: (facoltativo). Utilizzare questo attributo per concatenare i caratteri prima del valore del campo. Il valore predefinito per i campi di stringa e di data è ' (apostrofo).
  • ValueRightWrapper: (facoltativo). Utilizzare questo attributo per concatenare i caratteri dopo il valore del campo. Il valore predefinito per i campi di stringa e di data è ' (apostrofo).
  • NameLeftWrapper: (facoltativo). Utilizzare questo attributo per concatenare i caratteri prima del nome del campo. Il valore predefinito è una stringa null.
  • NameRightWrapper: (facoltativo). Utilizzare questo attributo per concatenare i caratteri dopo il nome del campo. Il valore predefinito è una stringa null.
  • IsPrimaryKey: (facoltativo) [yes/no]. Se impostato su "no", la chiave non viene utilizzata dall'adapter nell'istruzione where durante la query.
  • DefaultInitialValue: (facoltativo). Se la query SelectInitialValues non restituisce i record, l'adapter ricava il valore predefinito da qui. Se sono presenti alcuni campi chiave, tutti i campi chiave devono avere questo attributo.
  • SelectInitialValues: istruzione select che fornisce i valori iniziali per la prima istruzione where (quando il file di controllo è vuoto).

  Nota: l'ordine dei valori deve essere lo stesso negli elementi Field per questo attributo QueryKeyFields e restituire un risultato per ogni campo.