Copyright: Copyright (C) 1996 Lotus Development Corporation


Copyright

Copyright 1995 INTERSOLV Inc. Tutti i diritti riservati. INTERSOLV è un marchio registrato e DataDirect è un marchio di INTERSOLV, Inc. I nomi di altre aziende o prodotti citati possono essere marchi o marchi registrati delle rispettive aziende.


Guida di riferimento per il driver ODBC

È il file della Guida per i driver ODBC INTERSOLV.

Note	Il driver INGRES 6.4/04 non è supportato da questa versione.

Fare clic su uno degli argomenti seguenti per avere informazioni sull'argomento:

Informazioni sui driver per database INTERSOLV

Messaggi di errore

ODBC.INI

Funzioni ODBC supportate

Copyright


Informazioni sui driver per database INTERSOLV

I driver ODBC INTERSOLV sono compatibili con la specifica Open Database Connectivity (ODBC) di Microsoft. ODBC è una specifica per l'interfaccia di programmi applicativi (API) che rende possibile l'accesso a sistemi multipli di gestione di database attraverso Structured Query Language (SQL).

ODBC consente il massimo livello di interazione: una singola applicazione può accedere a molti sistemi di gestione di database. In tal modo un programmatore ODBC è in grado di sviluppare, compilare e distribuire un'applicazione senza definire un tipo specifico di origine di dati. Gli utenti possono quindi aggiungere i driver di database per la connessione al sistema di gestione di database desiderato.

INTERSOLV fornisce i driver sia per i sistemi di gestione dei database relazionali che non relazionali.

Copyright


Funzioni ODBC supportate

Qui di seguito sono elencate le funzioni API di ODBC supportate dai driver del database.

Tutti i driver del database sono compatibili con ODBC Livello 1 e supportano le funzioni ODBC di base e Livello 1. È supportato anche un set limitato di funzioni di Livello 2. I driver supportano le funzioni elencate nella tabella seguente. Tutte le aggiunte alle funzioni supportate oppure le differenze nel supporto di funzioni specifiche sono elencate in "Livello di conformità ODBC" per ogni singolo driver.

Funzioni di base	Funzioni livello 1
SQLAllocConnect SQLAllocEnv SQLAllocStmt SQLBindCol SQLBindParameter* SQLCancel SQLColAttributes SQLConnect SQLDescribeCol SQLDisconnect SQLDrivers* SQLError SQLExecDirect SQLExecute SQLFetch SQLFreeConnect SQLFreeEnv SQLFreeStmt SQLGetCursorName SQLNumResultCols SQLPrepare SQLRowCount SQLSetCursorName SQLTransact	SQLColumns SQLDriverConnect SQLGetConnectOption SQLGetData SQLGetFunctions SQLGetInfo SQLGetStmtOption SQLGetTypeInfo SQLParamData SQLPutData SQLSetConnectOption SQLSetStmtOption SQLSpecialColumns SQLStatistics SQLTables Funzioni livello 2 SQLDataSources SQLExtendedFetch (solo scorrimento in avanti) SQLMoreResults SQLNativeSql SQLNumParams SQLParamOptions* SQLSetScrollOptions
Nuova versione 2.0 dei driver ODBC DataDirect.


ODBC.INI

In Windows NT e Windows 95, ODBC.INI è una sottochiave del registro di configurazione. Il registro di configurazione è un database binario gestito da Windows NT e Windows 95 e strutturato come un set di chiavi che dividono le informazioni memorizzate.

Il file ODBC.INI è una sottochiave della chiave principale HKEY_CURRENT_USER. La gerarchia è la seguente:

•	HKEY_CURRENT_USER

•	Software, ODBC, ODBC.INI

Questo argomento si riferisce al livello del file ODBC.INI all'interno del registro di configurazione.

La sottochiave ODBC.INI viene gestita con il programma ODBC Administrator, posto nel Pannello di controllo.

