createlang
createlang — Définir 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
nouveau langage de programmation à une base de données PostgreSQL™. createlang n'est qu'un enrobage de la commande
CREATE LANGUAGE.
Options
createlang accepte les arguments
suivants en ligne de commande :
-
nom_langage
-
Le nom du langage de programmation procédurale à définir.
-
[-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.
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,
--password
-
Le mot de passe est obligatoirement demandé.
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 29.12,
« 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.
createdb
