Após configurar uma fonte de dados Apache Gravitino, crie um rastreador de metadados no Data Map para coletar os metadados de catálogo (bancos de dados, tabelas, colunas e partições) gerenciados pelo Gravitino no DataWorks. Isso permite a descoberta e a governança de metadados entre data lakes. Este tópico descreve como realizar a coleta de metadados de uma fonte de dados Gravitino e explica os metadados coletados.
Pré-requisitos
-
Uma fonte de dados Apache Gravitino criada e aprovada no teste de conectividade. Para mais informações, consulte Apache Gravitino data source.
NotaNeste cenário, o Apache Gravitino atua apenas como canal de coleta de metadados. Após a coleta, os metadados exibidos no DataWorks ainda provêm dos catálogos subjacentes, como Iceberg Catalog, Paimon Catalog e Hive Catalog.
Um serverless resource group criado e associado ao workspace.
Limites
A coleta é compatível apenas com catálogos Relational, como Hive, Iceberg, Paimon e JDBC. Não há suporte para os tipos de catálogo Model, File Set e Messaging.
As informações de partição são recuperadas dinamicamente em tempo real, sem armazenamento estático. A cada visualização, os dados das partições são buscados sob demanda.
Criar uma tarefa de coleta de metadados
Faça logon no console do DataWorks. Na região de destino, clique em no painel de navegação à esquerda. Na página exibida, clique em Go to Data Map.
Na página do Data Map, clique em Metadata Collection na barra de navegação superior para acessar a página de coleta de metadados.
Na página de coleta de metadados, clique em Create Crawler para acessar a página Create Metadata Collection.
-
Na seção Basic Configuration, configure os seguintes parâmetros:
Parâmetro
Descrição
Collection Type
Selecione Apache Gravitino.
Configuration Source
O valor padrão é Data Source.
Select Workspace
Escolha o workspace ao qual a fonte de dados pertence ou selecione All Workspaces para visualizar todas as fontes de dados disponíveis.
Select Data Source
Selecione a fonte de dados Apache Gravitino criada. Após a seleção, o tipo da fonte de dados, o nome, o workspace, o tipo de ambiente e as informações de conexão aparecem abaixo.
Name
Nome personalizado da tarefa de coleta de metadados, como
gravitino_test. -
Na seção Resource Group Configuration, defina os seguintes parâmetros:
Parâmetro
Descrição
Resource Group
Selecione o grupo de recursos serverless para executar a tarefa de coleta. Após a seleção, o nome, o identificador, o tipo e o status do grupo de recursos são exibidos.
Test Connectivity
Clique em Test Connectivity para verificar a conectividade de rede entre o grupo de recursos e a fonte de dados. É necessário aprovar no teste de conectividade antes de salvar a configuração de coleta.
-
(Opcional) Na seção AI Enhancement Configuration, escolha se deseja ativar o AI Description Enhancement.
Ao ativar esse recurso, o sistema utiliza as capacidades de análise inteligente do modelo de linguagem grande do agente de dados do DataWorks para gerar automaticamente recomendações de descrição para tabelas e colunas após a conclusão da coleta de metadados. Os proprietários de ativos podem visualizar as descrições geradas por IA na página de detalhes da tabela e optar por confirmar ou modificar manualmente as descrições, melhorando a precisão e a padronização do gerenciamento de metadados.
-
Na seção Collection Plan, configure os seguintes parâmetros:
Parâmetro
Descrição
Trigger Method
Selecione o método de acionamento da coleta:
Manual: A coleta só pode ser acionada manualmente.
Periodic: A tarefa de coleta é executada automaticamente conforme a programação configurada.
Collection Frequency
Se você definir Trigger Method como Periodic, especifique a frequência de coleta. Valores válidos: Monthly, Weekly, Daily e Hourly. Caso selecione Hourly, escolha minutos específicos na lista suspensa Minutes. É possível selecionar vários valores, com granularidade mínima de 5 minutos (por exemplo, 0, 5, 10 e 15).
Após concluir a configuração, clique em Save and Run na parte inferior da página para salvar as definições e acionar imediatamente uma tarefa de coleta. Também é possível clicar em Save para salvar apenas a configuração e acionar a coleta manualmente mais tarde.
Visualizar detalhes do banco de dados
Após a execução bem-sucedida da tarefa de coleta, visualize os bancos de dados e as tabelas abrangidos pela coleta na aba Data Scope da página de detalhes do rastreador.
Na lista Metadata Collection, clique no nome do rastreador desejado para acessar a página de detalhes correspondente.
Clique na aba Data Scope para visualizar a lista de bancos de dados coletados.
A página Data Scope exibe as seguintes informações:
|
Coluna |
Descrição |
|
Database Name |
Nome do banco de dados (schema) coletado. |
|
Table Count |
Quantidade de tabelas coletadas no banco de dados. |
|
Last Updated |
Data e hora da última coleta e atualização dos metadados do banco de dados. |
|
Actions |
Clique em View Details para acessar a página de detalhes do banco de dados. |
Ao clicar em View Details, a página de detalhes do banco de dados será exibida. O lado esquerdo mostra as informações básicas do banco de dados e o lado direito apresenta a lista de tabelas.
A seção Basic Information inclui:
Total Tables: Total de tabelas coletadas no banco de dados.
Database: Nome do banco de dados.
Entity ID: Identificador exclusivo do banco de dados.
Technical Type: Tipo técnico do banco de dados, como Apache Hive, Iceberg ou Paimon.
Region: Região onde a fonte de dados está localizada.
A Table List exibe as seguintes informações:
|
Coluna |
Descrição |
|
Table Name |
Nome da tabela. Clique no nome para acessar a página de detalhes da tabela. |
|
Type |
Tipo técnico da tabela, como Apache Hive, Iceberg ou Paimon. |
|
Table Description |
Descrição da tabela. |
|
Created Time |
Data e hora de criação da tabela. |
|
Updated Time |
Data e hora da última atualização da tabela. |
Visualizar detalhes da tabela
Na lista de tabelas da página de detalhes do banco de dados, clique no nome de uma tabela para acessar sua página de detalhes. O lado esquerdo exibe as informações básicas, técnicas e comerciais da tabela. O lado direito mostra os detalhes das colunas e as notas de uso.
Informações básicas
A seção Basic Information exibe os seguintes campos:
|
Campo |
Descrição |
|
Table Name |
Nome da tabela. |
|
Data Source Type |
Tipo de fonte de dados da tabela, como Apache Hive, Iceberg ou Paimon. |
|
Database |
Banco de dados ao qual a tabela pertence. Clique no nome para acessar a página de detalhes do banco de dados. |
|
Entity ID |
Identificador exclusivo da tabela, gerado pela combinação do endereço de conexão do Gravitino Server, do nome do metalake e do nome do catálogo. |
|
Created Time |
Data e hora de criação da tabela. |
|
Table Description |
Descrição da tabela. |
|
AI Table Description |
Descrição da tabela gerada por IA. Se não tiver sido gerada, clique em Generate AI Description para acionar a geração manualmente. |
|
Table Type |
Tipo de gerenciamento da tabela, como MANAGED_TABLE ou EXTERNAL_TABLE. |
|
Partitioned |
Indica se a tabela é particionada. |
Informações técnicas
As informações técnicas podem variar conforme a fonte de dados. Consulte o conteúdo exibido na página para obter detalhes precisos.
Informações comerciais
A seção Business Information exibe a propriedade da tabela no Gravitino:
|
Campo |
Descrição |
|
Instance ID |
Identificador exclusivo da instância da fonte de dados Gravitino. |
|
Gravitino Instance Address |
Endereço de acesso do Gravitino Server. |
|
Metalake Name |
Nome do Metalake ao qual a tabela pertence. |
|
Catalog Name |
Nome do Catalog ao qual a tabela pertence. |
Detalhes das colunas
A aba Column Details no lado direito exibe a lista de colunas e as informações sobre colunas de partição:
Lista de colunas: Mostra nomes de colunas, tipos de dados, descrições e indicação de chave primária. Utilize a caixa de pesquisa para filtrar colunas ou clique em AI Column Description para gerar descrições automaticamente.
Informações de coluna de partição: Exibe nomes, tipos e descrições das colunas de partição. Se a tabela não for particionada, "No data" será exibido.