DataWorks:Publish a model

Limites

Antes de publicar um modelo, atenda às seguintes condições:

• Engine de destino: É possível publicar nos engines MaxCompute, EMR Hive, CDH Hive, Hologres, MySQL, StarRocks, DLF e Lindorm.

• Tipo de publicação:

  • Para publicação como view ou materialized view, o engine de destino suporta apenas MaxCompute.

  • Na publicação como materialized view, o modo de publicação aceita somente Drop and recreate.

• Ambiente:

  • Em um workspace no modo básico, a publicação é permitida apenas no ambiente de produção.

  • Em um workspace no modo padrão, você pode publicar no ambiente de desenvolvimento ou de produção.

• Grupo de recursos:

  • Se o engine de destino for EMR Hive ou CDH, especifique um grupo de recursos de agendamento exclusivo ou um grupo de recursos Serverless para executar a tarefa de publicação.

Publicar e materializar o modelo

É possível publicar e materializar tabelas de dimensão, fato, agregação e aplicação diretamente em uma instância de fonte de dados criada, viabilizando o desenvolvimento e a análise posteriores em um engine de computação. Atualmente, a publicação e materialização diretas suportam MaxCompute, EMR Hive, CDH Hive, Hologres, MySQL, StarRocks, DLF e Lindorm.

1. Publique o modelo.

   Após criar o modelo, clique em na barra de ferramentas superior da página de detalhes da tabela. Na caixa de diálogo Publish, configure os principais parâmetros listados abaixo. Nessa mesma caixa, defina também o Data source name selecionando uma instância de fonte de dados e preencha os Publication remarks com uma descrição desta publicação.

   Parâmetro	Descrição
   Publish Type	Especifique como o modelo será materializado. Tabela física: Crie uma tabela física no engine de destino. View: Crie uma view no engine de destino. Esta opção suporta apenas o tipo de fonte de dados MaxCompute. Materialized view: Crie uma materialized view no engine de destino. Esta opção suporta apenas o tipo de fonte de dados MaxCompute. Uma materialized view pré-computa e armazena resultados de operações demoradas, como JOIN e AGGREGATE, permitindo que as consultas os reutilizem para maior performance. Para mais informações, consulte Materialized view operations.
   Data Source Type	Selecione o engine usado para armazenar os dados. As opções disponíveis são: MaxCompute, EMR Hive, CDH Hive, Hologres, MySQL, StarRocks, DLF e Lindorm.
   Effective Environment	Você pode publicar no ambiente de Development ou de Production. Se o seu workspace do DataWorks estiver no modo básico, a publicação de tabelas será restrita ao ambiente de produção. Caso o workspace esteja no modo padrão, as tabelas podem ser publicadas tanto no ambiente de produção quanto no de desenvolvimento.
   Publish Mode	Define como as alterações no modelo são aplicadas ao engine de destino. Incremental Publish: Atualize apenas as mudanças do modelo atual no engine de destino. Recomendado para modelos já publicados, pois preserva dados históricos e reduz o impacto nas cargas de trabalho de produção. Delete and Recreate: Exclui um modelo existente com o mesmo nome no engine de destino e o recria em seguida.Aviso: Esta operação descarta e recria a tabela, resultando na perda de dados históricos. Ambos os modos produzem o mesmo efeito na primeira publicação.
   Automatic Rule Generation Based on Field Standard	Indique se regras de qualidade devem ser geradas automaticamente após a publicação do modelo. Para mais detalhes, consulte Data labeling. Sim: Após uma publicação bem-sucedida em produção, gera automaticamente regras de qualidade para chaves primárias, campos não nulos e campos associados a códigos padrão. Não: Não gera regras de qualidade automaticamente.
   Resource Group	Ao materializar uma tabela de modelo como tabela física no E-MapReduce ou CDH, um grupo de recursos é obrigatório. Certifique-se de que o grupo selecionado possua network connectivity with the data source.. Nota A publicação de tabela física E-MapReduce ou CDH suporta exclusivamente grupos de recursos de agendamento exclusivos. Caso não tenha um grupo adequado, consulte Use exclusive resource groups for scheduling para criar um.
   DDL	O DataWorks gera automaticamente a instrução SQL para publicar o modelo configurado como uma materialized view. Como a publicação só é concluída se a instrução SELECT for executada com êxito, altere manualmente a cláusula AS SELECT para um SQL executável. Nota Configure este parâmetro apenas ao publicar o modelo como Materialized View. Para operações DDL de materialized view, consulte Materialized view operations.

2. Após definir as configurações, clique em Publish. O sistema publica o modelo no ambiente correspondente de Development ou Production e o materializa no engine selecionado.

   • Acompanhe o progresso da publicação atual e os logs na caixa de diálogo Publish.

   • Repita a operação de publicação para implantar o modelo em ambientes diferentes.

