Em 15 de setembro de 2026, todos os ambientes do Cloud Composer 1 e da versão 2.0.x do Cloud Composer 2 vão atingir o fim da vida útil planejado e não poderão mais ser usados. Recomendamos planejar a migração para o Cloud Composer 3.
Siga as instruções nesta página para ativar ou desativar a serialização do DAG.
Em um ambiente do Cloud Composer, o programador do Airflow e
o servidor da Web do Airflow processam continuamente os DAGs. É possível melhorar
a confiabilidade e o desempenho do servidor da Web do Airflow ativando a
serialização de DAG.
A ativação da serialização do DAG força o programador a processar arquivos DAG
antes de serem enviados para o servidor da Web. O servidor da Web não processa DAGs.
Em vez disso, ele lê os DAGs serializados do banco de dados do Airflow. A serialização
de DAGs dessa maneira reduz o uso de CPU e de memória pelo servidor da Web,
especialmente ao processar um grande número de DAGs.
Antes de começar
A serialização de DAG afeta os seguintes recursos do Cloud Composer:
Ativar a serialização do DAG desativa todos os plug-ins de servidor da Web do Airflow para o
Cloud Composer. Isso não afeta os plug-ins do programador ou do worker,
incluindo os operadores do Airflow, sensores e assim por diante.
Como ativar a serialização do DAG
É possível ativar a serialização de DAG para um ambiente atual ou ao criar um
novo ambiente.
Para ativar a serialização de DAG,
substitua as seguintes opções de configuração do Airflow:
Seção
Chave
Valor
core
store_serialized_dags
True
core
store_dag_code
True
core
min_serialized_dag_update_interval
30
scheduler
dag_dir_list_interval
30
A opção de configuração min_serialized_dag_update_interval
do Airflow controla com que frequência os DAGs serializados
são atualizados no banco de dados.
A opção dag_dir_list_interval
controla a frequência com que os DAGs removidos são excluídos do banco de dados
do Airflow. Uma alta frequência de atualização pode afetar negativamente o desempenho. Recomendamos
definir min_serialized_dag_update_interval e
dag_dir_list_interval como 30 segundos.
Como desativar a serialização do DAG
É possível ativar a serialização do DAG para um ambiente atual ou ao criar
um novo ambiente.
Para desativar a serialização de DAG, substitua as seguintes opções de configuração do
Airflow:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-29 UTC."],[[["\u003cp\u003eDAG serialization in Cloud Composer improves the reliability and performance of the Airflow web server by having the scheduler process DAG files before they are sent, reducing the web server's CPU and memory usage.\u003c/p\u003e\n"],["\u003cp\u003eStarting with Cloud Composer version 1.15.0, DAG serialization is enabled by default, and it can be managed by overriding Airflow configuration options in both new and existing environments.\u003c/p\u003e\n"],["\u003cp\u003eEnabling DAG serialization requires setting the \u003ccode\u003estore_serialized_dags\u003c/code\u003e and \u003ccode\u003estore_dag_code\u003c/code\u003e Airflow configuration options to \u003ccode\u003eTrue\u003c/code\u003e, along with recommended settings of \u003ccode\u003e30\u003c/code\u003e for both \u003ccode\u003emin_serialized_dag_update_interval\u003c/code\u003e and \u003ccode\u003edag_dir_list_interval\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDisabling DAG serialization involves overriding the \u003ccode\u003estore_serialized_dags\u003c/code\u003e and \u003ccode\u003estore_dag_code\u003c/code\u003e Airflow configuration options and setting them to \u003ccode\u003eFalse\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDAG serialization is incompatible with asynchronous DAG loading and will disable all Airflow web server plugins, although scheduler and worker plugins remain unaffected.\u003c/p\u003e\n"]]],[],null,["# Enabling and disabling DAG serialization\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\nCloud Composer 3 \\| Cloud Composer 2 \\| **Cloud Composer 1**\n\n\u003cbr /\u003e\n\nFollow the instructions on this page to enable or disable DAG serialization.\n\nIn a Cloud Composer environment, both the Airflow scheduler and\nthe Airflow web server continuously process DAGs. You can improve\nthe reliability and performance of the Airflow web server by enabling\n[DAG serialization](https://airflow.apache.org/docs/apache-airflow/stable/dag-serialization.html).\n\nEnabling DAG serialization forces the scheduler to process DAG files\nbefore they are sent to the web server. The web server does not process DAGs.\nInstead, it reads the serialized DAGs from the Airflow database. Serializing\nDAGs in this way reduces the CPU and memory usage of the web server,\nespecially when processing a large number of DAGs.\n\nBefore you begin\n----------------\n\n| **Note:** Starting from Cloud Composer version **1.15.0** , DAG serialization is enabled by default. You can enable and disable DAG serialization in new and existing environments by [overriding Airflow configuration options](/composer/docs/composer-2/override-airflow-configurations), as described in the following sections.\n\nDAG serialization affects the following Cloud Composer features:\n\n- DAG serialization cannot be enabled at the same time as [asynchronous DAG loading](/composer/docs/composer-2/access-airflow-web-interface#asynchronous-load).\n- Enabling DAG serialization disables all Airflow web server plugins for Cloud Composer. This does not impact scheduler or worker plugins, including Airflow operators, sensors, and so on.\n\nEnabling DAG serialization\n--------------------------\n\nYou can enable DAG serialization for an existing environment or when creating a\nnew environment.\n| **Note:** Do not apply these settings to environments running Airflow 2.x. The DAG serialization and storing DAG code in Airflow Metadata Database is by default turned on in Airflow 2.x and you cannot switch it on or off.\n\nTo enable DAG serialization,\n[override](/composer/docs/composer-2/override-airflow-configurations) the following Airflow configuration options:\n\nThe [`min_serialized_dag_update_interval`](https://airflow.apache.org/docs/stable/configurations-ref.html#min-serialized-dag-update-interval)\nAirflow configuration option controls how frequently serialized DAGs\nare updated in the database.\nThe [`dag_dir_list_interval`](https://airflow.apache.org/docs/stable/configurations-ref.html#dag-dir-list-interval)\noption controls how frequently removed DAGs are deleted from the Airflow\ndatabase. A high update frequency can negatively impact performance. We\nrecommend setting `min_serialized_dag_update_interval` and\n`dag_dir_list_interval` to 30 seconds.\n\nDisabling DAG serialization\n---------------------------\n\nYou can enable DAG serialization for an existing environment or when creating\na new environment.\n\nTo disable DAG serialization, [override](/composer/docs/composer-2/override-airflow-configurations) the following Airflow\nconfiguration options:"]]
