Documentation PostgreSQL 9.0.23 > Référence > Applications client de PostgreSQL > createlang | |
createdb | createuser |
createlang — Définir un langage procédural sous PostgreSQL™
createlang [options_connexion...]
nom_langage
[nom_bd]
createlang [options_connexion...] [--list]
| [-l] nom_bd
createlang permet d'ajouter un nouveau langage de programmation à une base de données PostgreSQL™. createlang n'est qu'un enrobage de la commande CREATE LANGUAGE(7).
createlang accepte les arguments suivants en ligne de commande :
Le nom du langage de programmation procédurale à définir.
La base de données à laquelle ajouter le langage. Par défaut, celle de même nom que l'utilisateur système.
Les commandes SQL exécutées sont affichées.
La liste de langages installés sur la base de données cible est affichée.
Affiche la version de createlang puis quitte.
Affiche l'aide sur les arguments en ligne de commande de createlang, puis quitte
createlang accepte aussi les arguments suivants en ligne de commande pour les paramètres de connexion :
Le nom de l'hôte de la machine sur laquelle le serveur fonctionne. Si la valeur commence par un slash (/), elle est utilisée comme répertoire du socket de domaine Unix.
Le port TCP ou l'extension du fichier du socket local de domaine Unix sur lequel le serveur attend les connexions.
Le nom de l'utilisateur utilisé pour la connexion.
Ne demande jamais un mot de passe. Si le serveur en réclame un pour l'authentification et qu'un mot de passe n'est pas disponible d'une autre façon (par exemple avec le fichier .pgpass), la tentative de connexion échouera. Cette option peut être utile pour les scripts où aucun utilisateur n'est présent pour saisir un mot de passe.
Force createlang à demander un mot de passe avant la connexion à une base de données.
Cette option n'est jamais obligatoire car createlang demandera automatiquement un mot de passe si le serveur exige une authentification par mot de passe. Néanmoins, createlang perdra une tentative de connexion pour trouver que le serveur veut un mot de passe. Dans certains cas, il est préférable d'ajouter l'option -W pour éviter la tentative de connexion.
Paramètres de connexion par défaut
Cet outil, comme la plupart des autres outils PostgreSQL™, utilise aussi les variables d'environnement supportées par la bibliothèque libpq (voir Section 31.13, « Variables d'environnement »).
La plupart des messages d'erreur s'expliquent d'eux-mêmes. Dans le cas contraire, createlang peut être lancée avec l'option --echo afin d'obtenir les commandes SQL à examiner. De plus, tout paramètre de connexion par défaut et toute variable d'environnement utilisé par la bibliothèque libpq s'appliqueront.
Installer le langage pltcl dans la base de données template1 :
$ createlang pltcl template1
Installer un langage dans template1 l'installe automatiquement dans les bases de données créées ultérieurement.