PostgreSQLLa base de données la plus sophistiquée au monde.
Documentation PostgreSQL 15.10 » 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, ]
    [ 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

Ceci est un raccourci pour positionner d'un même coup LC_COLLATE et LC_CTYPE. Si vous spécifiez cela, vous ne pouvez plus spécifier aucun de ces deux paramètres-ci.

lc_collate

Utilise la locale système spécifiée comme catégorie de locale de LC_COLLATE.

lc_ctype

Utilise la locale système spécifiée comme catégorie de locale de LC_CTYPE.

provider

Spécifie le fournisseur à utiliser pour les services de locale associés à cette collation. Les valeurs possibles sont : icu, , libc. libc est la valeur par défaut. Le choix disponible dépend du système d'exploitation ainsi que des options de compilation.

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.

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');

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.