A 15 de setembro de 2026, todos os ambientes do Cloud Composer 1 e do Cloud Composer 2 versão 2.0.x vão atingir o fim da vida útil planeado e não vai poder usá-los. Recomendamos que planeie a migração para o Cloud Composer 3.
Siga as instruções nesta página para ativar ou desativar a serialização de DAGs.
Num ambiente do Cloud Composer, o programador do Airflow e o servidor Web do Airflow processam continuamente DAGs. Pode melhorar a fiabilidade e o desempenho do servidor Web do Airflow ativando a serialização de DAGs.
A ativação da serialização de DAG força o programador a processar ficheiros DAG antes de serem enviados para o servidor Web. O servidor Web não processa DAGs.
Em vez disso, lê os DAGs serializados da base de dados do Airflow. A serialização de DAGs desta forma reduz a utilização da CPU e da memória do servidor Web, especialmente quando processa um grande número de DAGs.
Antes de começar
A serialização de DAGs afeta as seguintes funcionalidades do Cloud Composer:
A ativação da serialização de DAGs desativa todos os plug-ins do servidor Web do Airflow para o Cloud Composer. Isto não afeta os plug-ins do programador nem do trabalhador,
incluindo operadores, sensores, etc. do Airflow.
Ativar a serialização de DAGs
Pode ativar a serialização de DAGs para um ambiente existente ou quando criar um novo ambiente.
Para ativar a serialização de DAGs,
substitua as seguintes opções de configuração do Airflow:
Secçã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 do min_serialized_dag_update_interval
Airflow controla a frequência com que os DAGs serializados
são atualizados na base de dados.
A opção dag_dir_list_interval
controla a frequência com que os DAGs removidos são eliminados da base de dados do Airflow. Uma frequência de atualização elevada pode afetar negativamente o desempenho. Recomendamos que defina min_serialized_dag_update_interval e dag_dir_list_interval para 30 segundos.
Desativar a serialização de DAG
Pode ativar a serialização de DAGs para um ambiente existente ou quando criar um novo ambiente.
Para desativar a serialização de DAGs, 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,["\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 **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\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\n| Section | Key | Value |\n|-------------|--------------------------------------|--------|\n| `core` | `store_serialized_dags` | `True` |\n| `core` | `store_dag_code` | `True` |\n| `core` | `min_serialized_dag_update_interval` | `30` |\n| `scheduler` | `dag_dir_list_interval` | `30` |\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\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:\n\n| Section | Key | Value |\n|---------|-------------------------|---------|\n| `core` | `store_serialized_dags` | `False` |\n| `core` | `store_dag_code` | `False` |"]]
