Configura las marcas de base de datos de una instancia

En esta página, se describe cómo agregar, modificar y borrar marcas de base de datos de una instancia en un clúster de AlloyDB para PostgreSQL.

Las marcas de base de datos se usan en muchas operaciones, como el ajuste de los parámetros de PostgreSQL, el ajuste de las opciones, y la configuración y el ajuste de una instancia. Las modificaciones en el valor de una marca de base de datos persisten en su instancia hasta que quitas la marca o vuelves a modificar su valor.

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

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 compatibles.

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 que uses 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, la actualización de una marca que requiere un reinicio en la instancia principal de tu clúster tiene los siguientes efectos:

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

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

    La actualización de una marca que requiere un reinicio en una instancia de grupo de lectura tiene los siguientes efectos:

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

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

  • Aplicar de manera forzosa. Para aplicar las actualizaciones de 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 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. Tu clúster vuelve al máximo rendimiento varios minutos después de aplicar de manera forzosa una actualización de marca.

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

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

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

    La actualización de una marca que requiere un reinicio en una instancia de grupo de lectura tiene los siguientes efectos:

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

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

Antes de comenzar

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

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

Console

  1. En la Google Cloud consola de, 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. Agrega, modifica o borra una marca de base de datos de tu instancia:

    Agrega 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 una marca

    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.

    Borra 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.

  5. Haz clic en Actualizar instancia.

gcloud

Usa el gcloud alloydb instances update comando 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 las actualizaciones de marcas más rápido, 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: 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: La región en la que se coloca 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 coloca el clúster. que se somete a un ciclo de mantenimiento con tiempo de inactividad bajo o nulo, después de modificar las marcas de base de datos.

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

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