Todos os produtos
Search
Central de documentação

Hologres:Create a MaxCompute foreign table in HoloWeb

Última atualização: Aug 20, 2026

Este tópico descreve como usar o HoloWeb para criar, editar ou excluir tabelas externas, além de visualizar dados e instruções DDL dessas tabelas.

Pré-requisitos

Você fez logon em uma instância do Hologres. Para mais informações, consulte Log on to an instance.

Criar uma tabela externa

  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 desejada.

  3. Na barra de navegação superior da página de desenvolvimento do HoloWeb, escolha Metadata Management > Import from MaxCompute e clique em Create Foreign Table.

    Alternativamente, clique no banco de dados de destino na lista Logged-in Instances da página Metadata Management, clique com o botão direito no schema desejado nesse banco de dados e selecione Create MaxCompute External Table.

  4. Na página Create Foreign Table, configure os parâmetros conforme o método de aceleração escolhido.

    Entire project

    Categoria

    Parâmetro

    Descrição

    Acceleration Method

    Select an acceleration method.

    O Hologres oferece os seguintes métodos de aceleração:

    • Entire Project

    • Selected Tables

    • Single Table

    Selecione Entire Project.

    MaxCompute data source

    Project Name

    Nome do projeto do MaxCompute.

    Schema Name

    Nome do schema do MaxCompute.

    Em projetos do MaxCompute com schemas habilitados, é possível especificar qualquer schema ao qual você tenha acesso autorizado. Esse parâmetro não é necessário para projetos sem schemas habilitados. Para mais detalhes sobre schemas, consulte Schema operations.

    Destination Table Position

    Holo schema

    Nome do schema de destino.

    Escolha o schema padrão public ou um schema personalizado.

    Advanced Settings

    Processing Rule for Table Name Conflicts

    Defina como tratar conflitos de nomes de tabelas:

    • Ignore and continue creating other tables

    • Update and modify the table with the same name

    • Report an error and stop creating tables

    Processing Rule for Unsupported Data Types

    Defina como lidar com tipos de dados não suportados:

    • Report an error and fail the import

    • Ignore and Skip Table of Unsupported Fields

    Selected tables

    Categoria

    Parâmetro

    Descrição

    Acceleration Method

    Select an acceleration method.

    O Hologres oferece os seguintes métodos de aceleração:

    • Entire Project

    • Selected Tables

    • Single Table

    Selecione Selected Tables.

    MaxCompute data source

    Project Name

    Nome do projeto do MaxCompute.

    Schema Name

    Nome do schema do MaxCompute.

    Em projetos do MaxCompute com schemas habilitados, é possível especificar qualquer schema ao qual você tenha acesso autorizado. Esse parâmetro não é necessário para projetos sem schemas habilitados. Para mais detalhes sobre schemas, consulte Schema operations.

    Destination Table Position

    Holo schema

    Nome do schema de destino.

    Escolha o schema padrão public ou um schema personalizado.

    Advanced Settings

    Processing Rule for Table Name Conflicts

    Defina como tratar conflitos de nomes de tabelas:

    • Ignore and continue creating other tables

    • Update and modify the table with the same name

    • Report an error and stop creating tables

    Processing Rule for Unsupported Data Types

    Defina como lidar com tipos de dados não suportados:

    • Report an error and fail the import

    • Ignore and Skip Table of Unsupported Fields

    Search

    Permite busca aproximada pelo nome da tabela. O sistema exibe no máximo 200 tabelas.

    Single table

    Categoria

    Parâmetro

    Descrição

    Acceleration Method

    Select an acceleration method.

    O Hologres oferece os seguintes métodos de aceleração:

    • Entire Project

    • Selected Tables

    • Single Table

    Selecione Single Table.

    MaxCompute data source

    Project Name

    Nome do projeto do MaxCompute.

    Schema Name

    Nome do schema do MaxCompute.

    Em projetos do MaxCompute com schemas habilitados, é possível especificar qualquer schema ao qual você tenha acesso autorizado. Esse parâmetro não é necessário para projetos sem schemas habilitados. Para mais detalhes sobre schemas, consulte Schema operations.

    Table Name

    Tabela de dados no schema especificado do MaxCompute. Há suporte para busca aproximada pelo prefixo do nome da tabela.

    Destination Hologres Table

    Schema

    Nome do schema de destino.

    Escolha o schema padrão public ou um schema personalizado.

    Table Name

    Nome da tabela do Hologres para aceleração de consultas.

    Destination Table Description

    Descrição da tabela do Hologres para aceleração de consultas.

    Nota

    Ao criar uma tabela externa para sincronizar dados de uma tabela do MaxCompute, os comentários da tabela e de suas colunas também são sincronizados com o Hologres.

  5. Clique em Submit. Em seguida, atualize o schema no painel de navegação para visualizar a nova tabela externa.

  6. Opcional: Na página da tabela externa recém-criada, clique em Query Table para abrir a janela de consulta SQL. Use PostgreSQL padrão para escrever suas consultas.

Editar uma tabela externa

  1. No painel de navegação, clique em Instances Connected.

  2. Na instância de destino, clique em Database.

  3. No banco de dados desejado e dentro do Schema correspondente, clique em Foreign Tables.

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

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

  6. Altere os Fields ou as Partitions mapeados da tabela de origem. A página de edição exibe configurações básicas como Instance Name, Database, Table Name, Description e Schema. Na seção External Service, configure o Type do service (por exemplo, MaxCompute), a Server List (por exemplo, odps_server) e a Table de origem. Na aba Basic Information, utilize as subabas Fields e Partitions para visualizar e editar a lista de campos. Ao concluir, clique em Submit Table para salvar as alterações.

  7. Clique em Submit para salvar as alterações.

Renomear uma tabela externa

  1. Na lista Instances Connected do painel de navegação, localize a tabela externa desejada.

  2. Na instância de destino, clique em Database para exibir a lista de bancos de dados criados.

  3. No banco de dados desejado e dentro do Schema correspondente, clique em Foreign Tables para exibir a lista de tabelas externas criadas.

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

  5. Clique em OK.

Excluir uma tabela externa

  1. Na lista Instances Connected do painel de navegação, localize a tabela externa desejada.

  2. Na instância de destino, clique em Database para exibir a lista de bancos de dados criados.

  3. No banco de dados desejado e dentro do Schema correspondente, clique em Foreign Tables para exibir a lista de tabelas externas criadas.

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

  5. Na mensagem exibida, clique em OK.

Visualizar dados

  1. Na lista Instances Connected do painel de navegação, localize a tabela externa desejada.

  2. Na instância de destino, clique em Database para exibir a lista de bancos de dados criados.

  3. No banco de dados desejado e dentro do Schema correspondente, clique em Foreign Tables para exibir a lista de tabelas externas criadas.

  4. Dê um clique duplo na tabela externa de destino e selecione a aba Data Preview na página aberta.

Documentos relacionados

Também é possível usar instruções SQL para criar, alterar e remover tabelas externas. Para mais informações, consulte os tópicos a seguir: