38.1. Fonctions PL/Python

Les fonctions PL/Python sont déclarées de la façon habituelle, par exemple

CREATE FUNCTION ma_fonction(text) RETURNS text
    AS 'return args[0]'
    LANGUAGE plpythonu;

Le code Python donné comme corps de la définition de fonction est transformé en fonction Python. Par exemple, le code ci-dessus devient

def __plpython_procedure_ma_fonction_23456():
        return args[0]

en supposant que 23456 est l'OID affecté à la fonction par PostgreSQL.

Si vous ne fournissez pas de valeur de retour, PL/Python renvoie par défaut None. Le module du langage traduit le None de Python en la valeur NULL en SQL.

Les paramètres de fonctions avec PostgreSQL sont disponibles dans la liste globale args. Dans l'exemple ma_fonction, args[0] contient ce qui a été passé dans l'argument texte. Pour ma_fonction2(text, integer), args[0] contiendrait l'argument de type text et args[1] l'argument de type integer.

Le dictionnaire global SD est disponible pour stocker des données entres les appels de fonctions. Cette variable est une donnée statique privée. Le dictionnaire global GD est une donnée publique disponible pour toutes les fonctions Python à l'intérieur d'une session. À utiliser avec précaution.

Chaque fonction obtient son propre environnement d'exécution dans l'interpréteur Python, de façon à ce que les données globales et les arguments de fonction provenant de ma_fonction ne soient pas disponibles depuis ma_fonction2. L'exception concerne les données du dictionnaire GD comme indiqué ci-dessus.