3. Opcional: Após a publicação, clique em na barra de ferramentas superior da página de detalhes da tabela para visualizar o resultado e os detalhes da última publicação.

   O campo Publishing Status apresenta três estados possíveis: Succeeded, Failed e Deploying. Os logs de status Succeeded estão ilustrados na figura a seguir.

   2025-12-22 13:56:44 INFO – success to submit task to execute script, requestId is 480ead48371568e2ad85dc6ce3b68e60, taskCode is xxx
   2025-12-22 13:56:47 INFO – success to execute script: CREATE TABLE IF NOT EXISTS own_yunwan.dim_ec_pub_region_df
   (
       id          STRING COMMENT 'Administrative region ID',
       name        STRING COMMENT 'Administrative region name',
       level       INT COMMENT 'Administrative region level: 1 country; 2 province, autonomous region, or municipality; 3 city; 4 district or county',
       country_id  STRING COMMENT 'Country ID',
       country_name STRING COMMENT 'Country name',
       province_id STRING COMMENT 'Province, autonomous region, or municipality ID',
       province_name STRING COMMENT 'Province, autonomous region, or municipality name',
       city_id     STRING COMMENT 'City ID',
       city_name   STRING COMMENT 'City name',
       district_id STRING COMMENT 'District or county ID',
       district_name STRING COMMENT 'District or county name',
       ds          STRING COMMENT 'Business date, yyyymmdd'
   )
   COMMENT 'Geographic administrative region dimension table'
   LIFECYCLE 1000
   2025-12-22 13:56:47 INFO – finish and success to execute all script
   2025-12-22 13:56:50 INFO – end and success to deploy job

   Nota

   • Se o Publishing Status for Failed, identifique e resolva a causa prontamente com base na mensagem de erro específica.

   • Quando a caixa de diálogo Publishing Logs exibir No publishing logs found., significa que o modelo nunca foi publicado.

4. Visualize o histórico de publicações.

   Depois que um modelo for publicado, abra seu editor e clique em Publishing Record no painel de navegação à direita para ver as versões históricas publicadas. No painel Publication History, é possível consultar o histórico do modelo dim_ec_pub_region_df, incluindo horário da publicação, responsável, versão do modelo e ambiente ativo. O registro atual indica que a versão V1 do modelo foi publicada no ambiente de desenvolvimento.

Gerar um framework de código ETL (desenvolvimento de modelo)

No Modelagem Inteligente de Dados do DataWorks, utilize o desenvolvimento de modelo para gerar um framework de código ETL para tabelas de modelo publicadas, como tabelas de dimensão e de fato.

O desenvolvimento de modelo suporta a geração de código apenas para tabelas publicadas nos engines de computação MaxCompute e EMR Hive.

1. Na Modelagem Inteligente de Dados do DataWorks, clique duas vezes em uma tabela de modelo publicada para abrir sua página de detalhes.

2. Clique em Develop Model.

3. Na caixa de diálogo Develop Model, selecione Create DataStudio Node ou Associate DataStudio Node, configure os parâmetros e clique em OK.

   1. Selecione Create DataStudio Node

      O sistema cria automaticamente um nó do DataStudio e preenche seu nome com base no nome da tabela. Na caixa de diálogo Desenvolvimento de Modelo, configure o Destination workspace, o Node type (como ODPS SQL) e o Node name.

      • Se a tabela de modelo foi publicada no MaxCompute, um nó ODPS SQL será criado.

      • Caso a publicação tenha sido feita no EMR Hive, um nó EMR Hive será criado.

      Após confirmar as configurações, clique em Go to DataStudio. Uma caixa de diálogo aparecerá no Desenvolvimento de Dados para a criação do nó. Clique em OK para criar o nó e gerar o código ETL.

   2. Selecione Associate DataStudio Node

      Na caixa de diálogo Desenvolvimento de Modelo, configure o Destination workspace, o Node type (como ODPS SQL) e o Node name (ID) e clique em OK.

      Essa opção associa o framework de código a um nó existente do DataStudio do mesmo tipo de engine. Após a vinculação, clique em no nome do nó para abrir sua página e continuar o desenvolvimento.

Para vincular vários nós à mesma tabela de modelo, clique em Develop Model novamente.

Faturamento

A publicação de um modelo é gratuita. No entanto, os recursos de computação e armazenamento consumidos durante a materialização geram custos:

Custos do engine de destino: Após a materialização, o modelo utiliza recursos de armazenamento e computação no engine de destino, como MaxCompute ou Hologres. As cobranças seguem as regras de faturamento do product relevante.