Copyright: Copyright (C) 1996 Lotus Development Corporation


A propos du pilote Server SQL

Le pilote du serveur SQL prend en charge le système de gestion de base de données du serveur SQL disponible auprès de  Microsoft et Sybase. Il prend également en charge la passerelle de connexion à DB2, Sybase Net Gateway.

Le nom de fichier de ce serveur est LOSS09.DLL.

Copyright


Boîte de dialogue de configuration ODBC du serveur SQL

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 "Serveur SQL - Serv1".

Description

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

Server Name

Nom du serveur contenant la base de données souhaitée.

Database Name

Nom de la base de données à laquelle vous souhaitez vous connecter par défaut. Si vous ne spécifiez aucune valeur, la base de données par défaut définie par le serveur SQL est utilisée.

Les valeurs suivantes sont facultatives  :

Server List

Liste des serveurs, dont les noms sont séparés par des virgules. Elle apparaît dans la boîte de dialogue de connexion.

Database List

Liste des bases de données disponibles dans la boîte de dialogue de connexion au serveur SQL. Séparez les noms par des virgules.

Default Logon ID

ID de connexion par défaut utilisé pour la connexion à la base de données de votre serveur SQL. Cet ID prend en compte les majuscules. Un ID de connexion 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 chaîne de connexion.

Language

Langue utilisée par le client. La valeur par défaut est l'anglais.

Application Name

Nom utilisé par le serveur SQL pour identifier votre application.

Workstation ID

ID de poste de travail utilisé par le client.

Cursor Cache Size

Nombre de curseurs que peut contenir la mémoire cache du curseur. Le pilote crée une mémoire cache d'instructions  ; chaque instruction représente une connexion ouverte au serveur SQL. La quantité de mémoire allouée au curseur accroît ses performances mais utilise les ressources de la base de données. La valeur par défaut est 1 (un curseur).

Yield Proc

Valeur numérique déterminant s'il est possible de travailler dans d'autres applications Windows pendant le fonctionnement du serveur SQL. Cet attribut est utile pour les utilisateurs d'applications ODBC. Les valeurs correctes sont  :

•	0 (examen et distribution)  :  oblige le pilote à consulter la file d'attente des messages de Windows et à envoyer tous les messages vers l'application Windows appropriée.

