pg_connect

Nom

pg_connect -- ouvre une connexion au serveur

Synopsis

pg_connect -conninfo optionsConnexion
pg_connect dbName ?-host
nomHote? ?-port
numeroPort? ?-tty
tty? ?-options
optionsServeur?

Description

pg_connect ouvre une connexion vers le serveur PostgreSQL.

Deux syntaxes sont disponibles. Dans l'ancienne forme, chaque option possible a un commutateur d'option séparé à partir de la commande pg_connect. Dans la nouvelle forme, une seule chaîne d'options est fournie, pouvant contenir plusieurs valeurs d'options. pg_conndefaults peut être utilisée pour récupérer des informations sur les options disponibles avec la nouvelle syntaxe.

Arguments

Nouveau style

optionsConnexion

Une chaîne d'options de connexion, chacune écrite de la forme motclé = valeur. Une liste des options valides est disponible dans la description de la fonction PQconnectdb de libpq.

Ancien style

nomDB

Le nom de la base de données où se connecter.

-host nomHote

Le nom de l'hôte où se trouve le serveur de bases de données.

-port numeroPort

Le numéro de port TCP pour se connecter au serveur de bases de données.

-tty tty

Un fichier ou un TTY pour une sortie de débogage optionnelle du serveur.

-options optionsServeur

Des options supplémentaires de configuration à passer au serveur.

Code de retour

En cas de succès, une poignée (handle) vers une connexion est renvoyée. Celle-ci commence avec le préfixe pgsql.