Copyright: Copyright (C) 1996 Lotus Development Corporation


A propos du pilote ODBC Oracle 7

Le pilote Oracle prend en charge les systèmes de gestion de base de données Oracle 7.

Le nom de fichier de ce pilote est LOOR709.DLL.

Copyright


Boîte de dialogue de configuration ODBC d'Oracle

Data Source Name

Chaîne identifiant la configuration de la source de données INFORMIX dans le fichier ODBC.INI.  Les exemples  incluent  "Accounting" ou "Oracle-Serv1".

Description

Longue description facultative du nom d'une source de données. Par exemple, "Ma base de données Comptabilité" ou "Oracle sur Serveur numéro 1".

Server Name

Chaîne de connexion SQL*Net désignant le serveur et la base de données auxquels vous souhaitez accéder. Les informations requises varient en fonction du pilote SQL*Net utilisé. Consultez Connexion à Oracle à l'aide d'une chaîne de connexion pour en savoir plus sur le format de la chaîne de connexion SQL*Net.

Les valeurs suivantes sont facultatives  :

Server List

Liste des chaînes de connexion SQL*Net figurant dans la boîte de dialogue de connexion. Séparez les chaînes par des virgules. Si la chaîne de connexion contient une virgule, saisissez-la entre des guillemets  ;  par exemple, "Serv,1", "Serv,2", "Serv,3".

Default User Name

Nom d'utilisateur par défaut employé pour la connexion à votre base de données Oracle. Un nom d'utilisateur par défaut n'est exigé que lorsque le système de protection est activé sur votre base de données. Votre application ODBC peut ne pas tenir compte de cette valeur ou vous-même pouvez passer outre, dans la boîte de dialogue ou la chaîne de connexion.

Lock Time Out

Valeur spécifiant si Oracle doit attendre un déverrouillage avant d'afficher un message d'erreur lorsqu'il traite une instruction Select...For Update Of. Les valeurs peuvent être -1 (attendre indéfiniment) ou 0 (ne pas attendre). La valeur par défaut est -1.

Array Size

Nombre d'octets que le pilote utilise pour extraire plusieurs lignes. Les valeurs peuvent aller de 0 à 65  536. La valeur par défaut d'origine est 60  000. Des valeurs plus importantes augmentent le rendement en réduisant le nombre de fois où le pilote extrait des données dans l'ensemble du réseau. Des valeurs plus faibles augmentent les temps de réponse puisque le serveur met davantage de temps à transmettre les données.

Catalog Comments

Cochez cette case si vous souhaitez extraire le contenu de la colonne COMMENTAIRES de vos bases de données Oracle. Ceci peut avoir des répercussions sur l'exécution de vos interrogations.

Translate

Affiche la boîte de dialogue Select Translator pour vous permettre de convertir un jeu de caractères en un autre. Sélectionnez le filtre d'INTERSOLV OEM ANSI pour convertir des données du jeu de caractères PC d'IBM au jeu de caractères ANSI.


Connexion à Oracle à l'aide d'une chaîne de connexion

Si votre application requiert une chaîne de connexion pour être reliée à une source de données, vous devez spécifier le nom de la source de données. Ce nom indique en effet au pilote la section du fichier ODBC.INI de la base de registres où figurent les informations nécessaires à la connexion par défaut. A titre facultatif, vous pouvez spécifier les paires attribut=valeur dans la chaîne de connexion pour que les valeurs par défaut contenues dans la section du fichier ODBC.INI de la base de registres ne soient pas prises en compte.

Vous pouvez spécifier des noms complets ou des abréviations dans la chaîne de connexion. La chaîne de connexion se présente de la façon suivante  :

DSN=nom_source_données[;attribut=valeur[;attribut=valeur]...]

Voici un exemple de chaîne de connexion pour Oracle  :

DSN=Accounting;SRVR=X:QESRVR;UID=JOHN;PWD=XYZZY

Si le nom du serveur contient un point virgule, saisissez-le à l'intérieur de guillemets  :

