PostgreSQLLa base de données la plus sophistiquée au monde.
Documentation PostgreSQL 16.5 » Référence » Commandes SQL » CREATE COLLATION
Précédent Niveau supérieur Suivant
CREATE CAST Sommaire CREATE CONVERSION

CREATE COLLATION

CREATE COLLATION — définit une nouvelle collation

Synopsis

CREATE COLLATION [ IF NOT EXISTS ] nom (
    [ LOCALE = locale, ]
    [ LC_COLLATE = lc_collate, ]
    [ LC_CTYPE = lc_ctype, ]
    [ PROVIDER = provider, ]
    [ DETERMINISTIC = boolean, ]
    [ RULES = rules, ]
    [ VERSION = version ]
)
CREATE COLLATION [ IF NOT EXISTS ] nom FROM collation_existante

Description

CREATE COLLATION définit une nouvelle collation utilisant la configuration de locale du système d'exploitation spécifiée ou par copie d'une collation existante.

Pour pouvoir créer une collation, vous devez posséder le privilège CREATE sur le schéma de destination.

Paramètres

IF NOT EXISTS

Ne renvoie pas d'erreur si une collation du même nom existe déjà. Une note est affichée dans ce cas. Veuillez noter qu'il n'y a aucune garantie que la collation existante ait quelque rapport que ce soit avec la collation qui aurait été créée.

nom

Le nom de la collation. Le nom de la collation peut être qualifié par le schéma. Si ce n'est pas le cas, la collation est définie dans le schéma courant. Le nom de la collation doit être unique au sein de ce schéma. (Le catalogue système peut contenir des collations de même nom pour d'autres encodages, mais ces dernières sont ignorées si l'encodage de la base de données ne correspond pas).

locale

Le nom de la locale pour cette collation. Voir Section 24.2.2.3.1 et Section 24.2.2.3.2 pour les détails.

Si provider vaut libc, c'est un raccourci pour configurer LC_COLLATE et LC_CTYPE à la fois. Si vous indiquez locale, vous ne pouvez pas indiquer l'un de ces deux paramètres.

lc_collate

Si provider vaut libc, utilise la locale du systèm d'exploitation pour la catégorie de locale LC_COLLATE.

lc_ctype

Si provider vaut libc, utilise la locale du systèm d'exploitation pour la catégorie de locale LC_CTYPE.

provider

Spécifie le fournisseur à utiliser pour les services de locale associés à cette collation. Les valeurs possibles sont : icu (si le serveur a été compilé avec le support d'ICU) ou libc. libc est la valeur par défaut. Voir Section 24.1.4 pour les détails.

DETERMINISTIC

Indique si la collation doit utiliser des comparaisons déterministes. La valeur par défaut est vraie. Une comparaison déterministe considère que les chaînes de caractères qui ne sont pas équivalentes à l'octet près ne sont pas égales, même si la comparaison logique a pour résultat qu'elles sont égales. PostgreSQL départage les égalités en utilisant une comparaison à l'octet. Une comparaison non déterministe peut faire que la collation est, par exemple, insensible à la casse ou aux accents. Pour cela, vous devez choisir une option LOCALE appropriée et indiquer ici que la collation est non déterministe.

Les collations non déterministes sont supportées uniquement par le fournisseur ICU.

rules

Indique des règles de collation supplémentaires pour personnaliser le comportement de la collation. Ceci est uniquement accepté par ICU. Voir Section 24.2.3.4 pour les détails.

version

Spécifie le texte de la version à stocker avec la collation. Normalement, ce paramètre devrait être omis, ce qui fera que la version sera calculée en fonction de la version courante de la collation telle que fournie par le système d'exploitation. Cette option est prévue pour être utilisée par pg_upgrade pour copier la version depuis une installation existante.

Voir aussi ALTER COLLATION pour savoir comment gérer les incompatibilités de version de collations.

collation_existante

Le nom d'une collation existante à copier. La nouvelle collation aura les mêmes propriétés que celle copiée, mais ce sera un objet indépendant.

Notes

CREATE COLLATION acquiert un verrou SHARE ROW EXCLUSIVE, qui est exclusif avec lui-même, sur le catalogue système pg_collation, de sorte qu'une seule commande CREATE COLLATION peut s'exécuter à la fois.

Utilisez DROP COLLATION pour supprimer une collation définie par l'utilisateur.

Voir Section 24.2.2.3 pour plus d'informations sur la création de collations.

Lors de l'utilisation du fournisseur de collation libc, la locale doit être applicable à l'encodage actuel de la base de données. Voir CREATE DATABASE pour les règles précises.

Exemples

Créer une collation à partir de la locale système fr_FR.utf8 (en supposant que l'encodage de la base courante est UTF8): 

CREATE COLLATION french (locale = 'fr_FR.utf8');

Pour créer une collation en utilisant le fournisseur ICU utilisant l'ordre de tri du carnet de téléphone allemand : 

CREATE COLLATION german_phonebook (provider = icu, locale = 'de-u-co-phonebk');

Pour créer une collation en utilisant le fournisseur ICU, basé sur la locale ICU racine avec des règles personnalisées : 

CREATE COLLATION custom (provider = icu, locale = 'und', rules = '&V << w <<< W');

Voir Section 24.2.3.4 pour plus de détails et d'exemples sur la syntaxe des règles.

Créer une collation à partir d'une collation existante : 

CREATE COLLATION german FROM "de_DE";

Ceci peut être pratique pour pouvoir utiliser dans des applications des noms de collation indépendants du système d'exploitation.

Compatibilité

Dans le standard SQL se trouve un ordre CREATE COLLATION, mais il est limité à la copie d'une collation existante. La syntaxe de création d'une nouvelle collation est une extension PostgreSQL.