Crée un schéma externe dans Hologres mappé à une base de données d'un catalogue Data Lake Formation (DLF) 2.0. L'exécution de la commande crée une base de données portant le même nom dans le catalogue DLF 2.0.
Prérequis
Avant d'exécuter cette commande, vérifiez que vous disposez des éléments suivants :
Une instance Hologres en version V3.0 ou ultérieure
Des privilèges Superuser ou l'autorisation CREATE sur la base de données Hologres
Syntaxe
CREATE EXTERNAL SCHEMA [IF NOT EXISTS] <EXT_DB_NAME>.<EXT_SCHEMA_NAME>;Paramètres
| Paramètre | Description |
|---|---|
IF NOT EXISTS |
Évite une erreur si le schéma externe existe déjà. Utilisez cette clause dans les scripts pour prévenir les échecs lors des réexécutions. |
EXT_DB_NAME |
Nom de la base de données externe dans Hologres utilisant DLF 2.0 comme source de données. |
EXT_SCHEMA_NAME |
Nom du schéma externe à créer. Une base de données portant ce nom est créée dans le catalogue DLF 2.0. |
Limites
La source de données de la base de données externe doit être DLF 2.0. Les bases de données externes s'appuyant sur DLF 1.0 ou MaxCompute ne sont pas prises en charge.
Exemple
-- Create an external schema in the DLF 2.0-backed external database ext_db_dlf
CREATE EXTERNAL SCHEMA IF NOT EXISTS ext_db_dlf.ext_dlf_db;Opérations supplémentaires
Répertorier tous les schémas externes d'une base de données externe
SELECT * FROM hologres.hg_external_schemas('<EXT_DB_NAME>');Actualiser les métadonnées du schéma
REFRESH CACHE FOR External Schema <EXT_DB_NAME>.<EXT_SCHEMA_NAME> WITH (cache_level = 'metadata');