Todos os produtos
Search
Central de documentação

Data Lake Formation:Access Iceberg catalogs in DLF using Flink SQL

Última atualização: Sep 18, 2026

Use o Flink SQL para se conectar a um catálogo do Data Lake Formation (DLF) por meio do protocolo REST do Iceberg e, em seguida, consulte as tabelas do Iceberg diretamente do seu cluster de sessão do Flink.

Pré-requisitos

Antes de começar, certifique-se de ter:

Registre o catálogo do DLF no Flink

Registrar um catálogo no Flink cria um mapeamento para o seu catálogo do DLF. Criar ou excluir o catálogo no Flink não afeta os dados reais no DLF. Todas as tabelas criadas no catálogo do DLF por meio do protocolo REST do Iceberg são tabelas do Iceberg.
  1. Acesse o Realtime Compute for Apache Flink Management Console.

  2. Na coluna Actions do seu workspace, clique em Console.

  3. No painel de navegação à esquerda, clique em Development > Scripts.

  4. Crie um novo script e cole a seguinte instrução SQL no editor SQL.

    CREATE CATALOG `catalog_name`
     WITH (
        'type' = 'iceberg',
        'catalog-type' = 'rest',
        'uri' = 'http://{region-id}-vpc.dlf.aliyuncs.com/iceberg',
        'warehouse' = 'iceberg_test',
        'rest.signing-region' = '{region-id}',
        'io-impl' = 'org.apache.iceberg.rest.DlfFileIO'
    );

    Substitua {region-id} pelo ID da região do seu catálogo do DLF, por exemplo, cn-hangzhou ou ap-southeast-1. Para todas as regiões com suporte e seus respectivos valores de endpoint, consulte Regions and endpoints.

  5. No canto inferior direito, clique em Environment, selecione um cluster de sessão executando o VVR 11.2.0 ou posterior e execute a instrução SQL.

A tabela a seguir descreve as opções de configuração.

Opção

Descrição

Obrigatório

Exemplo

type

O tipo de catálogo. Defina como iceberg.

Sim

iceberg

catalog-type

O tipo de catálogo. Defina como rest.

Sim

rest

token.provider

O provedor de token para autenticação do DLF. Defina como dlf.

Sim

dlf

uri

O endpoint REST do Iceberg para o seu catálogo do DLF. Use o formato http://{region-id}-vpc.dlf.aliyuncs.com/iceberg. Para valores específicos da região, consulte Regions and endpoints.

Sim

http://ap-southeast-1-vpc.dlf.aliyuncs.com/iceberg

warehouse

O nome do seu catálogo do DLF.

Sim

iceberg_test

rest.signing-region

O ID da região do seu catálogo do DLF. Para IDs de região, consulte Regions and endpoints.

Sim

ap-southeast-1

io-impl

A implementação FileIO para o DLF. Defina como org.apache.iceberg.rest.DlfFileIO.

Sim

org.apache.iceberg.rest.DlfFileIO

Consulte dados no catálogo

Depois de registrar o catálogo, execute a seguinte instrução SQL em Scripts:

SELECT * FROM catalog_name.database_name.table_name;

Substitua catalog_name, database_name e table_name pelos nomes reais do seu catálogo do DLF.