Configura las marcas de base de datos de una instancia

En esta página, se describe cómo agregar marcas de base de datos a una instancia, modificarlas y borrarlas 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 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 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 de un 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 producción de AlloyDB, 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 requiera 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 valor nuevo después de unos 15 minutos.

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

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

    • La marca de la instancia del grupo de lectura finaliza la actualización a su valor nuevo después de unos 10 minutos.

  • Forzar aplicación. 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 marcas rápidamente 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 a tener el máximo rendimiento varios minutos después de forzar la aplicación de una actualización de marca.

    Con la política de aplicación forzosa habilitada, actualizar una marca que requiera 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 de la instancia principal termina de actualizarse a su valor nuevo 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 estos efectos:

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

    • La marca de la instancia del grupo de lectura finaliza su actualización a su valor nuevo después de uno o dos minutos.

Antes de comenzar

  • El proyecto de Google Cloud que usas debe estar habilitado para acceder a AlloyDB.
  • Debes tener uno de estos roles de IAM en el proyecto de Google Cloud 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 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. 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.

    Cómo modificar 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.

    Cómo borrar una marca

    1. Para borrar una marca de base de datos de tu instancia, selecciónala y haz clic en el ícono de borrar.
    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 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: 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 coloca la instancia, por ejemplo, us-central1.
  • CLUSTER_ID: Es el ID del clúster en el que se encuentra la instancia.
  • PROJECT_ID: Es el ID del proyecto en el que se encuentra el clúster. sometido a un ciclo de mantenimiento de tiempo de inactividad bajo o nulo después de modificar las marcas de la 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