Configurer les options de base de données d'une instance
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page explique comment ajouter, modifier et supprimer des indicateurs de base de données pour une instance dans un cluster AlloyDB pour PostgreSQL.
Les indicateurs de base de données sont utilisés pour de nombreuses opérations, y compris l'ajustement des paramètres et des options PostgreSQL, ainsi que la configuration et le réglage d'une instance.
Les modifications apportées à la valeur d'un indicateur de base de données persistent pour son instance jusqu'à ce que vous supprimiez l'indicateur ou que vous modifiiez à nouveau sa valeur.
Parfois, définir un indicateur implique d'en définir un autre, afin d'activer complètement la fonctionnalité souhaitée.
Après avoir défini, supprimé ou modifié un indicateur pour une instance de base de données, AlloyDB peut redémarrer l'instance. Cela dépend de l'indicateur, comme indiqué dans Indicateurs de base de données compatibles.
Lorsque vous modifiez un indicateur de base de données dans l'instance principale ou dans une instance de pool de lecture nécessitant un redémarrage, vous pouvez choisir l'une des règles de maintenance suivantes :
Temps d'arrêt réduit : Cette règle est activée par défaut. Nous vous recommandons d'utiliser cette stratégie pour tous vos clusters AlloyDB de production, car elle minimise les temps d'arrêt des applications.
Lorsque la stratégie de faible temps d'arrêt est activée, la mise à jour d'un indicateur nécessitant un redémarrage de l'instance principale de votre cluster a les effets suivants :
L'instance principale connaît un temps d'arrêt de moins d'une seconde pour la plupart des charges de travail.
La mise à jour du nouveau paramètre sur l'instance principale prend environ 15 minutes.
La mise à jour d'un indicateur qui nécessite un redémarrage sur une instance de pool de lecture a les effets suivants :
L'instance de pool de lecture ne nécessite aucun temps d'arrêt.
La mise à jour de l'indicateur sur l'instance du pool de lecture vers sa nouvelle valeur prend environ 10 minutes.
Appliquer de force : Pour appliquer les mises à jour des indicateurs plus rapidement, utilisez l'option FORCE_APPLY avec la commande gcloud beta alloydb instances update.
Cette règle est plus adaptée aux environnements de développement. Elle vous permet d'ajouter ou de modifier rapidement des indicateurs en échange d'un temps d'arrêt plus long de l'instance et d'une diminution temporaire des performances ou du débit de la base de données. Votre cluster retrouve ses performances maximales plusieurs minutes après l'application forcée d'une mise à jour de l'indicateur.
Lorsque l'option "Appliquer la règle de manière forcée" est activée, la mise à jour d'un indicateur nécessitant un redémarrage sur l'instance principale de votre cluster a les effets suivants :
L'instance principale subit environ une minute d'indisponibilité.
La mise à jour de l'indicateur sur l'instance principale prend une à deux minutes.
La mise à jour d'un indicateur qui nécessite un redémarrage sur une instance de pool de lecture a les effets suivants :
L'instance de pool de lecture subit environ une minute de temps d'arrêt.
La mise à jour de l'indicateur sur l'instance de pool de lecture vers sa nouvelle valeur prend une à deux minutes.
Cliquez sur un cluster dans la colonne Nom de la ressource.
Sur la page Présentation, accédez à Instances de votre cluster, sélectionnez une instance, puis cliquez sur Modifier.
Ajoutez, modifiez ou supprimez un indicateur de base de données de votre instance :
Ajouter une option
Pour ajouter une option de base de données à votre instance, cliquez sur Ajouter une option.
Sélectionnez un indicateur dans la liste Nouvel indicateur de base de données.
Indiquez une valeur pour l'option.
Cliquez sur OK.
Modifier un flag
Pour modifier une option de base de données présente dans votre instance, développez-la et modifiez sa valeur dans la section Modifier l'option de base de données.
Cliquez sur OK.
Supprimer un signalement
Pour supprimer un indicateur de base de données de votre instance, sélectionnez-le, puis cliquez sur l'icône Supprimer.
Pour appliquer les mises à jour des indicateurs plus rapidement, incluez l'argument --update-mode=FORCE_APPLY. Étant donné que cela peut réduire temporairement les performances de la base de données, évitez d'utiliser cette option dans un environnement de production.
FLAGS_LIST : liste d'une ou de plusieurs spécifications d'indicateurs de base de données, séparées par une virgule. Chaque spécification se compose du nom de l'indicateur, d'un signe égal (=) et de la valeur à attribuer aux indicateurs. Pour les indicateurs de base de données qui n'acceptent pas de valeurs, indiquez le nom de l'indicateur suivi d'un signe égal (=).
REGION_ID : région où se trouve l'instance (par exemple, us-central1).
CLUSTER_ID : ID du cluster dans lequel l'instance est placée.
PROJECT_ID : ID du projet dans lequel le cluster est placé.
Pour afficher la liste des indicateurs actuellement définis manuellement pour une instance, exécutez la commande suivante :
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/09/04 (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/09/04 (UTC)."],[[["\u003cp\u003eThis guide details how to add, modify, and delete database flags for instances within an AlloyDB for PostgreSQL cluster, which are used for various operational adjustments.\u003c/p\u003e\n"],["\u003cp\u003eDatabase flag modifications persist until removed or changed, and sometimes, setting one flag necessitates setting another for full functionality.\u003c/p\u003e\n"],["\u003cp\u003eApplying flag changes may trigger an instance restart, and users can choose between a "Low downtime" policy (recommended for production) or a "Force apply" policy (for faster updates, but with potential downtime and performance dips).\u003c/p\u003e\n"],["\u003cp\u003eThe "Low downtime" policy on primary instances results in minimal downtime (less than one second) and read pools experience zero downtime, while "Force apply" results in about one minute of downtime for both, with flag changes applying much faster.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage database flags via the Google Cloud console or by using the \u003ccode\u003egcloud\u003c/code\u003e command-line tool, being cautious that \u003ccode\u003egcloud\u003c/code\u003e commands can reset unlisted flags to their default values.\u003c/p\u003e\n"]]],[],null,["# Configure an instance's database flags\n\nThis page describes how to add database flags for an instance, modify database\nflags, and delete database flags from an instance in an AlloyDB for PostgreSQL\ncluster.\n\nYou use database flags for many operations, including adjusting PostgreSQL\nparameters, adjusting options, and configuring and tuning an instance.\nModifications to a database flag's value persist for its\ninstance until you remove the flag or you modify its value again.\n\nIn some cases, setting one flag may require that you set another flag to\nfully enable the desired functionality.\n\nAfter you set, remove, or modify a flag for a database instance,\nAlloyDB might restart the instance. This depends upon the flag,\nas listed in\n[Supported database flags](https://cloud.google.com/alloydb/docs/reference/database-flags).\n\nWhen you modify a database flag in the primary or a read pool instance\nthat needs a restart, you can choose one of the following maintenance policies:\n\n- **Low downtime.** This policy is enabled by default. We recommend\n using this policy for all your production AlloyDB\n clusters because it minimizes application downtime.\n\n With the low downtime policy enabled, updating a flag that requires a\n restart on your cluster's primary instance has these effects:\n - The primary instance experiences less than one second of downtime\n for most workloads.\n\n - The flag on the primary instance finishes updating to its new value\n after about 15 minutes.\n\n Updating a flag that requires a restart on a read pool instance has\n these effects:\n - The read pool instance does not require any downtime.\n\n - The flag on the read pool instance finishes updating to its new\n value after about 10 minutes.\n\n- **Force apply.** To apply flag updates faster, use the `FORCE_APPLY`\n option with the `gcloud beta alloydb instances update` command.\n\n This policy is more appropriate for development environments, letting\n you quickly add or modify flags in exchange for longer instance\n downtime and a temporary decrease in database performance or\n throughput. Your cluster returns to peak performance several minutes\n after force applying a flag update.\n\n With the force apply policy enabled, updating a flag that requires a\n restart on your cluster's primary instance has these effects:\n - The primary instance experiences about one minute of downtime.\n\n - The flag on the primary instance finishes updating to its new value\n after one or two minutes.\n\n Updating a flag that requires a restart on a read pool instance has\n these effects:\n - The read pool instance experiences about one minute of downtime.\n\n - The flag on the read pool instance finishes updating to its new\n value after one or two minutes.\n\n\nBefore you begin\n----------------\n\n- The Google Cloud project you are using must have been [enabled to access AlloyDB](/alloydb/docs/project-enable-access).\n- You must have one of these IAM roles in the Google Cloud project you are using:\n - `roles/alloydb.admin` (the AlloyDB Admin predefined IAM role)\n - `roles/owner` (the Owner basic IAM role)\n - `roles/editor` (the Editor basic IAM role)\n\n If you don't have any of these roles, contact your Organization Administrator to request\n access.\n\n\u003cbr /\u003e\n\n### Console\n\n1. In the Google Cloud console, go to the **Clusters** page.\n\n [Go to Clusters](https://console.cloud.google.com/alloydb/clusters)\n2. Click a cluster in the **Resource Name** column.\n\n3. In the **Overview** page, go to **Instances in your cluster** ,\n select an instance, and then click **Edit**.\n\n4. Add, modify, or delete a database flag from your instance:\n\n **Add a flag**\n 1. To add a database flag to your instance, click **Add flag**.\n 2. Select a flag from the **New database flag** list.\n 3. Provide a value for the flag.\n 4. Click **Done**.\n\n **Modify a flag**\n 1. To modify a database flag present in your instance, expand the database flag and modify the value of the existing flag in the **Edit database flag** section.\n 2. Click **Done**.\n\n **Delete a flag**\n 1. To delete a database flag from your instance, select a flag and click the delete icon.\n 2. Click **Done**.\n5. Click **Update instance**.\n\n### gcloud\n\nUse the [`gcloud alloydb instances update`](/sdk/gcloud/reference/beta/alloydb/instances/update)\ncommand to change the database flags for an instance.\n**Caution:** Running the following command overwrites all database flags that are previously set. Any database flags that are not explicitly included in the `--database-flags` list are reset to its default value. To retain your instance's database flags while adding new flags, you must include both current and new flags in the `--database-flags` list. \n\n gcloud alloydb instances update \u003cvar translate=\"no\"\u003eINSTANCE_ID\u003c/var\u003e \\\n --database-flags \u003cvar translate=\"no\"\u003eFLAGS_LIST\u003c/var\u003e \\\n --region=\u003cvar translate=\"no\"\u003eREGION_ID\u003c/var\u003e \\\n --cluster=\u003cvar translate=\"no\"\u003eCLUSTER_ID\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\n\nTo apply flag updates more rapidly, include the argument\n`--update-mode=FORCE_APPLY`. Because this can temporarily decrease database\nperformance, avoid using this option in a production environment. \n\n gcloud beta alloydb instances update \u003cvar translate=\"no\"\u003eINSTANCE_ID\u003c/var\u003e \\\n --database-flags \u003cvar translate=\"no\"\u003eFLAGS_LIST\u003c/var\u003e \\\n --region=\u003cvar translate=\"no\"\u003eREGION_ID\u003c/var\u003e \\\n --cluster=\u003cvar translate=\"no\"\u003eCLUSTER_ID\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --update-mode=FORCE_APPLY\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eINSTANCE_ID\u003c/var\u003e: The ID of the instance.\n- \u003cvar translate=\"no\"\u003eFLAGS_LIST\u003c/var\u003e: A comma-separated list of one or more database flag specifications. Each specification consists of the name of the flag, an equals sign (=), and the value to assign to the flags. For database flags that do not take values, provide the name of the flag followed by an equals sign (=).\n- \u003cvar translate=\"no\"\u003eREGION_ID\u003c/var\u003e: The region where the instance is placed---for example, `us-central1`.\n- \u003cvar translate=\"no\"\u003eCLUSTER_ID\u003c/var\u003e: The ID of the cluster where the instance is placed.\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: The ID of the project where the cluster is placed. undergoing low or zero downtime maintenance cycle, after you modify database flags.\n\nTo see the list of an instance's current, manually-set flags, run the following\ncommand: \n\n gcloud alloydb instances describe \u003cvar translate=\"no\"\u003eINSTANCE_ID\u003c/var\u003e \\\n --region=\u003cvar translate=\"no\"\u003eREGION_ID\u003c/var\u003e \\\n --cluster=\u003cvar translate=\"no\"\u003eCLUSTER_ID\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e"]]
