createlang

Nom

createlang -- définit un langage de procédure pour PostgreSQL

Synopsis

createlang [options_connexion...] nom_langage [nom_db]
createlang [options_connexion...] --list | -l nom_db

Description

createlang est un outil pour ajouter un nouveau langage de programmation à une nouvelle base de données PostgreSQL. createlang peut gérer tous les langages fournis dans la distribution PostgreSQL par défaut, mais aucun langage fournis pas d'autres parties.

Bien que les langages de programmation du moteur peuvent être ajoutés directement en utilisant différentes commandes SQL, il est recommandé d'utiliser createlang parce qu'il réalise un certain nombre de vérification et qu'il est plus facile à utiliser. Voir CREATE LANGUAGE pour des informations supplémentaires.

Options

createlang accepte les arguments suivants en ligne de commande :

nom_langage

Spécifie le nom du langage de programmation de procédures à être défini.

[-d] nom_db
[--dbname] nom_db

Spécifie pour quelle base de données a été ajouté le langage. La valeur par défaut est d'utiliser la base de données avec le même nom que l'utilisateur système.

-e
--echo

Affiche les commandes SQL exécutées.

-l
--list

Affiche une liste de langages déjà installés dans la base de données cible.

-L repertoire

Spécifie le répertoire dans lequel l'interpréteur du langage est trouvé. Le répertoire est trouvé normalement automatiquement ; cette option est principalement pour des buts de débogage.

createlang accepte aussi les arguments suivants en ligne de commande pour les paramètres de connexion :

-h hôte
--host hôte

Spécifie le nom de l'hôte de la machine sur lequel le serveur fonctionne. Si la valeur commence avec un slash, elle est utilisée comme répertoire du socket de domaine Unix.

-p port
--port port

Spécifie 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

Nom de l'utilisateur qui se connecte

-W
--password

Force la demande du mot de passe.

Environnement

PGDATABASE
PGHOST
PGPORT
PGUSER

Paramètres de connexion par défaut

Diagnostiques

La plupart des messages d'erreur s'expliquent d'eux-mêmes. Dans le cas contraire, lancez createlang avec l'option --echo et jetez un œil à la commande SQL respective pour les détails.

Notes

Utilisez droplang pour supprimer un langage.

Exemples

Pour installer le langage pltcl dans la base de données template1 :

$ createlang pltcl template1

Voir aussi

droplang, CREATE LANGUAGE