| Nom |
Description |
| IF NOT EXISTS |
Ce paramètre permet d'indiquer qu'il n'existe pas. Ne renvoie pas d'erreur si une extension du même nom existe déjà. Un avis est émis dans ce cas. Notez qu'il n'y a aucune garantie que l'extension existante ressemble à celle ayant été créée à partir du fichier de script actuellement disponible. |
| extension_name |
Ce paramètre permet d'indiquer le nom de l'extension à installer. PostgreSQL créera l'extension en utilisant les détails du fichier SHAREDIR/extension/extension_name.control. |
| schema_name |
Ce paramètre permet d'indiquer le nom du schéma dans lequel installer les objets de l'extension, étant donné que l'extension permet de déplacer son contenu. Le schéma nommé doit déjà exister. S'il n'est pas spécifié et que le fichier de contrôle de l'extension ne spécifie pas non plus de schéma, le schéma de création d'objet par défaut actuel est utilisé. Si l'extension spécifie un paramètre de schéma dans son fichier de contrôle, ce schéma ne peut pas être remplacé par une clause SCHEMA. Normalement, une erreur sera générée si une clause SCHEMA est fournie et qu'elle entre en conflit avec le paramètre de schéma de l'extension. Cependant, si la clause CASCADE est également fournie, alors schema_name est ignoré en cas de conflit. Le schema_name donné sera utilisé pour l'installation de toutes les extensions nécessaires ne spécifiant pas de schéma dans leurs fichiers de contrôle. N'oubliez pas que l'extension elle-même n'est pas considérée comme faisant partie d'un schéma : les extensions ont des noms non qualifiés qui doivent être uniques à l'échelle de la base de données. Mais les objets appartenant à l'extension peuvent être à l'intérieur de schémas. |
| version |
Ce paramètre permet d'indiquer la version de l'extension à installer. Cela peut être écrit sous forme d'un identificateur ou de littéral de chaîne de caractères. La version par défaut est celle étant spécifiée dans le fichier de contrôle de l'extension. |
| old_version |
Ce paramètre doit être spécifié quand, et seulement quand, vous essayez d'installer une extension remplaçant un module «à l'ancienne» n'étant qu'une collection d'objets non empaquetés dans une extension. Cette option permet à CREATE EXTENSION d'exécuter un script d'installation alternatif absorbant les objets existants dans l'extension, au lieu de créer de nouveaux objets. Veillez à ce que SCHEMA spécifie le schéma contenant ces objets préexistants. La valeur à utiliser pour old_version est déterminée par l'auteur de l'extension et peut varier s'il existe plusieurs versions du module à l'ancienne pouvant être mises à niveau vers une extension. Pour les modules supplémentaires standard fournis avec PostgreSQL pré-9.1, utilisez unpacked pour old_version lors de la mise à jour d'un module vers le style d'extension. |
| CASCADE |
Ce paramètre permet d'installer automatiquement toutes les extensions dont dépend cette extension et n'étant pas déjà installées. Leurs dépendances sont également installées automatiquement, de manière récursive. La clause SCHEMA, si elle est fournie, s'applique à toutes les extensions installées de cette manière. Les autres options de l'instruction ne s'appliquent pas aux extensions installées automatiquement ; en particulier, leurs versions par défaut sont toujours sélectionnées. |
Cette instruction permet d'installer une extension.