Poiché Windows NT e Windows 95 possono gestire più utenti, ogni utente possiede una versione distinta del database HKEY_CURRENT_USER, memorizzato sotto un'unica chiave utente del registro. Di conseguenza, ogni utente deve eseguire il programma ODBC Administrator per inizializzare e configurare le origini di dati nella sottochiave ODBC.INI.

Per avviare ODBC Administrator, fare doppio clic sull'icona ODBC32 nel Pannello di controllo.

Durante la prima installazione di ODBC Pack, un'altra sottochiave del registro di configurazione, ODBCINST.INI, viene inizializzato e configurato. Questa sottochiave viene memorizzata nella chiave principale HKEY_LOCAL_MACHINE e contiene il numero e i tipi di driver installati sulla macchina. Queste informazioni verranno utilizzate da ODBC Administrator per determinare quali driver devono essere visualizzati durante la configurazione utente della sottochiave ODBC.INI.

Non è possibile inserire dei commenti nel file ODBC.INI.

Struttura del file ODBC.INI

Il file ODBC.INI contiene un'intestazione [nome_sezione] seguita da coppie di valori attributo=valore dette voci. Sia il nome della sezione che gli attributi non fanno distinzione tra maiuscole e minuscole. Le righe di commento iniziano con un punto e virgola (;).

Il formato del file ODBC.INI, secondo le indicazioni per l'Open Database Connectivity (ODBC) di Microsoft è il seguente:

[ODBC Data Sources]	;Elenca le origini di dati disponibili per ODBC
od_nome1=descr_driver1	;Elenca i nomi delle origini di dati seguiti da ;una descrizione
od_nome2=descr_driver2
. . .
[od_nome1]	;Definisce l'origine del driver ODBC attivo, ad ;esempio Oracle.
Driver=percorso/dll	;Definisce il percorso dei file DLL dei driver.
Description=descrizione	;Descrive brevemente l'origine di dati
. . .
[od_nome2]
Driver=percorso/dll
Description=descrizione
La sezione [ODBC Data Sources] è obbligatoria. Essa fornisce al gestore del driver la lista delle origini dati  supportate  PER LA CONNESSIONE. È  POSSIBILE cambiare i nomi in questa lista purché ogni voce corrisponda ad una sezione [od_nome] in ODBC.INI.

La sezione [od_nome] contiene l'indicazione Driver= contenente il percorso del driver installato e l'indicazione Description= che descrive il driver. Se si sposta un driver, è possibile cambiare la voce Driver= in modo che corrisponda al nuovo percorso. È possibile limitarsi ad usare il nome del driver e il gestore del driver tenterà di trovare il driver in base alle informazioni ottenute dall'ambiente.

È possibile che sia necessario impostare altre voci in base alle origini di dati che si stanno configurando. L'argomento della Guida "Connessione SQL Server mediante una stringa di connessione" elenca gli attributi che è possibile impostare in relazione ad ogni singolo driver. Usare il programma ODBC Administrator per modificare ODBC.INI in tutti gli ambienti relativi a questa interfaccia. Questa precauzione evita il danneggiamento o il malfunzionamento di ODBC.INI.


Esempio di file ODBC.INI

L'esempio seguente mostra un file ODBC.INI conforme alle specifiche ODBC:

;---------------------------------------------------

; ODBC.INI - INTERSOLV ODBC Driver Manager INI File

;---------------------------------------------------

[ODBC Data Sources]

qess=SQL Server

qedbf=dBASE

qeor7=Oracle

[qess]

Driver=qess06.dll

Description=INTERSOLV SQL Server driver

ServerName=alice

LogonID=prova

[qedbf]

Driver=qedbf06.dll

Description=INTERSOLV dBASE driver

Database=C:\DBASE

[qeor7]

Driver=qeor706.dll

Description=INTERSOLV Oracle driver

ServerName=t:magna:V7

LogonID=prova


Messaggi di errore

I messaggi di errore possono essere generati dai seguenti elementi:

•	Un driver ODBC

•	Il sistema di database

•	Il gestore del driver

Un errore generato da un driver ODBC ha il seguente formato:

[produttore] [componente_ODBC] messaggio

