Uma Object Table fornece índices de metadados para arquivos não estruturados — como imagens e vídeos — em um diretório de armazenamento de objetos especificado e apresenta esses arquivos como uma tabela virtual. Leia uma Object Table como uma lista de arquivos estruturada usando um mecanismo de computação SQL ou acesse seus arquivos via PVFS. O DLF gerencia Object Tables em catálogos e oferece suporte a controle de acesso.
Pré-requisitos
Antes de começar, verifique se você possui:
Um catálogo DLF. Para mais informações, consulte Gerencie e configure catálogos DLF.
Um banco de dados no catálogo. Para mais informações, consulte Gerencie bancos de dados DLF.
As permissões necessárias para criar, visualizar e excluir tabelas no banco de dados.
Criar uma Object Table
Criar uma Object Table no console
Acesse o DLF console
No painel de navegação à esquerda, selecione Catalogs. Clique no nome do catálogo para abrir a página de detalhes.
Na seção Database, clique no nome do banco de dados.
Clique em Create Table.
-
Configure os parâmetros a seguir e clique em OK.
Parameter
Description
Table Format
Selecione Object Table.
Table Name
Insira um nome para a tabela. O nome deve ser exclusivo no banco de dados.
Table Description
Insira uma descrição.
Criar uma Object Table via SQL
Se você registrou seu catálogo DLF em outros sistemas — como EMR Serverless Spark ou Realtime Compute for Apache Flink —, crie bancos de dados e tabelas diretamente nessas plataformas usando SQL. Os metadados são gravados no DLF. Para mais informações, consulte Engine integration.
Ambos os exemplos utilizam 'type'='object-table' para especificar o formato da tabela.
Após criar uma Object Table, um mecanismo de computação SQL pode lê-la como uma lista de arquivos estruturada.
Flink SQL — execute no console do Realtime Compute for Apache Flink:
CREATE TABLE object_table WITH (
'type'='object-table'
);
Spark SQL — execute no console do EMR Serverless Spark:
CREATE TABLE object_table OPTIONS (
'type'='object-table'
)
Visualizar uma Object Table e configurar permissões
Na seção Database, clique no nome do banco de dados.
Na aba Tables, clique no nome da Object Table para ver seus detalhes.
Na aba Table Details, revise as informações básicas e as colunas da tabela.
Na aba Permissions, conceda permissões sobre a tabela a usuários ou funções do DLF. Para mais informações, consulte Data authorization management.
Acessar uma Object Table via PVFS
O Paimon oferece uma interface de sistema de arquivos que permite ler dados de uma Object Table pelo seguinte caminho virtual:
pvfs://catalog_name/database_name/table_name/file
Substitua catalog_name, database_name e table_name pelo nome real do catálogo, banco de dados e tabela. Para mais informações, consulte PVFS.
Excluir uma tabela de dados
Excluir uma tabela remove tanto seus metadados quanto seus dados. Os dados são retidos por um dia como salvaguarda contra exclusões acidentais. Após esse período, os dados são excluídos permanentemente.
Na lista Database, clique no nome de um banco de dados para abrir a lista de tabelas.
Na table list, clique em Delete na coluna Actions.
Na caixa de diálogo, clique em OK.
As tabelas excluídas podem ser restauradas durante o período de retenção de metadados. Para mais informações, consulte Recycle bin.