DSN=Accounting;SRVR="X:QE;SRVR";UID=JOHN;PWD=XYZZY

Le tableau suivant présente des noms complets ou des abréviations pour chaque attribut, ainsi qu'une description.

Les paramètres par défaut répertoriés dans le tableau sont des valeurs par défaut appliquées lorsqu'aucune valeur n'est définie dans la chaîne de connexion ni dans la définition de la source de données figurant dans la section du fichier ODBC.INI de la base de registres. Si vous spécifiez une valeur pour un attribut au moment de la configuration de la source de données, celle-ci constitue votre valeur par défaut.

Attribut	Description
DataSourceName (DSN)	Chaîne identifiant la configuration d'une source de données Oracle dans la section du fichier ODBC.INI de la base de registres. Exemple  : "Accounting" et "Oracle-Serv1".
LogonID (UID)	ID de connexion (nom de l'utilisateur) que l'application utilise pour se connecter à votre base de données Oracle. Un ID de connexion est nécessaire uniquement si la sécurité est activée sur votre base de données. Si tel est le cas, adressez-vous à votre administrateur système pour qu'il vous attribue un ID de connexion.
Password (PWD)	Votre mot de passe.
LockTimeOut (LTO)	LockTimeOut={0 | -1}. Valeur qui spécifie si Oracle doit attendre un déverrouillage avant d'afficher un message d'erreur lorsqu'il traite une instruction Select...For Upgrade Of. Les valeurs peuvent être -1 (attendre indéfiniment, la valeur par défaut d'origine) ou 0 (ne pas attendre).
ArraySize (AS)	Nombre d'octets que le pilote utilise pour extraire plusieurs lignes. Les valeurs peuvent aller de 0 à 65 536. La valeur par défaut d'origine est 60 000. Des valeurs plus importantes augmentent le rendement en réduisant le nombre de fois où le pilote extrait des données dans l'ensemble du réseau. Des valeurs plus faibles augmentent les temps de réponse puisque le serveur met davantage de temps à transmettre les données.
ServerName (SRVR)	Chaîne de connexion SQL*Net désignant le serveur et la base de données à atteindre. Les informations requises varient en fonction du pilote SQL*Net utilisé. La chaîne de connexion SQL*Net se présente de la façon suivante  : préfixe_pilote:nom_ordinateur[:sid] préfixe_pilote est une lettre identifiant le protocole de réseau utilisé. Le préfixe du pilote peut être comme suit  : P (canaux de communication nommés de commandes), X (SPX), B (NetBIOS), T (TCP/IP), D (DECNet), A (Oracle Async) ou AT (AppleTalk). Consultez votre documentation Oracle pour d'autres protocoles. nom_ordinateur est le nom de l'Oracle Listener de votre réseau. sid est l'Oracle System Identifier et se rapporte à l'instance de l'exécution d'Oracle sur l'ordinateur central. Cet élément est nécessaire lorsque l'on se connecte à des systèmes qui prennent en charge plus d'une instance d'une base de données Oracle. Si la chaîne de connexion SQL*Net comporte des points virgule, saisissez-les à l'intérieur de guillemets. Pour de plus amples informations, reportez-vous à votre documentation SQL*Net.
PacketSize (PS)	PacketSize={1024 | 2048 | 4096 | 8192}. Valeur qui contrôle la taille de paquets des connexions TCP/IP. Toutes les valeurs autres que 1024, 2048, 4096, ou 8192 sont ignorées. L'option PacketSize est utilisée uniquement lorsque la chaîne de connexion définie dans l'option Nom de serveur contient un T pour TCP/IP comme préfixe_pilote. Pour en savoir plus, consultez l'option ServerName.
CatalogComments (CC)	CatalogComments={0 | 1}. Valeur qui spécifie si le pilote doit renvoyer le contenu de la colonne COMMENTS des tables Oracle. CatalogComments=1 renvoie COMMENTS. CatalogComments=0 ne renvoie pas COMMENTS (la valeur par défaut).


Copyright  INTERSOLV

