DataWorks:Dados de tabelas do MaxCompute

O cabeçalho da página de detalhes da tabela exibe o nome da tabela, a tag de tipo, a descrição e botões de ação. A visibilidade dos botões depende das suas permissões, do tipo de tabela e da ativação pelo tenant:

• Request Permissions: Aparece quando sua conta não tem acesso a esta tabela. Clique para ir ao Security Center e enviar uma solicitação de permissão.

• Add to Album: Adiciona a tabela atual a um álbum de dados. Se a tabela já estiver em um álbum, o botão torna-se um acesso para visualizar os álbuns dos quais ela faz parte.

• Favorite/Unfavorite: Adiciona a tabela atual aos Meus Favoritos ou a remove dos favoritos.

• API Generation: Publica a capacidade de consulta da tabela como uma API do DataService. Disponível para tipos de source de dados suportados (como MaxCompute, Hologres, AnalyticDB, PostgreSQL, MySQL, SQLServer, Oracle, OTS, SelectDB, MongoDB); não suportado para tabelas em projetos lakehouse.

• DataAnalysis: Abre o Data Analysis com uma nova página de consulta criada automaticamente para a tabela. Suportado para tipos de source de dados como MaxCompute (não-lakehouse) e DLF de cloud pública.

• AI Enhancement: Utiliza o Copilot para gerar ou atualizar as notas da tabela. Durante a execução, o botão é exibido como Generating. Requer a permissão de aprimoramento por IA e a disponibilidade do Copilot para o seu tenant.

• Refresh Metadata: Aciona manualmente a sincronização de metadados da tabela, equivalente à ação de tabela única em My Data > My Tools > Refresh Table Metadata. Disponível apenas para sources de dados como MaxCompute, E-MapReduce e DLF de cloud pública em projetos não-lakehouse.

A seção Table Basic Information no lado esquerdo da página de detalhes da tabela exibe o número de Views, Number of Reads e Number of Favorites.

• Views: Quantidade de vezes que a página de detalhes da tabela foi visualizada no Data Map nos últimos 30 dias. A coleta desses dados ocorre offline e apresenta um atraso de T+1.

• Number of Reads: Número de tarefas que leram a tabela do MaxCompute no ambiente de produção nos últimos 30 dias. As tarefas de leitura incluem SQL, Tunnel Download, Data Integration e chamadas de API do DataService Studio. Atualmente, apenas leituras provenientes de tarefas agendadas do DataWorks são contabilizadas. A coleta desses dados ocorre offline e apresenta um atraso de T+1.

• Number of Favorites: Quantidade de usuários que adicionaram a tabela aos favoritos. Esses dados são coletados em tempo quase real.

• Output Nodes: ID do nó do DataWorks acionado automaticamente que grava na tabela atual. Se a tabela for atualizada periodicamente, mas nenhum ID de nó for exibido, um nó agendado fora do DataWorks pode estar gravando nela. Entre em contato com o proprietário da tabela para obter detalhes. A coleta desses dados ocorre offline e apresenta um atraso de T+1.

  Nota

  Se você não tiver permissão para visualizar o código do nó de saída, entre em contato com o administrador do workspace onde o nó está localizado para conceder as permissões necessárias. Para mais informações, consulte Ativar isolamento de código e log para segurança.

• Storage Capacity: Tamanho de armazenamento lógico da tabela. A coleta desses dados ocorre offline e apresenta um atraso de T+1.

• Health Status: Exibe a classificação da Governance Health Score da tabela, encontrada em Data Health > Data Asset Governance. Essa pontuação ajuda a determinar se a tabela requer governança.

• Descrição da tabela: A descrição da tabela, que o Copilot pode gerar automaticamente.

Se um administrador tiver configurado atributos personalizados para entidades do tipo tabela, um cartão Custom Attributes aparecerá na parte inferior do painel esquerdo de informações básicas, mostrando os valores atuais dos atributos configurados. Atributos personalizados podem ser herdados do workspace; para mais informações, consulte Atributos personalizados.

Clique em Details para visualizar as Field Information, a Partition Key Column e os Change Records da tabela:

