Configura las marcas de base de datos de una instancia

En esta página, se describe cómo agregar, modificar y borrar marcas de bases 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 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. 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 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 en la instancia principal termina de actualizarse a su nuevo valor 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 nuevo valor después de unos 10 minutos.

  • Aplicar a la fuerza 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 los entornos de desarrollo, ya que te permite agregar o modificar marcas rápidamente a cambio de un mayor tiempo de inactividad de la instancia 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 por la fuerza una actualización de la marca.

    Con la política de aplicación forzada 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 inactividad.

    • La marca de la instancia principal termina de actualizarse a su nuevo valor 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 del grupo de lectura experimenta aproximadamente un minuto de inactividad.

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

Antes de comenzar

  • El proyecto Google Cloud que usas debe estar habilitado para acceder a AlloyDB.
  • Debes tener uno de estos roles de IAM en el proyecto Google Cloud que estás usando:
    • 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 básico de IAM 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. Sigue estos pasos para agregar, modificar o borrar 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 New database flag.
    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, 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 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 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, 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 bases de datos. Cada especificación consta del nombre de la marca, un signo igual (=) y el valor que se asignará a las marcas. En el caso de las marcas de la 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 coloca la instancia.
  • PROJECT_ID: ID del proyecto en el que se coloca el clúster. Se somete a un ciclo de mantenimiento con un tiempo de inactividad bajo o nulo después de que modificas las marcas de la base de datos.

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

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