componente_ODBC è il componente nel quale si è verificato l'errore. Ad esempio, un messaggio generato dal driver di INTERSOLV SQL avrebbe il seguente formato:

[INTERSOLV] [ODBC SQL Server driver] Login errato.

Se viene visualizzato un errore di questo tipo, verificare l'ultima chiamata a ODBC dell'applicazione per rilevare i possibili problemi o contattare il fornitore dell'applicazione ODBC.

Un errore che si verifica nell'origine dei dati, include il nome dell'origine dei dati ed ha il formato seguente:

[produttore] [componente_ODBC] [origine_dati] messaggio

In questo tipo di messaggio, componente_ODBC è il componente che ha ricevuto il messaggio di errore dall'origine dati indicata. Ad esempio, è possibile avere il seguente messaggio da un'origine dati Oracle:

[INTERSOLV] [ODBC Oracle driver] [Oracle] ORA-0919: la lunghezza specificata è eccessiva per la colonna CHAR.

Se viene visualizzato questo tipo di errore, è stata compiuta una operazione non corretta in relazione al sistema di database. Controllare la documentazione del sistema di database per maggiori informazioni oppure contattare l'amministratore del database. In questo esempio, sarebbe necessario consultare la documentazione di Oracle.

Errori del Gestore del driver

Il Gestore del driver è un file .DLL che stabilisce delle connessioni con i driver, sottopone le richieste ai driver e restituisce i risultati alle applicazioni. Un errore relativo al gestore del driver ha il seguente formato:

[produttore] [ODBC DLL] messaggio

Il produttore può essere Microsoft, Apple o INTERSOLV. Ad esempio, un errore dal gestore del driver di Microsoft potrebbe essere simile al seguente:

[Microsoft] [ODBC Driver Manager] Il driver non supporta questa funzione.

Se viene visualizzato un errore di questo tipo, consultare la Programmer's Reference Documentation per il Microsoft ODBC Software Development Kit, disponibile presso Microsoft.


Uso dei driver ODBC in Windows NT e Windows 95

In Windows 95 e Windows NT, i driver ODBC sono driver a 32 bit. Il software di rete fornito dai produttori del sistema di database deve essere a 32 bit. Consultare la sezione “Requisiti di sistema” per un elenco dei requisiti specifici per ogni driver di database relazionale.

ODBC.INI

ODBC.INI è una sottochiave della chiave principale HKEY_CURRENT_USER\SOFTWARE\ODBC del registro di configurazione di Windows NT e Windows 95. La sottochiave ODBC.INI è gestita da ODBC Administrator, posto nel Pannello di controllo di Windows. Poiché Windows NT e Windows 95 supportano più utenti, la sottochiave ODBC.INI viene memorizzata sotto chiavi utente uniche del registro. Per ulteriori informazioni, consultare l'argomento su OBDC.INI.

Avvio di ODBC Administrator

La sezione “Configurazione delle origini di dati” presente negli argomenti relativi ai driver indica di avviare ODBC Administrator. Per avviare ODBC Administrator, fare doppio clic sull'icona ODBC32 nel Pannello di controllo.

Nomi di driver

In Windows NT e Windows 95, tutti i driver ODBC iniziano con LO. L'estensione dei file dei driver ODBC è .DLL. Il numero corrisponde al livello di versione dei driver. Ad esempio, il driver Oracle è LOOR709.DLL. Vedere la lista dei driver per i nomi dei file di driver specifici.

Requisiti relativi alla memoria e allo spazio su disco

Sono richiesti 6 MB di spazio disponibile sull'unità disco nella quale è installato Windows NT o Windows 95.

I requisiti di memoria variano a seconda del driver del database. Se si usa un driver di database flat-file, è necessario disporre di almeno 8 MB di memoria in Windows 95 o almeno di 16 in Windows NT. Se è installato un sistema di database relazionale, potrebbe essere necessario disporre di una maggiore quantità di memoria. Consultare la documentazione del database relazionale per determinare i requisiti esatti di memoria.