• Field Information

  Visualize as informações de campo de uma tabela. Se a tabela for particionada, visualize também seus Partition Fields.

  Actions	Description
  Edit	Clique para editar a Description, a Business Description, o Security Level e a Primary Key do campo. Use o Copilot para gerar descrições de campos automaticamente. Nota Apenas um Workspace Administrator ou o proprietário da tabela pode editar os campos da tabela. Para conceder essa permissão a outros usuários, atribua a eles a função de Workspace Administrator. Para mais informações, consulte Gerenciar permissões para services globais. A coluna Security Level é exibida apenas para tabelas nas quais níveis de segurança foram definidos para campos individuais. Defina o nível de segurança para campos de tabela apenas após ativar o recurso de nível de segurança de campo para o mecanismo MaxCompute. Para obter informações sobre como ativar esse recurso, consulte Controle de acesso baseado em rótulos.
  Recommended Field Desc	Gera descrições para vários campos que ainda não as possuem.
  Batch Edit Security Level	Define o nível de segurança para vários campos da tabela simultaneamente, aumentando a segurança dos dados.
  Upload	Clique neste botão e arraste o arquivo local que deseja carregar para a caixa de diálogo Batch Upload Field Information. Nota Apenas um Workspace Administrator ou o proprietário da tabela pode carregar dados na tabela alvo. Para permitir que outros usuários carreguem dados, conceda a eles a função de Workspace Administrator. Para mais informações, consulte Gerenciar permissões para services globais. Somente arquivos .xlsx (formato Excel 2007) são suportados. Clique em Download Template File para baixar o modelo. Este recurso não oferece suporte a tabelas de modelo criadas no Data Modeling.
  Download	Clique para baixar as informações de campo da tabela atual.
  Generate SELECT	Clique para visualizar ou Copy a instrução select da tabela atual na caixa de diálogo Generate SELECT Statement.
  Generate DDL	Clique para visualizar ou Copy a instrução de criação da tabela na caixa de diálogo Generate DDL Statement.

  Nota

  • Frequência de acesso ao campo: Mostra quantas vezes o campo foi usado em uma cláusula JOIN no SQL no dia anterior. O número é convertido em uma classificação por estrelas, com no máximo 5 estrelas e no mínimo 0 estrelas.

  • Métrica associada: Exibe as métricas de modelo associadas ao campo. Para criar ou atualizar a associação, vá para Dimensional Modeling, use o gerenciamento de campos na página de edição da tabela alvo para manter a associação campo-métrica e, em seguida, publique a tabela de modelo para aplicar as alterações.

• Partition Information

  Visualize o Partition Name, o Number of Records, a Storage Capacity e outras informações da partição.

  Nota

  • O número de registros e o tamanho de armazenamento de uma partição servem apenas como referência. Atualizações de dados podem sofrer atrasos. Os dados no mecanismo de computação são a fonte da verdade.

  • Para tabelas transacionais do MaxCompute, o Number of Records não está disponível e é sempre exibido como -1. O resultado do comando SELECT COUNT(*) FROM <table_name> WHERE <partition>; representa o valor preciso.

• Registros de alterações

  Consulte a Description, o Change Type, a Granularity e outros registros de alterações da tabela.

  No canto superior esquerdo da aba Change Records, selecione um tipo de alteração na lista suspensa para visualizar seus registros específicos.

As informações de linhagem mostram as relações entre tabelas e campos, derivadas do fluxo real de dados em operações como agendamento de tarefas e sincronização de dados. Nesta página, visualize nós upstream e downstream de tabelas ou campos, rastreie sources de dados originais e veja os destinos finais. Também é possível realizar análises de impacto em diferentes níveis de linhagem.

• View Table Lineage

  

  Na aba Table Lineage, visualize os detalhes da linhagem da tabela atual. Execute as seguintes operações:

  • Veja o número de nós upstream e downstream para cada nó na linhagem. Passe o mouse sobre uma tabela ou tipo de nó para ver suas informações básicas.

  • Clique em um nó. No painel pop-up em Lineage Association, insira uma palavra-chave para exibir todos os nós downstream que contêm essa palavra-chave. Insira @Username para exibir todas as tabelas downstream pertencentes ao usuário especificado.

  • Utilize os ícones + ou - no gráfico de linhagem para expandir ou recolher os nós upstream e downstream correspondentes.

• View Field Lineage

  

  Na aba Field Lineage, visualize os detalhes da linhagem de um campo alvo. Execute as seguintes operações:

  • Use a área Change Field para alternar entre os campos da tabela atual e visualizar o gráfico de linhagem de campo correspondente.

  • Veja o número de nós upstream e downstream para cada nó na linhagem de campo. Passe o mouse sobre um campo ou tipo de nó para ver suas informações básicas.

  • Utilize os ícones + ou - no gráfico de linhagem para expandir ou recolher os nós upstream e downstream correspondentes.

• Impact Analysis

  Se a estrutura ou os dados de uma tabela mudarem, seus nós downstream serão afetados. Use a Impact Analysis para identificar quais tabelas downstream serão impactadas por uma alteração. Nesta página, filtre por nível de linhagem, tipo de nó e tipo de tabela para exibir as tabelas downstream relevantes e baixe os resultados da análise.

  Nota

  A análise de impacto suporta até 50 níveis de linhagem de tabela.

Visualize os detalhes de governança de dados e o status de qualidade de dados de uma tabela.

