Todos los productos
Search
Centro de documentos

Hologres:CREATE EXTERNAL SCHEMA

Última actualización: Sep 05, 2026

Cree un esquema externo en Hologres que se asigna a una base de datos en un catálogo de Data Lake Formation (DLF) 2.0. Una vez ejecutado el comando, se crea una base de datos con el mismo nombre en el catálogo de DLF 2.0.

Requisitos previos

Antes de ejecutar este comando, asegúrese de cumplir con lo siguiente:

  • Una instancia de Hologres que ejecute la versión 3.0 o posterior

  • Privilegios de superusuario o el permiso CREATE en la base de datos de Hologres

Sintaxis

CREATE EXTERNAL SCHEMA [IF NOT EXISTS] <EXT_DB_NAME>.<EXT_SCHEMA_NAME>;

Parámetros

Parámetro

Descripción

IF NOT EXISTS

Evita que se genere un error si el esquema externo ya existe. Utilice esta cláusula en scripts para prevenir fallos al volver a ejecutarlos.

EXT_DB_NAME

Nombre de la base de datos externa en Hologres que utiliza DLF 2.0 como origen de datos.

EXT_SCHEMA_NAME

Nombre del esquema externo por crear. Se generará una base de datos con este nombre en el catálogo de DLF 2.0.

Limitaciones

  • El origen de datos de la base de datos externa debe ser DLF 2.0. No son compatibles las bases de datos externas respaldadas por DLF 1.0 o MaxCompute.

Ejemplo

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

Más operaciones

Listar todos los esquemas externos en una base de datos externa

SELECT * FROM hologres.hg_external_schemas('<EXT_DB_NAME>');

Actualizar metadatos del esquema

REFRESH CACHE FOR External Schema <EXT_DB_NAME>.<EXT_SCHEMA_NAME> WITH (cache_level = 'metadata');