Types de données PostgreSQLExplained

46 of 46 rows

Type↕	Ce qu'il stocke↕	À utiliser pour↕
Nombres entiers
⤢smallint	Un entier sur 2 octets, de -32768 à 32767.	Rare ; uniquement pour économiser de l'espace.
⤢integer	Un entier sur 4 octets, environ plus ou moins 2 milliards.	La colonne d'entiers par défaut.
⤢bigint	Un entier sur 8 octets, environ plus ou moins 9 quintillions.	Très grands compteurs ou identifiants externes.
⤢serial	Un entier sur 4 octets à incrémentation automatique.	Clés auto-numérotées historiques ; depuis PG 10, GENERATED AS IDENTITY est le remplacement recommandé.
⤢smallserial, bigserial	Les variantes sur 2 et 8 octets de serial.	Numérotation automatique alignée sur une colonne smallint ou bigint.
⤢identity	Un entier que la table génère pour vous (GENERATED ALWAYS AS IDENTITY).	Le serial moderne ; standard SQL et plus sûr contre les insertions manuelles.
Décimaux et flottants
⤢numeric, decimal	Décimaux exacts à précision arbitraire.	L'argent et tout contexte où les erreurs d'arrondi sont inacceptables.
⤢real	Un flottant simple précision sur 4 octets.	Valeurs scientifiques approximatives où la précision n'est pas critique.
⤢double precision	Un flottant double précision sur 8 octets.	Géospatial, statistiques et valeurs de features ML.
⤢money	Un montant monétaire avec des paramètres régionaux fixes.	Rarement ; numeric avec un code devise côté application est plus portable.
Texte
⤢char(n)	Texte à longueur fixe, complété par des espaces.	Codes de largeur connue ; rarement nécessaire.
⤢varchar(n)	Texte à longueur variable avec une limite facultative.	Chaînes bornées comme les noms d'utilisateur ou les e-mails.
⤢text	Texte à longueur variable sans limite de taille.	La colonne de chaîne passe-partout ; aucune pénalité de performance face à varchar.
Temps
⤢date	Une date de calendrier sans heure.	Anniversaires et échéances.
⤢time, timetz	Une heure du jour, avec ou sans fuseau horaire.	Alarmes quotidiennes ou horaires d'ouverture.
⤢timestamp	Date et heure sans fuseau horaire.	Schémas historiques ; à éviter pour du travail neuf.
⤢timestamptz	Date et heure stockées en UTC, affichées dans le fuseau du client.	La valeur par défaut pour tout instant du monde réel ; à préférer à timestamp.
⤢interval	Une durée, par exemple 2 jours ou 3 heures.	Durées et arithmétique de dates.
Booléens, UUID et octets
⤢boolean	Vrai ou faux.	Indicateurs et interrupteurs.
⤢uuid	Un identifiant universel unique sur 128 bits.	Identifiants non séquentiels sûrs à exposer (générés dans l'application ou avec gen_random_uuid).
⤢bytea	Octets binaires bruts.	Blobs, images et charges opaques ; préférez le stockage objet pour les gros fichiers.
⤢bit(n), bit varying	Chaînes de bits à longueur fixe ou variable.	Indicateurs compactés et champs de protocole ; une simple valeur activé/désactivé reste boolean.
JSON et semi-structuré
⤢jsonb	JSON analysé dans une forme binaire indexable.	Données flexibles ou imbriquées ; la colonne JSON recommandée (supporte les index GIN).
⤢json	JSON conservé comme texte d'origine.	Rare ; uniquement pour préserver l'ordre des clés ou les espacements exacts.
⤢xml	Texte XML.	Intégrations historiques qui exigent XML.
⤢jsonpath	Une expression de chemin compilée pour parcourir des données JSON.	Filtrage dans jsonb avec jsonb_path_query et les opérateurs SQL/JSON.
Réseau et recherche
⤢inet	Une adresse hôte IPv4 ou IPv6.	Stocker les IP de clients ou de serveurs.
⤢cidr	Un bloc réseau IP, par exemple 10.0.0.0/24.	Règles de pare-feu et plages de sous-réseaux.
⤢macaddr, macaddr8	Une adresse MAC sur 6 ou 8 octets (EUI-64).	Identifiants d'appareils et d'interfaces réseau.
⤢tsvector	Texte prétraité pour la recherche plein texte.	La recherche intégrée de Postgres avant d'adopter un moteur de recherche dédié.
⤢tsquery	Termes de recherche combinés avec les opérateurs AND, OR et préfixe.	La moitié requête de la recherche plein texte, confrontée à un tsvector avec @@.
⤢pg_lsn	Une position dans le journal d'écriture anticipée, le log sequence number.	Suivi du retard de réplication et supervision des sauvegardes.
Composites et avancés
⤢type[]	Un tableau de n'importe quel type de base, ex. integer[].	Listes de valeurs simples ; passez à une table enfant quand les éléments ont besoin de leurs propres colonnes.
⤢enum	Une valeur parmi une liste fixe que vous définissez.	Champs de statut avec un ensemble d'options stable.
⤢composite	Un type de ligne personnalisé composé de plusieurs champs.	Groupes de champs récurrents partagés entre tables.
⤢range (int4range, tsrange...)	Un intervalle continu entre deux bornes.	Plannings, tranches de prix et plages de versions, avec les opérateurs de chevauchement.
⤢domain	Un type de base enveloppé dans des contraintes que vous définissez.	Règles réutilisables comme un e-mail non vide, appliquées à chaque colonne qui l'utilise.
⤢record	Une ligne anonyme de valeurs typées.	Retours de fonctions PL/pgSQL et résultats de requêtes intermédiaires.
⤢point, line, box, path, polygon, circle	Valeurs géométriques bidimensionnelles intégrées.	Géométrie plane simple ; les lieux du monde réel exigent PostGIS.
⤢oid	Un identifiant système d'objet sur 4 octets non signé.	Jointures entre catalogues système ; pas pour des colonnes applicatives.
⤢name	Une chaîne d'identification interne de 63 caractères.	Requêtes sur les catalogues ; du text classique pour tout ce qui est visible par l'utilisateur.
Types d'extension
⤢hstore	Paires clé/valeur de chaînes dans une seule valeur (extension).	Maps plats ; jsonb couvre mieux ce besoin aujourd'hui.
⤢ltree	Un chemin de labels hiérarchique comme news.tech.ai (extension).	Arbres avec requêtes d'ancêtres et de descendants.
⤢citext	Du texte comparé sans tenir compte de la casse (extension).	Unicité insensible à la casse comme les e-mails, sans index sur lower().
⤢geometry (PostGIS)	Objets géographiques et géométriques de l'extension PostGIS.	Requêtes de distance, de contenance et d'index spatial.
⤢uuid-ossp	Des fonctions d'extension qui génèrent des UUID.	Génération historique ; depuis PG 13, gen_random_uuid() est intégré.