Um pacote semântico (SemanticSpec) mantém centralmente o significado de negócios dos dados do MaxCompute ao associar tabelas, campos, métricas e regras de análise. Os proprietários dos dados podem gerar sugestões, edite definições de negócios e publicá-las para reutilização pelo DataAgent ou por outros agentes. Este tópico descreve o conteúdo principal, as relações entre versões, os requisitos de ativação e as permissões de uso dos pacotes semânticos.
O que é um pacote semântico
Um pacote semântico consiste em descrições de dados e regras de análise organizadas por tópico de negócios. Por exemplo, uma tabela de pedidos registra o valor do pagamento e o status do pedido. O pacote semântico detalha ainda a unidade do valor, a base temporal para estatísticas, o tratamento de reembolsos e a deduplicação de múltiplos snapshots do mesmo pedido. Essas descrições ajudam agentes como o DataAgent a compreender perguntas de negócios e gerar SQL. Proprietários de dados com conhecimento do negócio devem confirmar as definições de negócios específicas.
Um pacote semântico pode referenciar até 20 tabelas do MaxCompute. É possível adicionar definições de negócios dentro do escopo das tabelas selecionadas e gerencie alterações subsequentes por meio de rascunhos e versões publicadas. O pacote semântico armazena apenas referências de tabelas e definições de negócios, e não copia nem modifique os dados de negócios subjacentes.
Componentes de um pacote semântico
Estruturalmente, um pacote semântico contém informações básicas como nome, descrição, tags e escopo de dados, e organiza as definições de negócios nas sete seções de conteúdo a seguir. Preencha primeiro as seções necessárias para a análise atual e refine-as ao longo do tempo. O modelo semântico também inclui tabelas lógicas, dimensões e relacionamentos entre tabelas.
|
Seção de conteúdo |
Finalidade |
|
Data References |
Especifica os projetos e as tabelas utilizados pelo pacote semântico. |
|
Semantic Model |
Organiza tabelas e campos em tabelas lógicas, dimensões, dimensões de tempo, condições de filtro e relacionamentos confirmados. |
|
Instructions |
Registra regras de uso de SQL, métodos de deduplicação, definições de tempo, condições de filtro padrão e regras de negócios. |
|
Metric Definitions |
Descreve o cálculo das métricas, incluindo expressões, métodos de agregação, granularidade estatística e condições aplicáveis. |
|
Verified Queries |
Armazena perguntas típicas verificadas e suas respectivas consultas SQL para consulta em análises subsequentes. |
|
Business Glossary |
Explica termos de negócios, seus aliases e o mapeamento para métricas ou dimensões. |
|
Perguntas de teste |
Armazena perguntas e resultados esperados usados para verificar o conteúdo semântico. Atualmente, o console exibe esta seção como Benchmark Set. |
Por exemplo, descreva o relacionamento entre pedidos e canais no Semantic Model, registre a regra de deduplicação de snapshots de pedidos e a regra de reembolso nas Instructions e mantenha a definição do valor de pagamento nas Metric Definitions. Os esquemas das tabelas, as definições de negócios e os exemplos de verificação se complementam, o que reduz a necessidade de explicar repetidamente as mesmas regras durante a análise.
Manter e publicar um pacote semântico
O console exibe separadamente os quatro tipos de conteúdo a seguir:
|
Guia do console |
Finalidade |
|
Smart Suggestions |
Armazena as sugestões do sistema geradas pelo DataScan (o service de varredura de dados do MaxCompute) para revisão pelos mantenedores. |
|
Work Draft |
Armazena o conteúdo editado manualmente e as sugestões aplicadas, utilizados para refinar e verificar as definições de negócios. |
|
Current Release |
Exibe a versão publicada para leitura pelo DataAgent ou por outras aplicações. |
|
Release History |
Registra o histórico de publicações. |
Para manter um pacote semântico, o fluxo de trabalho típico é gerar e revisar sugestões do sistema, aplicar o conteúdo necessário ao rascunho de trabalho e, em seguida, adicionar regras de negócios. Após verificar as definições de negócios, o SQL e os resultados das consultas, e validar as consultas de referência geradas automaticamente em relação ao negócio, publique o rascunho para uso pelo DataAgent ou por outros agentes.
Aplicar sugestões do sistema substitui a seção de conteúdo selecionada como um todo. Se a seção já contiver definições manuais, salve separadamente o conteúdo a ser mantido. Após aplicar as sugestões, revise e conclua o rascunho antes de publicá-lo.
Gerar sugestões e salvar rascunhos não afetam a versão publicada. Quando as definições de negócios mudarem, edite o rascunho e publique-o novamente. Cada versão publicada possui seu próprio número de revisão, o que permite rastrear as definições de negócios que embasaram uma análise. Uma versão publicada fixa apenas as definições de negócios. Portanto, para reproduzir resultados históricos de consultas, verifique também se houve alterações no SQL, no horário da consulta, no escopo dos dados e nos dados de source.
Pré-requisitos
Ative o MaxAgent antes de usar o recurso de pacote semântico. Para obter mais informações sobre como ativar o MaxAgent, consulte MaxAgent. Após a ativação, configure as permissões de gerenciamento do pacote semântico e as permissões de acesso aos dados conforme descrito nas seções a seguir.
Configure permissões
Antes de usar os pacotes semânticos, confirme as permissões de gerenciamento do pacote semântico e as permissões de dados necessárias para a varredura e a análise.
Configure permissões de gerenciamento do pacote semântico
Para controlar as permissões por membro, recurso e operação, use as funções e políticas da CatalogAPI (a API de gerenciamento do catálogo de dados do MaxCompute) para uma autorização detalhada. Para obter mais informações sobre os recursos de integração e autorização, consulte CatalogAPI SDK User Guide.
Para conceder rapidamente permissões de gerenciamento aos mantenedores, um usuário com essas permissões pode adicionar um administrador admin no console. Este método concede permissões com base na função de administrador e abrange um escopo amplo. Selecione o escopo de acordo com as responsabilidades de manutenção de cada membro.
Procedimento:
Faça logon no MaxCompute console e selecione uma região no canto superior esquerdo.
No painel de navegação à esquerda, escolha . Na guia Tenant Property, clique em Add Members na seção de administrador de permissões IAM do MaxCompute.
Na caixa de diálogo Add Member, verifique o escopo de autorização e defina a opção como admin no nível do tenant.
Pesquise ou adicione manualmente os membros a serem autorizados e clique em OK.
Na lista de membros, verifique se o escopo de autorização está conforme o esperado.
Configure permissões de dados para varredura e análise
Para melhorar a eficácia e a qualidade das varreduras semânticas, garanta que a identidade de varredura tenha permissões de acesso às tabelas de dados correspondentes e ao Information Schema no nível do tenant. O Information Schema fornece metadados e histórico de uso, servindo de referência para analisar esquemas de tabelas, relacionamentos e padrões de uso. As permissões nas tabelas de dados correspondentes permitem a leitura das informações da tabela e dos dados necessários para a varredura.
Confirme separadamente a autorização do administrador admin e as permissões de acesso às tabelas de dados e ao Information Schema. A adição bem-sucedida de um administrador não significa que toda a autorização de dados esteja concluída. Gerar sugestões e execute análises também exigem permissões no projeto e permissões para execute os jobs correspondentes.
Para obter mais informações sobre a autorização do Information Schema, consulte Tenant-level Information Schema: RAM user authorization.
Para obter mais informações sobre as permissões de projeto e de tabela, consulte Permissions overview e Authorization operations.
Próximos passos
Para entender como o DataAgent trabalha com pacotes semânticos, consulte DataAgent.
Para crie, manter e usar um pacote semântico passo a passo, com capturas de tela, consulte Manage and use semantic packages in the console.
Para conectar um agente personalizado, consulte MaxCompute MCP service guide.