• Os detalhes de governança de dados mostram a pontuação de integridade de governança da tabela, a tendência de problemas de governança e detalhes dos problemas. Trate diretamente os problemas de governança.

  • Health Score: Uma avaliação quantitativa da integridade da tabela em cinco domínios: armazenamento, computação, desenvolvimento, qualidade e segurança. Uma pontuação mais alta indica melhor governança.

  • Trend of to-Be-Governed Issues: Mostra a tendência de problemas de governança não resolvidos ao longo do tempo, ajudando você a entender o histórico de governança da tabela.

  • Governance Issue: Lista os problemas atuais que requerem governança. Clique no nome de um problema na coluna Governance Issue ou no botão de ação na coluna Actions para ir até Data Asset Governance > Overview > To-Do List e tratar problemas de governança.

• Os detalhes de qualidade de dados mostram as regras de monitoramento da tabela e quaisquer alertas de qualidade de dados resultantes.

Esta seção exibe os Usage Records da tabela, organizados em Frequently Associated e Access Statistics.

• Frequently Associated: Mostra a frequência com que a tabela é usada em operações de junção (join).

  Nota

  Esta estatística conta o número de vezes que a tabela foi usada como condição de junção nos últimos 30 dias. A coleta desses dados ocorre offline e apresenta um atraso de T+1.

• Access Statistics: Exibe os registros de uso da tabela em formato de gráfico.

  • Trend for Reads: A data no gráfico de linhas corresponde ao número de leituras naquele dia, distinguindo entre leituras dos ambientes de desenvolvimento e produção. O número de associações de campo está relacionado ao número de execuções de nó e ao número de vezes que o campo aparece no código. A coleta desses dados ocorre offline e apresenta um atraso de T+1.

    Por exemplo, se um campo aparece uma vez em um nó e o nó é executado duas vezes, a contagem é dois. Se um campo aparece duas vezes no código, uma única execução do nó resulta em uma contagem de dois.

  • Field Popularity Details: Estatísticas sobre o número de vezes que um campo é usado em cláusulas SQL (como WHERE, SELECT, JOIN e GROUP BY). A coleta desses dados ocorre offline e apresenta um atraso de T+1.

  • Top 10 Readers: Estatísticas sobre usuários que leram a tabela em SQL nos últimos 30 dias. Isso inclui acessos tanto de contas de produção para agendamento quanto de contas pessoais. As operações de leitura incluem WHERE, SELECT, JOIN e GROUP BY. A coleta desses dados ocorre offline e apresenta um atraso de T+1.

O Data Preview mostra detalhes da tabela e 20 registros de dados aleatórios. Visualize e analise a tabela em uma pasta de trabalho ou usando uma consulta SQL.

• Preview in Workbook: Na página Data Preview, clique em Preview in Workbook. Você será redirecionado para DataAnalysis > Spreadsheet, e o sistema criará automaticamente uma nova pasta de trabalho para exibir os dados da tabela selecionada.

• Análise de dados: Na página Data Preview, clique em DataAnalysis. Você será redirecionado para DataAnalysis > SQL Query, e o sistema criará automaticamente um arquivo SQL Query (Legacy) preenchido com uma consulta para a tabela selecionada.

  Após consultar a tabela no SQL Query, execute o Data Insight nos resultados e gere uma pasta de trabalho, cartões e relatórios ou outros itens.

O Data Insight analisa a estrutura e os valores dos seus dados para exibir estatísticas e distribuição. Crie um novo relatório do Data Insight diretamente na página atual ou vá ao módulo Data Analysis para usar o Data Insight.

Na aba Output, visualize as tarefas agendadas do DataWorks que produzem a tabela atual. Isso ajuda a rastrear a source de dados e as execuções mais recentes.

A lista inclui o Node ID, Node name, Owner, Schedule e Latest status da tarefa. Clique em um ID de nó para ir à página de detalhes do nó no Operation Center, onde você pode inspecionar instâncias de tarefas, configuração de agendamento e logs de execução.

Na aba Usage Notes, visualize ou mantenha notas de uso para a tabela, ajudando usuários downstream a entender seu significado de negócios, descrições de colunas e ressalvas de uso.

• Ler as notas: Por padrão, as notas atuais são exibidas no modo de leitura.

• Editar as notas: Clique em Edit para entrar no modo de edição. Dependendo da configuração do seu tenant, o editor pode ser o editor Yuque (rich text mais edição colaborativa) ou o editor integrado do DataWorks.

• Gerar notas com IA: Clique no botão AI Enhancement no cabeçalho da página ou use a entrada dentro da aba Usage Notes para permitir que o Copilot analise os metadados da tabela e produza um rascunho, que você pode revisar e salvar.

Quando a tabela atual possui associações entre catálogos (por exemplo, cenários de StarRocks External Catalog), a página de detalhes da tabela mostra uma aba Association Information que lista outros catálogos relacionados à tabela.

• Visualizar catálogos relacionados: Inspecione os nomes dos catálogos relacionados e o cluster ao qual pertencem, para entender as relações entre catálogos da tabela.

• Ir para pesquisar os ativos relacionados: Clique em um link para ir à página de pesquisa de metadados com o catálogo relacionado pré-filtrado, permitindo localizar rapidamente tabelas relacionadas.