Copyright 1995 INTERSOLV Inc. Tous droits réservés. INTERSOLV est une marque déposée et DataDirect une marque d'INTERSOLV, Inc. Tous les autres noms de sociétés ou de produits mentionnés ici sont des marques ou des marques déposées de leurs propriétaires respectifs.


Boîte de dialogue de connexion à Oracle

Server Name

Saisissez la chaîne de connexion SQL*Net de l'ordinateur contenant les tables de base de données Oracle auxquelles vous souhaitez accéder ou sélectionnez la chaîne à partir de la liste déroulante Server Name qui affiche les noms que vous avez spécifiés dans la boîte de dialogue Setup.

User Name

Si nécessaire, entrez votre nom d'utilisateur Oracle.

Password

Si nécessaire, entrez votre mot de passe Oracle.

 Voir rubriques connexes


Exigences système

Le produit Oracle SQL*Net est requis pour accéder à des bases de données Oracle distantes.

Les fichiers .DLL appropriés de la version actuelle de SQL *Net et OCIW32.DLL doivent résider sur le chemin d'accès ou dans le dossier Windows NT \SYSTEM32 ou Windows 95 \SYSTEM . SQL *Net 2.2 requiert :

•	ORA72.DLL

•	CORE34.DLL

•	NLSRT31.DLL

•	CORE340.DLL

•	OCIW32.DLL

SQL *Net 2.1 requiert :

•	ORENT23.DLL

•	ORANT71.DLL

OCIW32.DLL

Par défaut, le programme d'installation installe ces fichiers dans le dossier Windows NT \SYSTEM32 ou Windows 95 \SYSTEM. Dans le cas contraire, le message suivant apparaît lorsque vous tentez de configurer une source de données Oracle 7 :

"The setup routines for the INTERSOLV OEM 2.12 32-BIT Oracle7 ODBC driver could not be loaded. You may be low on memory and need to quit a few applications."


Configuration des sources de données

Pour configurer une source de données Oracle, effectuez les opérations suivantes  :

1.	Démarrez l'administrateur ODBC.

La liste des sources de données apparaît.

2.	Si vous configurez une nouvelle source de données, cliquez sur Add.

La liste des pilotes installés apparaît.

3.	Sélectionnez INTERSOLV Oracle7 et cliquez sur OK.

4.	Si vous configurez une source de données existante, sélectionnez son nom et cliquez sur Setup.

La boîte de dialogue de configuration apparaît.

5.	Indiquez les valeurs à utiliser.

6.	Cliquez sur OK pour enregistrer ces valeurs dans ODBC.INI.

Ces valeurs sont désormais les valeurs par défaut lorsque vous vous connectez à cette source de données. Vous pouvez les modifier en configurant à nouveau votre source de données. Pour ignorer les valeurs par défaut, vous pouvez vous connecter à cette source de données en utilisant une chaîne de connexion comportant d'autres valeurs.


Connexion à Oracle à l'aide d'une boîte de dialogue de connexion

Certaines applications ODBC affichent une boîte de dialogue de connexion lorsque vous vous connectez à une source de données. Dans ce cas, le nom de la source de données a déjà été spécifié.

Dans la boîte de dialogue de connexion, procédez comme suit  :

1.	Saisissez la chaîne de connexion SQL*Net de l'ordinateur contenant les tables de base de données Oracle auxquelles vous souhaitez accéder ou sélectionnez la chaîne dans la liste déroulante Server Name qui affiche les noms que vous avez spécifiés dans la boîte de dialogue de configuration.

2.	Si nécessaire, entrez votre nom d'utilisateur Oracle.

3.	Si nécessaire, entrez votre mot de passe Oracle.

4.	Cliquez sur OK pour vous connecter à la base de données Oracle installée sur le serveur spécifié et mettre à jour les valeurs dans ODBC.INI.


Types de données

Les types de données Oracle 7 correspondent aux types de données ODBC standard suivants  :

