Todos os produtos
Search
Central de documentação

Hologres:Criar uma tabela externa no HoloWeb

Última atualização: Jun 28, 2026

O HoloWeb oferece uma interface gráfica para criar, editar, renomear, excluir e visualizar tabelas externas sem escrever SQL. As tabelas externas mapeiam dados do MaxCompute para schemas do Hologres e permitem acelerar consultas diretamente pelo console do Hologres.

Pré-requisitos

Antes de começar, verifique se você:

Criar uma tabela externa

A criação de uma tabela externa envolve três etapas: escolha do método de aceleração, configuração dos parâmetros de origem e destino e envio da definição da tabela.

Escolher um método de aceleração

O Hologres oferece três métodos de aceleração. Selecione o método adequado à quantidade de dados do projeto MaxCompute que você deseja mapear.

Método

Quando usar

Entire Project

Mapeie todas as tabelas de um projeto MaxCompute para um schema do Hologres simultaneamente.

Selected Tables

Mapeie um subconjunto de tabelas de um projeto MaxCompute. Este método suporta busca aproximada e exibe até 200 tabelas.

Single Table

Mapeie uma tabela específica do MaxCompute para o Hologres.

Abrir a página de criação

  1. Faça logon no Console de Gerenciamento do Hologres.

  2. No painel de navegação à esquerda da barra de menu superior, selecione a região de destino.

  3. Clique em Go to HoloWeb.

  4. Na barra de navegação superior, clique em Metadata Management > MaxCompute Query Acceleration e, em seguida, clique em Create Foreign Table. Como alternativa, na página Metadata Management, localize o banco de dados de destino na lista Logged On Instances, clique no banco de dados, clique com o botão direito no schema desejado e selecione Create MaxCompute External Table.

Configurar parâmetros

Os parâmetros disponíveis variam conforme o método de aceleração selecionado.

Entire Project

Parâmetro

Obrigatório

Descrição

Acceleration Method

Sim

Selecione Entire Project.

Project Name

Sim

Nome do projeto MaxCompute.

Schema Name

Não

Nome do schema no MaxCompute. Aplicável apenas quando os schemas estão habilitados para o projeto. Configure todos os nomes de schema aos quais você tem permissão. Para mais detalhes, consulte Operações de schema.

Holo Schema

Sim

Schema de destino no Hologres. Selecione public ou um schema personalizado.

Processing Rule for Table Name Conflicts

Sim

Define como tratar tabelas com o mesmo nome no schema de destino: Ignore and continue to create other tables, Update and modify the table with the same name ou Report an error and stop creation.

Processing Rule for Unsupported Data Types

Sim

Determina o tratamento para campos com tipos de dados não suportados: Report an error and fail the import ou Ignore and Skip Table of Unsupported Fields.

Selected Tables

Inclui todos os parâmetros da tabela Entire Project, além de:

Parâmetro

Obrigatório

Descrição

Search

Não

Busca aproximada por nome de tabela. Exibe no máximo 200 tabelas.

Single Table

Parâmetro

Obrigatório

Descrição

Acceleration Method

Sim

Selecione Single Table.

Project Name

Sim

Nome do projeto MaxCompute.

Schema Name

Não

Nome do schema no MaxCompute. Aplicável apenas quando os schemas estão habilitados para o projeto.

Table Name (source)

Sim

Tabela no schema do MaxCompute a ser mapeada. Suporta busca aproximada por prefixo de tabela.

Schema (destino)

Sim

Schema de destino no Hologres. Selecione public ou um schema personalizado.

Table Name (destino)

Sim

Nome da tabela externa no Hologres.

Destination Table Description

Não

Descrição da tabela externa.

Ao criar uma tabela externa a partir de uma tabela do MaxCompute, o sistema sincroniza automaticamente os comentários de campos e colunas da tabela de origem com o Hologres.

Enviar e verificar

  1. Clique em Submit.

  2. No painel de navegação à esquerda, atualize o schema para confirmar que a nova tabela externa aparece sob o schema correspondente.

  3. (Opcional) Clique em Query Table na página da tabela externa para abrir a janela de consulta SQL e executar consultas PostgreSQL na tabela.

Editar uma tabela externa

  1. No painel de navegação à esquerda, clique em Logged-in Instances e expanda a instância de destino.

  2. Clique no Database desejado para listar todos os bancos de dados dessa instância.

  3. Sob o schema de destino, clique em Foreign Tables para listar todas as tabelas externas.

  4. Clique com o botão direito na tabela externa desejada e selecione Open Table.

  5. No canto superior direito da aba da tabela, clique em Edit Table.

  6. Modifique os Fields ou Partitions do mapeamento da tabela de origem conforme necessário.

    Edit a foreign table

  7. Clique em Submit.

Renomear uma tabela externa

  1. No painel de navegação à esquerda, clique em Logged-in Instances e navegue até a tabela externa de destino.

  2. Sob a instância de destino, clique no Database desejado.

  3. Sob o schema de destino, clique em Foreign Tables.

  4. Clique com o botão direito na tabela externa desejada e selecione Rename.

  5. Clique em OK.

Excluir uma tabela externa

  1. No painel de navegação à esquerda, clique em Logged-in Instances e navegue até a tabela externa de destino.

  2. Sob a instância de destino, clique no Database desejado.

  3. Sob o schema de destino, clique em Foreign Tables.

  4. Clique com o botão direito na tabela externa desejada e selecione Delete Table.

  5. Clique em OK.

Visualizar dados

  1. No painel de navegação à esquerda, na página Logged On Instances, navegue até a tabela externa de destino.

  2. Sob a instância de destino, clique no Database desejado.

  3. Sob o schema de destino, clique em Foreign Tables.

  4. Clique duas vezes na tabela externa desejada e, em seguida, clique em Data Preview na aba da tabela.

Próximos passos

Para criar e gerenciar tabelas externas com SQL em vez da interface do HoloWeb, consulte: