createlang

Name

createlang -- définit un nouveau langage procédural PostgreSQL

Synopsis

createlang [connection-options...] langname [dbname]
createlang [connection-options...] --list | -l dbname

Entrées

createlang accepte les arguments en ligne de commande suivants :

langname

Spécifie le nom du langage procédural de programmation à définir.

-d, --dbname dbname

Spécifie à quelle base le langage sera ajouté. Par défaut c'est la base avec le même nom que l'utilisateur système courant.

-e, --echo

Affiche les commandes SQL exécutées.

-l, --list

Montre une liste des langages déja installés dans la base cible (laquelle doit être spécifiée).

--L directory

Spécifie le répertoire dans lequel l'interpréteur de langage se trouve. Le répertoire est normalement trouvé automatiquement; cette option est d'abord utilisée pour le débugage.

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

-h, --host host

Spécifie le nom d'hôte de la machine sur laquelle le serveur tourne. Si l'hôte débute avec un slash, il est utilisé comme répertoire d'un socket de domaine Unix.

-p, --port port

Spécifie le port Internet TCP/IP ou une extension de socket de domaine Unix local sur lequel le serveur est en attente de connections.

-U, --username username

Nom de connexion de l'utilisateur.

-W, --password

Force le mot de passe au prompt.

Sorties

La plupart des messages d'erreur parlent d'eux-mêmes. Si non, lancez createlang avec l'option --echo et voyez la commande SQL respective pour les détails. Vérifiez aussi avec psql(1) pour plus de possibilités.

Description

createlang est un utilitaire pour ajouter un nouveau langage de programmation à une base PostgreSQL. createlang peut décrire tous les langages contenus dans la distribution PostgreSQL, mais pas les langages fournis par d'autres applications.

Bien que les langages puissent être ajoutés directement en utilisant plusieurs commandes SQL, il est recommandé d'utiliser createlang car il exécute nombre de vérifications et est plus facile d'usage. Voir CREATE LANGUAGE pour plus d'information.

Notes

Utilisez droplang(1) pour supprimer un langage.

createlang est un script shell qui invoque psql plusieurs fois. Si vous avez fait en sorte qu'un mot-de-passe au prompt est nécessaire pour se connecter, vous aurez ce prompt qui s'affichera plusieurs fois.

Utilisation

Pour installer pltcl dans une base template1 :

$ createlang pltcl template1