Oracle 7	ODBC
Char	SQL_CHAR
Date	SQL_TIMESTAMP
Long	SQL_LONGVARCHAR
Long Raw	SQL_LONGVARBINARY
Number	SQL_DOUBLE
Number(p,s)	SQL_DECIMAL
Raw	SQL_VARBINARY
Varchar2	SQL_VARCHAR


Niveaux d'isolation et de verrouillage pris en charge
Niveaux d'isolement et de verrouillage pris en charge

Oracle 7 ne prend en charge que le niveau d'isolement 2 (lecture reproductible) et le verrouillage de niveau enregistrement.


Niveaux de conformité avec ODBC

Le pilote Oracle 7 prend en charge les fonctions API Core, Level 1 et Level 2 répertoriées dans la rubrique Fonctions ODBC prises en charge. Le pilote Oracle 7 prend également en charge les fonctions de niveau 2 suivantes  :

•	SQLBrowseConnect

•	SQLProcedures

•	SQLProcedureColumns

•	SQLPrimaryKeys

•	SQLForeignKeys

Le pilote prend en charge la syntaxe grammaticale SQL.


Nombre de connexions et d'instructions prises en charge

Oracle 7 prend en charge plusieurs connexions et plusieurs instructions par connexion.


Boîte de dialogue ODBC Oracle Advanced Driver Setup

Pour configurer les paramètres facultatifs d'une source de données Oracle, définissez des valeurs comme indiqué ci-dessous :

Server List

Liste des chaînes de connexion SQL*Net qui apparaissent dans la boîte de dialogue de connexion. Séparez les chaînes par des virgules. Si la chaîne de connexion SQL*Net contient une virgule, placez-la entre guillemets : "Serv,1", "Serv,2", "Serv,3."

Default User Name

Nom de l'utilisateur par défaut utilisé pour établir une connexion à la base de données Oracle. Un nom d'utilisateur par défaut est requis uniquement si votre base de données est protégée. Votre application ODBC peut ignorer cette valeur ou vous pouvez l'ignorer dans la boîte de dialogue de connexion ou la chaîne de connexion.

Lock Time Out

Valeur qui définit si Oracle doit attendre un déverrouillage avant d'afficher un message d'erreur lorsqu'il traite une instruction Select...For Update Of. Les valeurs peuvent être -1 (attendre indéfiniment) ou 0 (ne pas attendre). La valeur par défaut est -1.

Array Size

Nombre d'octets que le pilote utilise pour extraire plusieurs lignes. Les valeurs peuvent aller de 0 à 65  536. La valeur par défaut d'origine est 60  000. Des valeurs plus importantes augmentent le rendement en réduisant le nombre de fois où le pilote extrait des données dans l'ensemble du réseau. Des valeurs plus faibles augmentent le temps de réponse puisque le serveur met davantage de temps à transmettre les données.

Packet Size

Valeur qui contrôle la taille du paquet des connexions TCP/IP. Entrez une des tailles de paquets suivantes  :  1024, 2048, 4096 ou 8192. Toute autre valeur est ignorée.

L'option PacketSize est utilisée lorsque la chaîne de connexion définie dans l'option Server Name contient un T pour TCP/IP comme préfixe_pilote. Voir l'option ServerName décrite dans la rubrique Connexion à Oracle à l'aide d'une chaîne de connexion pour le format de la chaîne SQL *Net.

Catalog Comments

Cochez cette case si vous souhaitez récupérer le contenu de la colonne COMMENTS dans vos tables Oracle.  Ce procédé peut avoir des répercussions sur l'exécution de vos requêtes.

Translate

Affiche la boîte de dialogue Select Translator pour vous permettre d'exécuter la conversion de vos données d'un jeu de caractères à un autre. Choisissez le convertisseur OEM/ANSI pour convertir vos données d'un jeu de caractères de type PC IBM en un jeu de caractères ANSI.

Close

Renvoie à la boîte de dialogue Oracle ODBC Setup à partir de laquelle vous pouvez cliquer sur OK pour écrire ces paramètres dans le fichier ODBC.INI.