Crée une nouvelle connexion à une base de données IBM DB2 Universal Database, IBM Cloudscape ou Apache Derby.
Pour une connexion cataloguée de la base de données, database représente l'alias de la base de données dans le catalogue client DB2
Pour une connexion non cataloguée de la base de données, database représente une chaîne complète de connexion qui est dans le format suivant : DRIVER={IBM DB2 ODBC DRIVER};DATABASE=database;HOSTNAME=hostname;PORT=port;PROTOCOL=TCPIP;UID=username;PWD=password; où les paramètres représentent les valeurs suivantes :
Le nom de la base de données.
L'adresse Internet ou IP du serveur de base de données.
Le port TCP/IP sur lequel la base de données écoute les connexions.
Le nom d'utilisateur avec lequel vous vous connectez à la base de données.
Le mot de passe avec lequel vous vous connectez à la base de données.
Le nom d'utilisateur avec lequel vous vous connectez à la base de données.
Pour les connexions non cataloguées, vous devez passer une valeur NULL ou une chaîne vide.
Le mot de passe avec lequel vous vous connectez à la base de données.
Pour les connexions non cataloguées, vous devez passer une valeur NULL ou une chaîne vide.
Un tableau associatif des options de connexion qui affecteront le comportement de la connexion, où les valeurs des clés incluent :
La valeur DB2_AUTOCOMMIT_ON active l'autocommit sur cette connexion.
La valeur DB2_AUTOCOMMIT_OFF désactive le autocommit pour cette connexion.
Passer la valeur DB2_CASE_NATURAL spécifie que les noms de colonnes seront retournés dans leurs casses naturelles.
Passer la valeur DB2_CASE_LOWER spécifie que les noms de colonnes seront retournés en minuscule.
Passer la valeur DB2_CASE_UPPER spécifie que les noms de colonnes seront retournés en majuscule.
Passer la valeur DB2_FORWARD_ONLY spécifie un curseur uniquement suivant pour une ressource de requête. C'est le type de curseur par défaut et est supporté sur tous les serveurs de base de données.
Passer la valeur DB2_SCROLLABLE spécifie un curseur scrollable pour une ressource de requête. Ce mode permet un accès aléatoire aux lignes dans un jeu de résultats, mais actuellement, n'est supporté que par la base de données IBM DB2 Universal.
Retourne la ressource de connexion si la tentative de connexion réussie. Si la tentative de connexion échoue, db2_connect() retourne FALSE.
Exemple 2. Création d'une connexion non cataloguée Une connexion non cataloguées vous permet de vous connecter dynamiquement à une base de données.
L'exemple ci-dessus va afficher :
|
Exemple 3. Création d'une connexion avec autocommit désactivé par défaut Le fait de passer un tableau d'option à db2_connect() vous permet de modifier le comportement par défaut de la connexion.
L'exemple ci-dessus va afficher :
|
Précédent | Sommaire | Suivant |
db2_conn_errormsg | Niveau supérieur | db2_cursor_type |