Documentation PostgreSQL 8.1.23 > Langage SQL > Types de données | |
LIMIT et OFFSET | Types monétaires |
PostgreSQL™ a un large choix de types de données disponibles nativement. Les utilisateurs peuvent ajouter de nouveaux types à PostgreSQL™ en utilisant la commande CREATE TYPE.
Le Tableau 8.1, « Types de données » montre tous les types de données généraux disponibles nativement. La plupart des types de données alternatifs listés dans la colonne « Alias » sont les noms utilisés en interne par PostgreSQL™ pour des raisons historiques. De plus, certains types de données internes ou obsolètes sont disponibles, mais ils ne sont pas listés ici.
Tableau 8.1. Types de données
Nom | Alias | Description |
---|---|---|
bigint | int8 | Entier signé sur 8 octets |
bigserial | serial8 | Entier sur 8 octets à incrémentation automatique |
bit [ (n) ] | Suite de bits de longueur fixe | |
bit varying [ (n) ] | varbit | Suite de bits de longueur variable |
boolean | bool | Booléen (Vrai/Faux) |
box | Boîte rectangulaire dans le plan | |
bytea | Donnée binaire (« tableau d'octets ») | |
character varying [ (n) ] | varchar [ (n) ] | Suite de caractères de longueur variable |
character [ (n) ] | char [ (n) ] | Suite de caractères de longueur fixe |
cidr | Adresse réseau IPv4 ou IPv6 | |
circle | Cercle dans le plan | |
date | Date du calendrier (année, mois, jour) | |
double precision | float8 | Nombre à virgule flottante de double précision |
inet | Adresse d'ordinateur IPv4 ou IPv6 | |
integer | int, int4 | Entier signé sur 4 octets |
interval [ (p) ] | Intervalle de temps | |
line | Ligne infinie dans le plan | |
lseg | Segment de droite dans le plan | |
macaddr | adresse MAC | |
money | montant d'une devise | |
numeric [ (p, s) ] | decimal [ (p, s) ] | Nombre exact de la précision indiquée |
path | Chemin géométrique dans le plan | |
point | Point géométrique dans le plan | |
polygon | Chemin géométrique fermé dans le plan | |
real | float4 | Nombre à virgule flottante de simple précision |
smallint | int2 | Entier signé sur 2 octets |
serial | serial4 | Entier sur 4 octets à incrémentation automatique |
text | Chaîne de caractères de longueur variable | |
time [ (p) ] [ without time zone ] | Heure du jour | |
time [ (p) ] with time zone | timetz | Heure du jour, avec fuseau horaire |
timestamp [ (p) ] [ without time zone ] | Date et heure | |
timestamp [ (p) with time zone | timestamptz | Date et heure, avec fuseau horaire |
Les types suivants sont conformes à la norme SQL: bit, bit varying, boolean, char, character varying, character, varchar, date, double precision, integer, interval, numeric, decimal, real, smallint, time (avec et sans fuseau horaire), timestamp (avec et sans fuseau horaire).
Chaque type de données a une représentation externe déterminée par ses fonctions d'entrée et de sortie. De nombreux types de données internes ont un format externe évident. Cependant, certains types soit sont spécifiques à PostgreSQL™, comme les chemins géométriques, soit ont différents formats possibles, comme les types de données de date et d'heure. Certaines fonctions d'entrée et de sortie ne sont pas inversables: Le résultat de la fonction de sortie peut manquer de précision comparé à l'entrée initiale.
Les types numériques sont constitués d'entiers de 2, 4 ou 8 octets, de nombres à virgule flottante de 4 ou 8 octets, et de décimaux à précision sélectionnable. Le Tableau 8.2, « Types numériques » précise les types disponibles.
Tableau 8.2. Types numériques
Nom | Taille de stockage | Description | Étendue |
---|---|---|---|
smallint | 2 octets | entier de faible étendue | de -32768 à +32767 |
integer | 4 octets | entiers les plus courants | de -2147483648 à +2147483647 |
bigint | 8 octets | grands entiers | de -9223372036854775808 à 9223372036854775807 |
decimal | variable | précision indiquée par l'utilisateur, valeurs exactes | pas de limite |
numeric | variable | précision indiquée par l'utilisateur, valeurs exactes | pas de limite |
real | 4 octets | précision variable, valeurs inexactes | précision de 6 décimales |
double precision | 8 octets | précision variable, valeurs inexactes | précision de 15 décimales |
serial | 4 octets | entier à incrémentation automatique | de 1 à 2147483647 |
bigserial | 8 octets | entier de grande taille à incrémentation automatique | de 1 à 9223372036854775807 |
La syntaxe des constantes pour les types numériques est décrite dans la Section 4.1.2, « Constantes ». Les types numériques ont un ensemble complet d'opérateurs arithmétiques et de fonctions. Référez-vous au Chapitre 9, Fonctions et opérateurs pour plus d'informations. Les sections suivantes décrivent ces types en détail.
Les types smallint, integer et bigint stockent des nombres entiers, c'est-à-dire sans décimale, de différentes étendues. Toute tentative d'y stocker une valeur en dehors de l'échelle produit une erreur.
Le type integer est le plus courant. Il offre un bon compromis entre capacité, espace utilisé et performance. Le type smallint n'est utilisé que si l'économie d'espace disque est le premier critère de choix. Le type bigint ne doit être utilisé que si le type integer n'offre pas une étendue suffisante car le type integer est nettement plus rapide.
Le type bigint peut ne pas fonctionner correctement sur toutes les plates-formes, car il repose sur la capacité du compilateur à supporter les entiers de 8 octets. Sur une machine qui ne les supporte pas, bigint se comporte comme integer (mais prend bien huit octets d'espace de stockage). Ceci dit, nous ne connaissons pas de plate-forme raisonnable sur laquelle il en va ainsi.
SQL ne spécifie que les types de données integer (ou int) et smallint. Le type bigint et les noms de types int2, int4, et int8 sont des extensions, qui sont partagées avec d'autres systèmes de bases de données SQL.
Le type numeric peut stocker des nombres avec jusqu'à 1000 chiffres significatifs et effectuer des calculs exacts. Il est spécialement recommandé pour stocker les montants financiers et autres quantités pour lesquelles l'exactitude est indispensable. Néanmoins, l'arithmétique sur les valeurs numeric est très lent comparé aux types entiers ou aux types à virgule flottante décrits dans la section suivante.
Dans ce qui suit, on utilise les termes suivants : l'échelle d'un numeric est le nombre de chiffres décimaux de la partie fractionnaire. La précision d'un numeric est le nombre total de chiffres significatifs dans le nombre entier, c'est-à-dire avant et après la virgule. Donc, le nombre 23,5141 a une précision de 6 et une échelle de 4. On peut considérer que les entiers ont une échelle de 0.
La précision maximum et l'échelle maximum d'une colonne numeric peuvent être réglés. Pour déclarer une colonne de type numérique, il faut utiliser la syntaxe :
NUMERIC(précision, échelle)
La précision pour être strictement positive, l'échelle positive ou NULL. Alternativement,
NUMERIC(précision)
indique une échelle de 0. Préciser
NUMERIC
sans précision ni échelle crée une colonne dans laquelle on peut stocker des valeurs de n'importe quelle précision ou échelle, jusqu'à la limite de précision. Une colonne de ce type ne forcera aucune valeur entrée à une précision particulière, alors que les colonnes numeric avec une échelle forcent les valeurs entrées à cette échelle. (Le standard SQL demande une précision par défaut de 0, c'est-à-dire de forcer la transformation en entiers. Nous trouvons ça inutile. Si vous êtes soucieux de portabilité, précisez toujours la précision et l'échelle explicitement.)
Si l'échelle d'une valeur est supérieure à l'échelle d'une colonne, le système tentera d'arrondir la valeur au nombre de chiffres après la virgule spécifiée. Ensuite, si le nombre de chiffres à gauche du point décimal dépasse la précision déclarée moins l'échelle déclarée, une erreur est levée.
Les valeurs numériques sont stockées physiquement sans zéro avant ou après. Du coup, la précision déclarée et l'échelle de la colonne sont des valeurs maximums, pas des allocations fixes (en ce sens, le type numérique est plus proche de varchar(n) que de char(n)). Le besoin pour le stockage actuel est de deux octets pour chaque groupe de quatre chiffres décimaux, plus huit octets d'en-tête.
En plus des valeurs numériques ordinaires, le type numeric autorise la valeur spéciale NaN, signifiant « not-a-number » (NdT : pas un nombre). Toute opération sur NaN renvoie un autre NaN. En écrivant cette valeur comme une constante dans une requête SQL, vous devez placer des guillemets autour. Par exemple, UPDATE table SET x = 'NaN'. En saisie, la chaîne NaN est reconnue quelque soit la casse utilisée.
Les types decimal et numeric sont équivalents. Les deux types sont dans le standard SQL.
Les types de données real et double precision sont des types numériques à précision variable inexacts. En pratique, ils sont généralement conformes à la norme IEEE 754 pour l'arithmétique binaire à virgule flottante (respectivement simple et double précision), dans la mesure où les processeurs, le système d'exploitation et le compilateur les supportent.
Inexact signifie que certaines valeurs ne peuvent être converties exactement dans le format interne, et sont stockées sous forme d'approximations, si bien que stocker puis réafficher ces valeurs peut faire apparaître de légers écarts. Prendre en compte ces erreurs et la façon dont elles se propagent au cours des calculs est le sujet d'une branche entière des mathématiques et de l'informatique. Nous n'en dirons pas plus que ce qui suit:
Si vous avez besoin d'un stockage et de calculs exacts, comme pour les valeurs monétaires, utilisez plutôt le type numeric.
Si vous voulez faire des calculs compliqués avec ces types pour quoi que ce soit d'important, et particulièrement si vous comptez sur certains comportements aux limites (infinis, zéro), alors vous devriez étudier le comportement de votre plate-forme avec soin.
Tester l'égalité de deux valeurs à virgule flottante peux ne pas donner le résultat attendu.
Sur la plupart des plates-formes, le type real a une étendue d'au moins 1E-37 à 1E37 avec une précision d'au moins 6 chiffres décimaux. Le type double precision a généralement une étendue de 1E-307 à 1E+308 avec une précision d'au moins 15 chiffres. Les valeurs trop grandes ou trop petites produisent une erreur. Un arrondi peut avoir lieu si la précision d'un nombre en entrée est trop grande. Les nombres trop proches de zéro qui ne peuvent être représentés autrement que par zéro produisent une erreur (underflow).
En plus des valeurs numériques ordinaires, les types à virgule flottante ont plusieurs valeurs spéciales :
Infinity
-Infinity
NaN
Elles représentent les valeurs spéciales de l'IEEE 754, respectivement « infinity » (NdT : infini), « negative infinity » (NdT : infini négatif) et « not-a-number » (NdT : pas un nombre) (sur une machine dont l'arithmétique à virgule flottante ne suit pas l'IEEE 754, ces valeurs ne fonctionneront probablement pas comme c'est attendu). Lors de la saisie de ces valeurs en tant que constantes dans une commande SQL, vous devez placer des guillemets autour. Par exemple, UPDATE table SET x = 'Infinity'. En entrée, ces valeurs sont reconnues quelque soit la casse utilisée.
PostgreSQL™ autorise aussi la notation float du standard SQL, ainsi que float(p) pour indiquer des types numériques inexacts. Ici, p indique la précision minimale acceptable en chiffres binaires. PostgreSQL™ accepte float(1) à float(24), transformés en type real, et float(25) à float(53), transformés en type double precision. Toute valeur de p hors de la zone des valeurs possibles produit une erreur. float sans précision est compris comme double precision.
Avant PostgreSQL™ 7.4, la précision d'un float(p) était supposée indiquer une précision en chiffres décimaux. Nous l'avons corrigée pour respecter le standard SQL, qui indique que la précision est indiquée en chiffres binaires. L'affirmation que les real et les double precision ont exactement 24 et 53 bits dans la mantisse est correcte pour les implémentations des nombres à virgule flottante respectant le standard IEEE. Sur les plates-formes non-IEEE, c'est peut-être un peu sous-estimé mais, pour plus de simplicité, la gamme de valeurs pour p est utilisée sur toutes les plates-formes.
Les types de données serial et bigserial ne sont pas de vrais types, mais plutôt un raccourci de notation pour décrire des colonnes d'identifiants uniques (similaires à la propriété AUTO_INCREMENT utilisée par d'autres SGBD). Dans la version actuelle, indiquer
CREATE TABLE nom_de_table ( nom_de_colonne SERIAL );
est équivalent à écrire :
CREATE SEQUENCE nom_de_table_nom_de_colonne_seq; CREATE TABLE nom_de_table ( nom_de_colonne integer DEFAULT nextval('nom_de_table_nom_de_colonne_seq') NOT NULL );
Ainsi, nous avons créé une colonne d'entiers et fait en sorte que ses valeurs par défaut soient affectées par un générateur de séquence. Une contrainte NOT NULL est ajoutée pour s'assurer qu'une valeur NULL ne puisse pas être explicitement insérée. Dans la plupart des cas, vous voudrez aussi ajouter une contrainte UNIQUE ou PRIMARY KEY pour interdire que des doublons soient créés par accident, mais ce n'est pas automatique.
Avant PostgreSQL™ 7.3, serial sous-entendait UNIQUE. Ce n'est plus automatique. Si vous souhaitez qu'une colonne serial soit unique ou soit une clé primaire, il faut le préciser, comme pour les autres types.
Pour insérer la valeur suivante de la séquence dans la colonne serial, il faut faire en sorte d'utiliser la valeur par défaut de la colonne. Cela peut se faire de deux façons : soit en excluant cette colonne de la liste des colonnes de la commande INSERT soit en utilisant le mot clé DEFAULT.
Les types serial et serial4 sont identiques : ils créent tous les deux des colonnes integer. Les types bigserial et serial8 fonctionnent de la même façon et créent des colonnes bigint. bigserial doit être utilisé si vous pensez utiliser plus de 231 identifiants dans toute la vie de la table.
La séquence créée pour une colonne serial est automatiquement supprimée quand la colonne correspondante est supprimée, et ne peut l'être autrement (ce n'était pas le cas avant la version 7.3 de PostgreSQL™. Notez que ce lien de suppression automatique de séquence ne fonctionnera pas pour une base restaurée d'une sauvegarde SQL (dump) antérieure à la version 7.3. La sauvegarde ne contient en effet pas l'information nécessaire à l'établissement du lien de dépendance). De plus, ce lien de dépendance n'est mis que pour la colonne de type serial elle-même. Si d'autres colonnes référencent la séquence (par exemple en appelant la fonction nextval), elles ne peuvent plus fonctionner si la séquence est supprimée. Utiliser le type serial de cette façon n'est pas recommandé. Si vous souhaitez remplir plusieurs colonnes avec le même générateur de séquence, créez la séquence indépendamment.