•	1 (pas de rendement ; il s'agit de la valeur par défaut)  :  ne vous autorise pas à travailler dans d'autres applications.

•	3 (distribution via la fonction Yield de Windows)  :  donne le contrôle au noyau de Windows. Celui-ci consulte la file d'attente des messages et envoie les messages vers la fenêtre de l'application appropriée.

Il vous est recommandé d'utiliser la valeur par défaut, c'est-à-dire 1.

Character Conversion

Valeur contrôlant la conversion des jeux de caractères entre le serveur SQL (version 4.8 ou plus récente) et une application client. Si vous omettez cette valeur, aucune conversion de caractères ne se produit sur votre serveur.

Les valeurs courantes incluent iso-1 pour ISO-8859-1, cp850 pour la page de code 850, roman8 pour le jeu de caractères Roman8 et SJIS pour un jeu de caractères japonais.  Consultez la documentation de votre serveur SQL pour connaître la liste complète de ces valeurs.

Cancel Behavior

Valeur spécifiant les modalités d'annulation d'une instruction exécutée précédemment. Les valeurs correctes sont  :

•	0 extrait tous les enregistrements restants si l'instruction est une instruction Select.

•	1 annule l'instruction en appelant dbcancel. Il s'agit de la valeur par défaut, à utiliser si dbcancel est pris en charge par votre configuration client/serveur.

•	2 interrompt la connexion au serveur pour l'instruction. Utilisez cette valeur uniquement si dbcancel n'est pas pris en charge pour votre configuration et si l'extraction de tous les enregistrements restants ne convient pas.

Using Gateway

Sélectionnez cette case à cocher si vous utilisez Sybase Net-Gateway pour accéder à une base de données DB2 dotée de cette source de données.

Bibliothèque NETAPI.DLL disponible

Le pilote utilise le fichier NETAPI.DLL pour connaître le nom de votre poste de travail. La plupart des réseaux PC prennent en charge cette fonctionnalité. Si ce n'est pas le cas de votre réseau, sélectionnez cette option. Si vous entrez un ID de poste de travail, ce champ n'est pas pris en compte.

Two-Phase Commit

Case à cocher permettant, lorsqu'elle est sélectionnée, d'avoir deux instructions actives dans une transaction à l'aide des services de COMMIT en deux étapes du serveur SQL. Ces instructions actives peuvent créer un interblocage lorsqu'elles se rapportent à la même table du serveur SQL.

 Voir rubriques connexes


Connexion à Microsoft/Sybase SQL Server 4.x à 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 préciser 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. Si vous le souhaitez, vous pouvez également indiquer des paires attribut=valeur dans la chaîne de connexion pour annuler l'effet des valeurs par défaut contenues dans la section du fichier ODBC.INI de la base de registres.

Vous pouvez spécifier des noms complets ou leur abréviation dans la chaîne de connexion. Cette dernière prend la forme suivante  :

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

Voici un exemple de chaîne de connexion pour le serveur SQL  :

DSN  =  Accounting;DB=PAYROLL;UID=JOHN;PWD=XYZZY

Dans le tableau ci-dessous figurent le nom complet et l'abréviation de 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 avez précisé une valeur pour l'attribut lors de la configuration de la source de données, cette valeur devient alors la valeur par défaut.

Attribut	Description
DataSourceName (DSN)	Chaîne identifiant une configuration de source de données de serveur SQL dans la section du fichier ODBC.INI. de la base de registres. Exemples  :  "Accounting" ou "SQL Server-Serv1".
ServerName (SRVR)	Nom du serveur contenant les tables du serveur auxquelles vous souhaitez accéder.
Database (DB)	Nom de la base de données à laquelle vous souhaitez vous connecter.
LogonID (UID)	ID de connexion (respect des majuscules et des minuscules) utilisé pour vous connecter à la base de données de votre serveur SQL. Un ID de connexion n'est nécessaire que si un système de protection est activé sur votre base de données. Si c'est le cas, contactez l'administrateur de votre système afin d'obtenir votre ID de connexion.
Password (PWD)	Mot de passe prenant en compte les majuscules et les minuscules.
Language (LANG)	Langue que le client doit utiliser. L'anglais est la langue initiale par défaut.
ApplicationName (APP)	Nom que le serveur SQL utilise pour identifier votre application.
WorkstationID (WKID)	ID du poste de travail utilisé par le client.
CursorCacheSize (CCS)	Nombre de curseurs contenus dans la mémoire cache du curseur. Le pilote crée une mémoire cache d'instructions  ; chacune d'elles représente une connexion ouverte au serveur SQL. La mémoire cache du curseur augmente les performances mais utilise les ressources de la base de données. 1 est le nombre initial par défaut.
YieldProc (YLD)	YieldProc={0 | 1 | 3}. Valeur numérique déterminant s'il vous est possible de travailler dans d'autres applications alors que le serveur SQL fonctionne. Cet attribut est utile pour les utilisateurs d'applications ODBC. Les valeurs correctes sont  :   • YieldProc=0 (examen et distribution) :  oblige le pilote à consulter la file d'attente des messages de Windows et à envoyer tous les messages vers l'application Windows appropriée. • YieldProc=1 (pas de rendement ; il s'agit de la valeur d'origine par défaut)  :  ne vous autorise pas à travailler dans d'autres applications ne fonctionnant pas. • YieldProc=3 (distribution via la fonction Yield de Windows)  :  donne le contrôle au noyau de Windows. Celui-ci consulte la file d'attente des messages et envoie tous les messages vers la fenêtre des applications appropriées. Cet attribut ne peut pas être modifié sous Windows NT ou Windows 95. YieldProc est défini sur la valeur 1 comme paramètre par défaut. Ainsi vous pouvez travailler dans d'autres applications Windows pendant le fonctionnement de SQL Server. Si YieldProc=0, 2 ou 3, vous ne pourrez pas travailler dans d'autres d'applications Windows pendant le fonctionnement de SQL Server.
CharConv (CC)	Valeur contrôlant la conversion de la chaîne de caractères entre le serveur SQL (version 4.8 ou ultérieure) et l'application client. Les valeurs communes incluent iso-1 pour ISO-8859-1, cp850 pour Code Page 850, roman8 pour la chaîne de caractères Roman8 et SJIS pour une chaîne de caractères japonais. Pour la liste complète des valeurs, consultez la documentation relative à votre serveur SQL.
Cancel (CAN)	Cancel={0 | 1 | 2}. Valeur spécifiant la façon d'annuler une instruction exécutée auparavant. Les valeurs utilisées sont  :   • Cancel=0 : extrait les enregistrements restants dans le cas où l'instruction est une instruction Select. • Cancel=1 : annule l'instruction en appelant dbcancel. Paramétrez Cancel=1 dans le cas où dbcancel est pris en charge dans la configuration de votre client/serveur. C'est la valeur initiale par défaut. • Cancel=2 :  ferme la connexion au serveur pour l'instruction. Paramétrez Cancel=2 uniquement dans le cas où dbcancel n'est pas pris en charge par votre configuration et où la rapidité d'extraction des enregistrements restants est inacceptable.
Gateway (GW)	Gateway={0 | 1}. Valeur indiquant si vous utilisez Sybase Net-Gateway pour accéder à une base de données DB2 à l'aide de cette source de données. Si c'est le cas, paramétrez Gateway=1. Sinon, paramétrez Gateway=0 (valeur initiale par défaut).
TwoPhaseCommit (TPC)	TwoPhaseCommit={0 | 1}. Attribut permettant d'avoir au moins deux instructions activées au cours d'une transaction, à l'aide des services d'enregistrement en deux phases du serveur SQL. Paramétrez TwoPhaseCommit=1 pour utiliser ce type d'enregistrement. Les instructions actives peuvent bloquer si elles se réfèrent à la même table de serveur SQL. Dans le cas contraire, paramétrez TwoPhaseCommit=0 (attribut initial par défaut).
Netapi (NAPI)	Netapi= {0 | 1}. Valeur spécifiant si NETAPI.DLL est disponible. Netapi=0, valeur par défaut, indique qu'il n'est pas disponible ; Netapi=1 indique qu'il l'est. Si vous fournissez une valeur pour l'attribut ID de poste de travail, cet attribut est ignoré.
ModifySQL (MS)	ModifySQL={0 | 1}. Attribut fourni pour la compatibilité en amont. Il détermine si le pilote modifie les instructions SQL pour les conformer aux spécifications ODBC ou s'il passe l'instruction SQL directement au serveur SQL. Précisez ModifySQL=1 pour que le pilote modifie l'instruction SQL pour la conformer aux spécifications ODBC. Précisez ModifySQL=0 pour que le pilote comprenne les langages SQL présents dans des pilotes moins récents. 1 est l'attribut par défaut.


Options de connexion au serveur SQL

Database name

Entrez le nom de la base de données initiale du serveur SQL à laquelle vous souhaitez vous connecter ou sélectionnez-le dans la liste déroulante. S'il n'y figure pas, utilisez celui que le serveur SQL a défini par défaut.

Workstation ID

Entrez le nom de votre poste de travail.


Boîte de dialogue de connexion au serveur SQL

Server name

Entrez le nom du serveur contenant les tables de base de données du serveur SQL auxquelles vous souhaitez accéder (respectez les majuscules et les minuscules) ou sélectionnez-le dans la zone Server Name ; cette dernière affiche le nom des serveurs que vous avez spécifiés dans la boîte de dialogue Setup.

Login ID

Si nécessaire, entrez votre ID de connexion, en respectant les majuscules et les minuscules.

Password

Si nécessaire, entrez le mot de passe de votre système, en respectant les majuscules et les minuscules.

 Voir rubriques connexes


Configuration système

Vous devez installer les bibliothèques de bases de données et de réseau appropriées pour avoir accès aux bases de données du serveur SQL Microsoft ou SQL Sybase.

Votre base de données doit prendre en charge des procédures répertoriées.

La bibliothèque de bases de données de Windows est NTWDBLIB.DLL.

La bibliothèque de réseau dont vous avez besoin dépend du protocole s'appliquant au réseau et servant à la connexion au serveur SQL. Par exemple, les canaux de communication nommés de commandes nécessitent BNMPNTW.DLL.

Contactez le vendeur de votre serveur SQL Microsoft ou SQL Sybase pour obtenir les bibliothèques de bases de données et de réseau appropriées.

WDBPING est un outil Windows livré avec des bibliothèques de réseau. Il permet de tester la connectivité entre le poste de travail du client et le serveur de base de données. Servez-vous de cet outil pour tester votre connexion.

Si vous essayez de configurer une source de données et que vous ne possédez pas le fichier NTWDBLIB.DLL dans votre chemin d'accès ou dans le dossier Windows \SYSTEM32 ou Windows  95\SYSTEM, le message suivant apparaît :

"The setup routines for the INTERSOLV SQL Server 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 serveur SQL, effectuez les opérations suivantes :

1.	Démarrer 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 le serveur SQL INTERSOLV  2.10  et cliquez sur OK.

4.	Si vous configurez une source de données existante, sélectionnez-la 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 le fichier ODBC.INI.

La boîte de dialogue Select Translator apparaît, dans laquelle vous sélectionnez un traducteur. INTERSOLV offre un traducteur appelé INTERSOLV OEM ANSI qui transcode des données du jeu de caractères du IBM PC au jeu de caractères ANSI. Les traducteurs répertoriés dans cette boîte de dialogue sont définis par les valeurs apparaissant dans la section ODBC Translators du fichier ODBCINST.INI.

7.	Cliquez sur OK pour sélectionner la boîte de dialogue Select Translator et effectuez la conversion.

8.	Cliquez sur OK pour écrire ces valeurs sur ODBC.INI.

Ces valeurs représentent maintenant les valeurs par défaut utilisées à chaque fois que vous vous connectez à la source de données. Vous pouvez les modifier en configurant à nouveau votre source de données. Vous pouvez également annuler leur effet en vous connectant à la source de données à l'aide d'une chaîne de connexion comportant d'autres valeurs.


Connexion à Microsoft/Sybase SQL Server 4.x à l'aide d'une boîte de dialogue de connexion

Certaines applications ODBC affichent une boîte de dialogue de connexion quand 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, effectuez les opérations suivantes  :

1.	Entrez le nom du serveur contenant les tables de base de données du serveur SQL auxquelles vous souhaitez accéder (respectez les majuscules et les minuscules) ou sélectionnez-le dans la liste déroulante Server Name  ;  celle-ci affiche le nom des serveurs que vous avez spécifiés dans la boîte de dialogue de configuration.

2.	Si nécessaire, entrez votre ID de connexion, en respectant les majuscules et les minuscules.

3.	Si nécessaire, entrez le mot de passe de votre système, en respectant les majuscules et les minuscules.

4.	(Facultatif) Cliquez sur Options pour afficher la boîte de dialogue SQL Server Logon Options et spécifiez la base de données initiale du serveur SQL à laquelle vous souhaitez vous connecter, ainsi que le nom de votre poste de travail.

5.	Cliquez sur OK afin de vous connecter à la base de données du serveur SQL installée sur le serveur que vous avez spécifié et afin de mettre à jour les valeurs du fichier ODBC.INI.


Types de données

Les types de données du serveur SQL sont associés aux types de données ODBC standard comme suit  :

Serveur SQL	ODBC
binary	SQL_BINARY
bit	SQL_BIT
char	SQL_CHAR
datetime	SQL_TIMESTAMP
float	SQL_FLOAT
image	SQL_LONGVARBINARY
int	SQL_INTEGER
money	SQL_DECIMAL
real	SQL_REAL
smalldatetime	SQL_TIMESTAMP
smallint	SQL_SMALLINT
smallmoney	SQL_DECIMAL
sysname	SQL_VARCHAR
text	SQL_LONGVARCHAR
timestamp	SQL_VARBINARY
tinyint	SQL_TINYINT
varbinary	SQL_VARBINARY
varchar	SQL_VARCHAR


Niveau d'isolement et de verrouillage pris en charge

Le serveur SQL prend en charge le niveau 1 d'isolement ainsi que le verrouillage de niveau page.


Niveaux de conformité ODBC

Le pilote du serveur SQL prend en charge les fonctions API Core, Level 1 et Level 2 répertoriées dans la rubrique Fonctions ODBC prises en charge. Les fonctions Level 2 suivantes sont également prises en charge  :

•	SQLBrowseConnect

•	SQLColumnPrivileges

•	SQLForeignKeys

•	SQLPrimaryKeys

•	SQLProcedureColumns

•	SQLProcedures

•	SQLTablePrivileges

Le pilote prend en charge la syntaxe grammaticale SQL minimale.


Nombre de connexions et d'instructions prises en charge

Le système de base de données du serveur SQL prend en charge des connexions multiples. A l'aide de l'enregistrement en deux phases, le serveur SQL prend en charge plusieurs instructions par connexion. Le cas échéant, le serveur SQL prend en charge une seule instruction par connexion lorsque SQL_AUTOCOMMIT est paramétré sur égal à 0 et plusieurs instructions par connexion lorsque SQL_AUTOCOMMIT est paramétré sur égal à 1.


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 ODBC SQL Server Advanced Driver Setup

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

Server List

Liste des serveurs séparés par une virgule apparaissant dans la boîte de dialogue de connexion.

Database List

Bases de données disponibles dans la boîte de dialogue SQL Server Logon Options. Séparez les noms par des virgules.

Default Logon ID

ID de connexion par défaut utilisé pour vous connecter à la base de données SQL Server. Cet ID tient compte des majuscules/minuscules. Un ID de connexion est requis si votre base de données est protégée. Votre application ODBC peut ignorer cette valeur ou vous pouvez ignorer cette valeur dans la boîte de dialogue de connexion ou dans la chaîne de connexion.

Language

Langue utilisée par le client. Le paramètre par défaut initial est l'anglais.

Application Name

Nom utilisé par SQL Server pour identifier votre application.

Workstation ID

ID de la station de travail utilisé par le client.

Cursor Cache Size

Nombre de curseurs contenus dans la mémoire cache du curseur. Le pilote crée une mémoire cache d'instructions. Chaque instruction représente une connexion ouverte à SQL Server. La mémoire cache du curseur augmente la performance des ressouces de la base de données. Le paramètre par défaut est 1 (un curseur).

Yield Proc

Valeur numérique qui détermine si vous pouvez travailler dans d'autres applications pendant le fonctionnement de SQL Server. Cet attribut est utile aux utilisateurs d'applications ODBC. Les valeurs acceptées sont :

•	0 (examen et distribution) oblige le pilote à consulter la file d'attente des messages de Windows et à envoyer tous les messages à l'application Windows appropriée.

•	1 (pas de rendement, il s'agit de la valeur par défaut) ne vous autorise pas à travailler dans d'autres applications.

•	3 (distribution via la fonction de rendement Windows) donne le contrôle au noyau de Windows. Celui-ci consulte la file d'attente des messages et envoie les messages vers la fenêtre de l'application appropriée.

Cet attribut ne peut pas être modifié sous Windows NT ou Windows 95. YieldProc est défini sur la valeur 1 comme paramètre par défaut. Ainsi vous pouvez travailler dans d'autres applications Windows pendant le fonctionnement de SQL Server. Si YieldProc=0, 2 ou 3, vous ne pourrez pas travailler dans d'autres d'applications Windows pendant le fonctionnement de SQL Server.

Character Conversion

Valeur qui contrôle la conversion d'un jeu de caractères entre SQL Server (version 4.8 ou supérieure) et une application client.  Si vous omettez cette valeur, la conversion de caractères sur votre serveur sera impossible.

Les valeurs communes incluent iso-1 pour ISO-8859-1, cp850 pour Code Page 850, roman8 pour le jeu de caractères Roman8 et SJIS pour un jeu de caractères japonais. Pour connaître la liste complète des valeurs, consultez la documentation relative à SQL Server.

Cancel Behavior

Valeur définissant comment une instruction exécutée précédemment doit être annulée. Les valeurs acceptées sont   :

•	0 extrait tous les enregistrements restants si l'instruction était une instruction Select.

•	1 annule l'instruction en appelant dbcancel. Il s'agit de la valeur par défaut d'origine et devrait être utilisée si dbcancel est pris en charge dans votre configuration client/serveur.

2  interrompt la connexion au serveur pour l'instruction. Ne définissez Cancel=2 que si dbcancel n'est pas pris en charge par votre configuration et que si l'extraction de tous les fichiers restants est impossible.

Using Gateway

Sélectionnez cette case à cocher si vous utilisez Sybase Net-Gateway pour accéder à la base de données DB2 à l'aide de cette source de données.

NETAPI.DLL Library Available

Le pilote utilise le fichier NETAPI.DLL pour obtenir le nom de votre poste de travail. La plupart des grands réseaux PC prennent cette fonction en charge. Si votre réseau prend en charge cette potentialité, sélectionnez cette option. Si vous fournissez un ID de poste de travail, ce champ est ignoré.

Two-Phase Commit

Lorsque cette case à cocher est sélectionnée, vous pouvez avoir deux instructions actives dans une transaction à l'aide des services d'enregistrement en deux phases de SQL Server. Les instructions actives peuvent provoquer un blocage si elles font référence à la même table SQL Server.

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 PC IBM en un jeu de caractères ANSI.

Close

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