CREATE DOMAIN |
Crée un domaine |
|---|---|
| PostgreSQL | |
Syntaxe
|
CREATE DOMAIN name [ AS ] data_type [ COLLATE collation ] [ DEFAULT expression ] [ constraint [ ... ] ] où la constraint est : [ CONSTRAINT constraint_name ] { NOT NULL | NULL | CHECK (expression) } |
Paramètres
| Nom | Description |
|---|---|
| name | Ce paramètre permet d'indiquer le nom (éventuellement qualifié de schéma) d'un domaine à créer. |
| data_type | Ce paramètre permet d'indiquer le type de données sous-jacent du domaine. Cela peut inclure des spécificateurs de tableau. |
| collation | Ce paramètre permet d'indiquer un classement facultatif pour le domaine. Si aucun classement n'est spécifié, le classement par défaut des types de données sous-jacents est utilisé. Le type sous-jacent doit pouvoir être collationné si COLLATE est spécifié. |
| DEFAULT expression | Ce paramètre permet d'indiquer l'expression par défaut. La clause DEFAULT spécifie une valeur par défaut pour les colonnes du type de données de domaine. La valeur est toute expression sans variable (mais les sous-requêtes ne sont pas autorisées). Le type de données de l'expression par défaut doit correspondre au type de données du domaine. Si aucune valeur par défaut n'est spécifiée, la valeur par défaut est la valeur nulle. Le paramètre expressionsera utilisée dans toute opération d'insertion ne spécifiant pas de valeur pour la colonne. Si une valeur par défaut est définie pour une colonne particulière, elle remplace toute valeur par défaut associée au domaine. À son tour, la valeur par défaut du domaine remplace toute valeur par défaut associée au type de données sous-jacent. |
| CONSTRAINT constraint_name | Ce paramètre permet d'indiquer un nom facultatif pour une contrainte. S'il n'est pas spécifié, le système génère un nom. |
| NOT NULL | Ce paramètre permet d'indiquer que les valeurs de ce domaine ne peuvent pas être nulles. |
| NULL | Ce paramètre permet d'indiquer les valeurs de ce domaine peuvent être nulles. C'est la valeur par défaut. Cette clause est uniquement destinée à la compatibilité avec les bases de données SQL non standard. Son utilisation est déconseillée dans les nouvelles applications. |
| CHECK (expression) | Ce paramitre permet d'indiquer l'expression à vérifier. Les clauses CHECK spécifient des contraintes d'intégrité ou des tests auxquels les valeurs du domaine doivent satisfaire. Chaque contrainte doit être une expression produisant un résultat booléen. Il doit utiliser le mot clef VALUE pour faire référence à la valeur testée. Les expressions évaluées à TRUE ou UNKNOWN réussissent. Si l'expression produit un résultat FALSE, une erreur est signalée et la valeur ne peut pas être convertie en type de domaine. Actuellement, les expressions CHECK ne peuvent pas contenir de sous-requêtes ni faire référence à des variables autres que VALUE. Lorsqu'un domaine a plusieurs contraintes CHECK, elles seront testées par ordre alphabétique de nom. (Les versions de PostgreSQL antérieures à la 9.5 n'honoraient aucun ordre de déclenchement particulier pour les contraintes CHECK.) |
Description
Cette instruction permet de définir un nouveau domaine.
Dernière mise à jour : Jeudi, le 14 Octobre 2021