Todos os produtos
Search
Central de documentação

Hologres:CREATE EXTERNAL SCHEMA

Última atualização: Jun 28, 2026

Cria um schema externo no Hologres mapeado para um banco de dados em um catálogo do Data Lake Formation (DLF) 2.0. Após a execução do comando, o sistema cria um banco de dados com o mesmo nome no catálogo DLF 2.0.

Pré-requisitos

Antes de executar este comando, verifique se você possui:

  • Uma instância do Hologres na versão V3.0 ou superior

  • Privilégios de superusuário ou permissão CREATE no banco de dados do Hologres

Sintaxe

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

Parâmetros

Parâmetro

Descrição

IF NOT EXISTS

Evita erros caso o schema externo já exista. Utilize esta cláusula em scripts para prevenir falhas durante reexecuções.

EXT_DB_NAME

Nome do banco de dados externo no Hologres que utiliza o DLF 2.0 como fonte de dados.

EXT_SCHEMA_NAME

Nome do schema externo a criar. O sistema cria um banco de dados com este nome no catálogo DLF 2.0.

Limitações

  • A fonte de dados do banco de dados externo deve ser o DLF 2.0. Não há suporte para bancos de dados externos baseados em DLF 1.0 ou MaxCompute.

Exemplo

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

Mais operações

Listar todos os schemas externos em um banco de dados externo

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

Atualizar metadados do schema

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