PostgreSQLLa base de données la plus sophistiquée au monde.

Version anglaise

createlang

createlang — Installer un langage procédural sous PostgreSQL

Synopsis

createlang [options_connexion...] nom_langage [nom_bd]

createlang [options_connexion...] --list | -l [nom_bd]

Description

createlang permet d'ajouter un langage de programmation à une base de données PostgreSQL™.

createlang n'est qu'un enrobage de la commande SQL CREATE EXTENSION(7).

[Attention]

Attention

createlang est obsolète et pourrait être supprimé dans une version future de PostgreSQL™. L'utilisation directe de la commande CREATE EXTENSION est recommandée à la place.

Options

createlang accepte les arguments suivants en ligne de commande :

nom_langage

Le nom du langage de programmation procédurale à installer. (Ce nom est en minuscule.)

[-d] nom_nd, [--dbname=]nom_bd

La base de données à laquelle ajouter le langage. Par défaut, celle de même nom que l'utilisateur système.

-e, --echo

Les commandes SQL exécutées sont affichées.

-l, --list

La liste de langages installés sur la base de données cible est affichée.

-V, --version

Affiche la version de createlang puis quitte.

-?, --help

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 :

-h hôte, --host=hôte

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.

-p port, --port=port

Le port TCP ou l'extension du fichier du socket local de domaine Unix sur lequel le serveur attend les connexions.

-U nomutilisateur, --username=nomutilisateur

Le nom de l'utilisateur utilisé pour la connexion.

-w, --no-password

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.

-W, --password

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.

Environnement

PGDATABASE, PGHOST, PGPORT, PGUSER

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.14, « Variables d'environnement »).

Diagnostiques

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.

Notes

droplang(1) est utilisé pour supprimer un langage.

Exemples

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.