Configura las marcas de base de datos de una instancia

Para ajustar los parámetros de PostgreSQL, las opciones de la base de datos y personalizar el comportamiento de la instancia en un clúster de AlloyDB para PostgreSQL, puedes agregar, modificar o quitar marcas de base de datos en una instancia. Las modificaciones en el valor de una marca de base de datos se conservan para su instancia hasta que quites la marca o vuelvas a modificar su valor.

En algunos casos, para configurar una marca necesitas configurar otra a fin de habilitar por completo la función de destino.

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

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

  • Tiempo de inactividad bajo. Esta política está habilitada de forma predeterminada. Te recomendamos usar esta política para todos tus clústeres de AlloyDB de producción, ya que minimiza el tiempo de inactividad de la aplicación.

    Con la política de tiempo de inactividad bajo habilitada, actualizar una marca que requiere un reinicio en la instancia principal de tu clúster tiene estos efectos:

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

    • La marca en la instancia principal termina de actualizarse a su valor nuevo después de unos 15 minutos.

    Actualizar una marca que requiere un reinicio en una instancia de grupo de lectura tiene los siguientes efectos:

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

    • La marca en la instancia del grupo de lectura termina de actualizarse a su valor nuevo después de unos 10 minutos.

  • Aplicar de manera forzosa. Para aplicar actualizaciones de marcas con mayor rapidez, 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 agregar o modificar rápidamente marcas a cambio de un tiempo de inactividad de la instancia más largo y una disminución temporal en el rendimiento o la capacidad de procesamiento de la base de datos. El clúster vuelve a su rendimiento máximo varios minutos después de aplicar de forma forzosa una actualización de marca.

    Con la política de aplicación forzada habilitada, actualizar una marca que requiere un reinicio en la instancia principal de tu clúster tiene los siguientes efectos:

    • La instancia principal experimenta alrededor de un minuto de tiempo de inactividad.

    • La marca en la instancia principal termina de actualizarse a su valor nuevo después de uno o dos minutos.

    Actualizar una marca que requiere un reinicio en una instancia de grupo de lectura tiene los siguientes efectos:

    • La instancia de grupo de lectura experimenta alrededor de un minuto de tiempo de inactividad.

    • La marca en la instancia del grupo de lectura termina de actualizarse a su valor nuevo después de uno o dos minutos.

Antes de comenzar

  • El proyecto de Google Cloud que usas debe haber sido habilitado para acceder a AlloyDB.
  • Debes tener uno de estos roles de IAM en el proyecto de Google Cloud que estás usando:
    • roles/alloydb.admin (el rol de IAM predefinido de administrador de AlloyDB)
    • roles/owner (el rol básico de IAM de propietario)
    • roles/editor (el rol básico de IAM de editor)

    Si no tienes ninguno de estos roles, comunícate con el administrador de la organización para solicitar acceso.

Para garantizar que el mantenimiento y las actualizaciones puedan crear ranuras de replicación temporales para la sincronización de estado, asegúrate de que la cantidad total de ranuras de replicación sea al menos una menos que el límite de max_wal_senders. Para obtener más información sobre cómo configurar esta marca, consulta Configura tus instancias de origen.

Console

  1. En la consola de Google Cloud , ve a la página Clústeres.

    Ir a los clústeres

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

  3. En la página Descripción general, ve a Instancias en tu clúster, selecciona una instancia y, luego, haz clic en Editar.

  4. Expande Opciones de configuración avanzada.

  5. Agrega, modifica o borra una marca de base de datos de tu instancia:

    Cómo agregar una marca

    1. Para agregar una marca de base de datos a tu instancia, haz clic en Agregar marca.
    2. Selecciona una marca de la lista Nueva marca de base de datos.
    3. Proporciona un valor para la marca.
    4. Haz clic en Listo.

    Modifica un parámetro

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

    Cómo borrar una marca

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

  6. Haz clic en Actualizar instancia.

gcloud

Usa el comando gcloud alloydb instances update para cambiar las marcas de 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 actualizaciones de marcas con mayor rapidez, incluye el argumento --update-mode=FORCE_APPLY. Debido a que esto puede disminuir temporalmente el rendimiento de la base de datos, evita usar 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

Reemplaza lo siguiente:

  • INSTANCE_ID: El ID de la instancia.
  • FLAGS_LIST: Es una lista separada por comas de una o más especificaciones de marcas de base de datos. Cada especificación consta del nombre de la marca, un signo igual (=) y el valor que se asignará a las marcas. Para las marcas de base de datos que no toman valores, proporciona el nombre de la marca seguido de un signo igual (=).
  • REGION_ID: Es la región en la que se encuentra la instancia, por ejemplo, us-central1.
  • CLUSTER_ID: Es el ID del clúster en el que se coloca la instancia.
  • PROJECT_ID: Es el ID del proyecto en el que se coloca el clúster.

Para ver la lista de las marcas actuales de una instancia que se configuraron de forma manual, ejecuta el siguiente comando:

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