Le 15 septembre 2026, tous les environnements Cloud Composer 1 et Cloud Composer 2 version 2.0.x atteindront leur fin de vie prévue et vous ne pourrez plus les utiliser. Nous vous recommandons de planifier la migration vers Cloud Composer 3.
Suivez les instructions de cette page pour activer ou désactiver la sérialisation des DAG.
Dans un environnement Cloud Composer, le programmeur Airflow et le serveur Web Airflow traitent les DAG en continu. Vous pouvez améliorer la fiabilité et les performances du serveur Web Airflow en activant la sérialisation des DAG.
L'activation de la sérialisation des DAG oblige le programmeur à traiter les fichiers DAG avant leur envoi au serveur Web. Le serveur Web ne traite pas les DAG.
Au lieu de cela, il lit les DAG sérialisés à partir de la base de données Airflow. La sérialisation réduit l'utilisation du processeur et de la mémoire par le serveur Web, en particulier lors du traitement d'un grand nombre de DAG.
Avant de commencer
La sérialisation des DAG affecte les fonctionnalités Cloud Composer suivantes :
L'activation de la sérialisation des DAG désactive tous les plug-ins du serveur Web Airflow pour Cloud Composer. Cela n'affecte pas les plug-ins du programmeur ou du nœud de calcul, y compris les opérateurs Airflow, les capteurs, etc.
Activer la sérialisation des DAG
Vous pouvez activer la sérialisation des DAG pour un environnement existant ou lors de la création d'un environnement.
Pour activer la sérialisation des DAG, remplacez les options de configuration Airflow suivantes:
Section
Clé
Valeur
core
store_serialized_dags
True
core
store_dag_code
True
core
min_serialized_dag_update_interval
30
scheduler
dag_dir_list_interval
30
L'option de configuration Airflow min_serialized_dag_update_interval contrôle la fréquence de mise à jour des DAG sérialisés dans la base de données.
L'option dag_dir_list_interval contrôle la fréquence à laquelle les DAG supprimés sont supprimés de la base de données Airflow. Une fréquence de mise à jour élevée peut avoir un impact négatif sur les performances. Nous vous recommandons de définir min_serialized_dag_update_interval et dag_dir_list_interval sur 30 secondes.
Désactiver la sérialisation des DAG
Vous pouvez activer la sérialisation des DAG pour un environnement existant ou lors de la création d'un environnement.
Pour désactiver la sérialisation des DAG, remplacez les options de configuration Airflow suivantes:
Section
Clé
Valeur
core
store_serialized_dags
False
core
store_dag_code
False
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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` |"]]
