Configurar las marcas de bases de datos de una instancia

En esta página se describe cómo añadir, modificar y eliminar marcas de base de datos de una instancia de un clúster de AlloyDB para PostgreSQL.

Las marcas de base de datos se usan en muchas operaciones, como ajustar los parámetros de PostgreSQL, las opciones y la configuración de una instancia. Las modificaciones del valor de una marca de base de datos se mantienen en su instancia hasta que elimines la marca o vuelvas a modificar su valor.

En algunos casos, configurar una marca puede requerir que se establezca otra distinta para habilitar completamente la funcionalidad deseada.

Después de definir, quitar o modificar una marca de una instancia de base de datos, es posible que AlloyDB reinicie la instancia. Esto depende de la marca, tal como se indica en Marcas de bases de datos admitidas.

Cuando modificas una marca de base de datos en la instancia principal o en una instancia de un grupo de lectura que necesita reiniciarse, puedes elegir una de las siguientes políticas de mantenimiento:

  • Tiempo de inactividad bajo. Esta política está habilitada de forma predeterminada. Recomendamos usar esta política en todos los clústeres de AlloyDB de producción, ya que minimiza el tiempo de inactividad de las aplicaciones.

    Si la política de tiempo de inactividad bajo está habilitada, al actualizar una marca que requiere reiniciar la instancia principal de tu clúster, se producen los siguientes efectos:

    • La instancia principal experimenta un tiempo de inactividad de menos de un segundo en la mayoría de las cargas de trabajo.

    • La marca de la instancia principal termina de actualizarse a su nuevo valor al cabo de unos 15 minutos.

    Si actualizas una marca que requiere reiniciar una instancia del grupo de lectura, se producirán los siguientes efectos:

    • La instancia del grupo de lectura no requiere ningún tiempo de inactividad.

    • La marca de la instancia del grupo de lectura termina de actualizarse a su nuevo valor al cabo de unos 10 minutos.

  • Forzar aplicación. Para aplicar las actualizaciones de las marcas más rápido, usa la opción FORCE_APPLY con el comando gcloud beta alloydb instances update.

    Esta política es más adecuada para entornos de desarrollo, ya que te permite añadir o modificar rápidamente las marcas a cambio de un mayor tiempo de inactividad de la instancia y una disminución temporal del rendimiento o del procesamiento de la base de datos. Tu clúster vuelve a su rendimiento máximo varios minutos después de aplicar una actualización de una marca de forma forzada.

    Si la política de aplicación forzada está habilitada, al actualizar una marca que requiere reiniciar la instancia principal de tu clúster, se producen los siguientes efectos:

    • La instancia principal experimenta aproximadamente un minuto de inactividad.

    • La marca de la instancia principal termina de actualizarse a su nuevo valor al cabo de uno o dos minutos.

    Si actualizas una marca que requiere reiniciar una instancia del grupo de lectura, se producirán los siguientes efectos:

    • La instancia del grupo de lectura experimenta un periodo de inactividad de aproximadamente un minuto.

    • La marca de la instancia del grupo de lectura termina de actualizarse a su nuevo valor al cabo de uno o dos minutos.

Antes de empezar

  • El Google Cloud proyecto que estés usando debe tener habilitado el acceso a AlloyDB.
  • Debes tener uno de estos roles de gestión de identidades y accesos en el Google Cloud proyecto que estés usando:
    • roles/alloydb.admin (el rol de gestión de identidades y accesos predefinido de AlloyDB)
    • roles/owner (el rol básico de propietario de gestión de identidades y accesos)
    • roles/editor (el rol básico de gestión de identidades y accesos Editor)

    Si no tienes ninguno de estos roles, ponte en contacto con el administrador de tu organización para solicitar acceso.

Consola

  1. En la Google Cloud consola, ve a la página Clusters.

    Ir a Clústeres

  2. Haga clic en un clúster de la columna Nombre del recurso.

  3. En la página Overview (Resumen), vaya a Instances in your cluster (Instancias de su clúster), seleccione una instancia y, a continuación, haga clic en Edit (Editar).

  4. Para añadir, modificar o eliminar una marca de base de datos de tu instancia, sigue estos pasos:

    Añadir una marca

    1. Para añadir una marca de base de datos a tu instancia, haz clic en Añadir marca.
    2. Seleccione una marca de la lista Nueva marca de base de datos.
    3. Indica un valor para la marca.
    4. Haz clic en Listo.

    Modificar una marca

    1. Para modificar una marca de base de datos presente en tu instancia, amplía la marca de base de datos y modifica el valor de la marca en la sección Editar marca de base de datos.
    2. Haz clic en Listo.

    Eliminar una marca

    1. Para eliminar una marca de base de datos de tu instancia, selecciona una marca y haz clic en el icono de eliminar.
    2. Haz clic en Listo.

  5. Haz clic en Actualizar instancia.

gcloud

Usa el comando gcloud alloydb instances update para cambiar las marcas de la base de datos de una instancia.

   gcloud alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID

Para aplicar las actualizaciones de las marcas más rápidamente, incluye el argumento --update-mode=FORCE_APPLY. Dado que esto puede reducir temporalmente el rendimiento de la base de datos, no utilices esta opción en un entorno de producción.

   gcloud beta alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID \
   --update-mode=FORCE_APPLY

Haz los cambios siguientes:

  • INSTANCE_ID: el ID de la instancia.
  • FLAGS_LIST: lista separada por comas de una o varias especificaciones de marcas de base de datos. Cada especificación consta del nombre de la marca, un signo igual (=) y el valor que se le asigna. En el caso de las marcas de bases de datos que no aceptan valores, indica el nombre de la marca seguido de un signo igual (=).
  • REGION_ID: la región en la que se encuentra la instancia (por ejemplo, us-central1).
  • CLUSTER_ID: el ID del clúster en el que se coloca la instancia.
  • PROJECT_ID: el ID del proyecto en el que se encuentra el clúster. se somete a un ciclo de mantenimiento con un tiempo de inactividad bajo o nulo después de modificar las marcas de la base de datos.

Para ver la lista de las marcas de una instancia que se han definido manualmente, ejecuta el siguiente comando:

   gcloud alloydb instances describe INSTANCE_ID \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID