Documentation PostgreSQL 9.1.24 > Interfaces client > Schéma d'information > columns | |
column_udt_usage | constraint_column_usage |
La vue columns contient des informations sur toutes les colonnes de table (et colonnes de vue) de la base. Les colonnes système (oid, etc.) ne sont pas incluses. Seules les colonnes auxquelles l'utilisateur a accès (par propriété ou par privilèges) sont affichées.
Tableau 34.13. Colonnes de columns
Nom | Type de données | Description |
---|---|---|
table_catalog | sql_identifier | Nom de la base de données contenant la table (toujours la base de données courante) |
table_schema | sql_identifier | Nom du schéma contenant la table |
table_name | sql_identifier | Nom de la table |
column_name | sql_identifier | Nom de la colonne |
ordinal_position | cardinal_number | Position de la colonne dans la table (la numérotation commençant à 1) |
column_default | character_data | Expression par défaut de la colonne |
is_nullable | yes_or_no | YES si la colonne est NULLable (elle admet une absence de valeur), NO dans le cas contraire. La contrainte NOT NULL n'est pas la seule façon de définir qu'une colonne n'est pas NULLable. |
data_type | character_data | Le type de données de la colonne, s'il s'agit d'un type interne ou ARRAY s'il s'agit d'un tableau (dans ce cas, voir la vue element_types), USER-DEFINED dans les autres cas (le type est alors identifié dans udt_name et colonnes associées). Si la colonne est fondée sur un domaine, cette colonne est une référence au type sous-jacent du domaine (et le domaine est identifié dans domain_name et colonnes associées). |
character_maximum_length | cardinal_number | Si data_type identifie un type chaîne de caractères ou chaîne de bits, la longueur maximale déclarée ; NULL pour tous les autres types de données ou si aucune longueur maximale n'a été déclarée. |
character_octet_length | cardinal_number | Si data_type identifie un type caractère, la longueur maximale en octets (bytes) d'un datum ; NULL pour tous les autres types de données. La longueur maximale en octets dépend de la longueur maximum déclarée en caractères (voir ci-dessus) et l'encodage du serveur. |
numeric_precision | cardinal_number | Si data_type identifie un type numérique, cette colonne contient la précision (déclarée ou implicite) du type pour ce domaine. La précision indique le nombre de chiffres significatifs. Elle peut être exprimée en décimal (base 10) ou en binaire (base 2) comme indiqué dans la colonne numeric_precision_radix. Pour tous les autres types de données, la colonne est NULL. |
numeric_precision_radix | cardinal_number | Si data_type identifie un type numérique, cette colonne indique dans quelle base les valeurs des colonnes numeric_precision et numeric_scale sont exprimées. La valeur est 2 ou 10. Pour tous les autres types de données, cette colonne est NULL. |
numeric_scale | cardinal_number | Si data_type identifie un type numeric exact, cette colonne contient l'échelle (déclarée ou implicite) du type pour ce domaine. L'échelle indique le nombre de chiffres significatifs à la droite du point décimal. Elle peut être exprimée en décimal (base 10) ou en binaire (base 2), comme indiqué dans la colonne numeric_precision_radix. Pour tous les autres types de données, cette colonne est NULL. |
datetime_precision | cardinal_number | Si data_type identifie une date, une heure, un horodatage ou un interval, cette colonne contient la précision en secondes (déclarée ou implicite) pour cet attribut, c'est-à-dire le nombre de chiffres décimaux suivant le point décimal de la valeur en secondes. Pour tous les autres types de données, cette colonne est NULL. |
interval_type | character_data | Pas encore implanté |
interval_precision | character_data | Pas encore implanté |
character_set_catalog | sql_identifier | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
character_set_schema | sql_identifier | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
character_set_name | sql_identifier | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
collation_catalog | sql_identifier | Pas encore implémenté. |
collation_schema | sql_identifier | Pas encore implémenté. |
collation_name | sql_identifier | Pas encore implémenté. |
domain_catalog | sql_identifier | Si la colonne a un type domaine, le nom de la base de données où le type est défini (toujours la base de données courante), sinon NULL. |
domain_schema | sql_identifier | Si la colonne a un type domaine, le nom du schéma où le domaine est défini, sinon NULL. |
domain_name | sql_identifier | Si la colonne a un type de domaine, le nom du domaine, sinon NULL. |
udt_catalog | sql_identifier | Nom de la base de données où le type de données de la colonne (le type sous-jacent du domaine, si applicable) est défini (toujours la base de données courante). |
udt_schema | sql_identifier | Nom du schéma où le type de données de la colonne (le type sous-jacent du domaine, si applicable) est défini. |
udt_name | sql_identifier | Nom du type de données de la colonne (le type sous-jacent du domaine, si applicable). |
scope_catalog | sql_identifier | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
scope_schema | sql_identifier | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
scope_name | sql_identifier | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
maximum_cardinality | cardinal_number | Toujours NULL car les tableaux ont toujours une cardinalité maximale illimitée avec PostgreSQL™. |
dtd_identifier | sql_identifier | Un identifiant du descripteur du type de données de la colonne, unique parmi les descripteurs de type de données contenus dans la table. Ceci est principalement utile pour joindre d'autres instances de ces identifiants. (Le format spécifique de l'identifiant n'est pas défini et rien ne permet d'assurer qu'il restera inchangé dans les versions futures.) |
is_self_referencing | yes_or_no | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
is_identity | yes_or_no | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
identity_generation | character_data | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
identity_start | character_data | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
identity_increment | character_data | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
identity_maximum | character_data | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
identity_minimum | character_data | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
identity_cycle | yes_or_no | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
is_generated | character_data | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
generation_expression | character_data | S'applique à une fonctionnalité non disponible dans PostgreSQL™. |
is_updatable | yes_or_no | YES si la colonne est actualisable, NO dans le cas contraire (les colonnes des tables sont toujours modifiables, les colonnes des vues ne le sont pas nécessairement). |
Puisqu'en SQL les possibilités de définir les types de données sont nombreuses, et que PostgreSQL™ offre des possibilités supplémentaires, leur représentation dans le schéma d'information peut s'avérer complexe.
La colonne data_type est supposée identifier le type de données interne sous-jacent de la colonne. Avec PostgreSQL™, cela signifie que le type est défini dans le schéma du catalogue système pg_catalog. Cette colonne est utile si l'application sait gérer les types internes (par exemple, formater les types numériques différemment ou utiliser les données dans les colonnes de précision). Les colonnes udt_name, udt_schema et udt_catalog identifient toujours le type de données sous-jacent de la colonne même si la colonne est basée sur un domaine.
Puisque PostgreSQL™ traite les types internes comme des types utilisateur, les types internes apparaissent aussi ici. Il s'agit d'une extension du standard SQL.
Toute application conçue pour traiter les données en fonction du type peut utiliser ces colonnes, car, dans ce cas, il importe peu de savoir si la colonne est effectivement fondée sur un domaine. Si la colonne est fondée sur un domaine, l'identité du domaine est stockée dans les colonnes domain_name, domain_schema et domain_catalog. Pour assembler les colonnes avec leurs types de données associés et traiter les domaines comme des types séparés, on peut écrire coalesce(domain_name, udt_name), etc.