9.19. Fonctions d'informations système

Le Tableau 9.40, « Fonctions d'information de session » présente diverses fonctions qui extraient des informations de session et système.

session_user est habituellement l'utilisateur qui a initié la connexion à la base de données ; mais les superutilisateurs peuvent modifier ce paramétrage avec SET SESSION AUTHORIZATION. current_user est l'identifiant de l'utilisateur, utilisable pour les vérifications de permissions. Il est habituellement identique à l'utilisateur de la session, mais il peut être modifié avec SET ROLE. Il change aussi pendant l'exécution des fonctions comprenant l'attribut SECURITY DEFINER. En langage Unix, l'utilisateur de la session est le « real user » (NdT : l'utilisateur réel) et l'utilisateur courant est l'« effective user » (NdT : l'utilisateur effectif) .

Note

current_user, session_user et user ont un statut syntaxique spécial en SQL : ils doivent être appelés sans parenthèses à droite.

current_schema renvoie le nom du premier schéma dans le chemin de recherche (ou une valeur NULL si ce dernier est vide). C'est le schéma utilisé pour toute création de table ou autre objet nommé sans précision d'un schéma cible. current_schemas(boolean) renvoie un tableau qui contient les noms de tous les schémas du chemin de recherche. L'option booléenne indique si les schémas système implicitement inclus, comme pg_catalog, doivent être inclus dans le chemin de recherche retourné.

Note

Le chemin de recherche est modifiable à l'exécution. La commande est :

SET search_path TO schema [, schema, ...]

inet_client_addr renvoie l'adresse IP du client courant et inet_client_port le numéro du port. inet_server_addr renvoie l'adresse IP sur laquelle le serveur a accepté la connexion courante et inet_server_port le numéro du port. Toutes ces fonctions renvoient NULL si la connexion courante est établie via une socket de domaine Unix.

pg_my_temp_schema renvoie l'OID du schéma temporaire de la session courante, ou 0 s'il n'existe pas (parce qu'il n'y a pas eu de création de tables temporaires). pg_is_other_temp_schema renvoie true si l'OID donné est l'OID d'un schéma temporaire d'une autre session. (Ceci peut être utile pour exclure les tables temporaires d'autres sessions lors de l'affichage d'un catalogue, par exemple.)

pg_postmaster_start_time renvoie la date et l'heure (type timestamp with time zone) de démarrage du serveur.

version renvoie une chaîne qui décrit la version du serveur PostgreSQL™.

Le Tableau 9.41, « Fonctions de consultation des privilèges d'accès » liste les fonctions qui permettent aux utilisateurs de consulter les privilèges d'accès. Voir la Section 5.6, « Droits » pour plus d'informations sur les privilèges.

has_function_privilege vérifie si un utilisateur peut accéder à une fonction d'une façon particulière. Les possibilités pour ses arguments sont analogues à has_table_privilege. En spécifiant une fonction par une chaîne texte plutôt que par son OID, l'entrée autorisée est identique au type de données regprocedure (voir la Section 8.12, « Types identifiant d'objet »). Le type de droit d'accès désiré doit s'évaluer à EXECUTE. Voici un exemple :

SELECT has_function_privilege('joeuser', 'myfunc(int, text)', 'execute');

has_language_privilege vérifie si un utilisateur peut accéder à un langage de procédures d'une façon particulière. Les possibilités pour ses arguments sont analogues à has_table_privilege. Le type de droit d'accès désiré doit s'évaluer à USAGE.

has_schema_privilege vérifie si un utilisateur peut accéder à un schéma d'une façon particulière. Les possibilités pour ses arguments sont analogues à has_table_privilege. Le type de droit d'accès désiré doit s'évaluer à CREATE ou USAGE.

has_table_privilege vérifie si un utilisateur peut accéder à une table d'une façon particulière. L'utilisateur peut être indiqué par son nom ou son OID (pg_authid.oid), ou si l'argument est omis, current_user est utilisé. La table peut être indiquée par son nom ou par son OID. (Du coup, il existe six versions de has_table_privilege qui sont distinguées par le nombre et le types de leurs arguments.) En spécifiant par nom, ce dernier peut avoir le nom du schéma si nécessaire. Le type du droit d'accès désiré est indiqué par une chaîne qui doit être parmi ces dernières : SELECT, INSERT, UPDATE, DELETE, REFERENCES ou TRIGGER. (la casse n'est pas importante.) An example is:

SELECT has_table_privilege('monschema.matable', 'select');

has_tablespace_privilege vérifie si un utilisateur peut accéder à un tablespace d'une façon particulière. Les possibilités pour ses arguments sont analogues à has_table_privilege. Le type de droit d'accès désiré doit s'évaluer à CREATE.

pg_has_role vérifie si un utilisateur peut accéder à un rôle d'une façon particulière. Les possibilités pour ses arguments sont analogues à has_table_privilege. Le type du droit d'accès désiré doit s'évaluer à MEMBER ou USAGE. MEMBER dénote une appartenance directe ou indirecte dans le rôle (c'est-à-dire le droit de faire SET ROLE) alors que USAGE dénote le fait que les droits du rôle sont immédiatement disponibles sans exécuter SET ROLE.

Pour tester si un utilisateur détient une option grant sur le droit, ajoutez WITH GRANT OPTION au mot clé du droit ; par exemple 'UPDATE WITH GRANT OPTION'.

Le Tableau 9.42, « Fonctions de requêtes sur la visibilité dans les schémas » affiche les fonctions qui déterminent si un certain objet est visible dans le chemin de recherche en cours. Une table est dite visible si son schéma contenant est dans le chemin de recherche et qu'aucune table du même nom apparaît avant dans le chemin de recherche. Ceci est équivalent à au fait que la table peut être référencée par nom sans qualification explicite de schéma. Par exemple, pour lister les noms de toutes les tables visibles :

SELECT relname FROM pg_class WHERE pg_table_is_visible(oid);

SELECT pg_type_is_visible('mon_schema.widget'::regtype);

Le Tableau 9.43, « Fonctions d'information sur le catalogue système » liste les fonctions qui extraient des informations à partir des catalogues système.

pg_get_serial_sequence renvoie le nom de la séquence associée avec une colonne ou NULL s'il n'existe aucune séquence associée à la colonne. Le premier argument en entrée est un nom de table avec le nom du schéma en option. Le second paramètre est un nom de colonne. Comme le premier paramètre peut potentiellement contenir le nom du schéma et de la table, il n'est pas traité comme un identifiant entre guillemets doubles, signifiant qu'il est en minuscule par défaut alors que le second paramètre, étant un simple nom de colonne, est présenté avec des guillemets doubles et a sa casse préservé. La fonction renvoie une valeur formatée convenablement pour qu'elle soit fournie aux fonctions sur les séquences (voir Section 9.12, « Fonctions de manipulation de séquence »). Cette association peut être modifiée ou supprimée avec ALTER SEQUENCE OWNED BY . (La fonction devrait probablement avoir été appelée pg_get_owned_sequence ; son nom reflète le fait qu'il est typiquement utilisé avec les colonnes serial et bigserial.)

pg_get_userbyid extrait un nom de rôle d'après son OID.

pg_tablespace_databases autorise l'examen d'un espace logique. Il renvoie l'ensemble des OID des bases qui ont des objets stockés dans le tablespace. Si la fonction renvoie une ligne, le tablespace n'est pas vide et ne peut pas être supprimée. Pour afficher les objets spécifiques peuplant le tablespace, vous aurez besoin de connecter les bases identifiées par pg_tablespace_databases et d'exécuter des requêtes sur le catalogue pg_class.

les fonctions affichées dans Tableau 9.44, « Fonctions d'informations sur les commentaires » extraient les commentaires stockées précédemment avec la commande COMMENT. Une valeur NULL est renvoyée si aucun commentaire ne se trouve correspondre aux paramètres donnés.