Configurar marcas de bases de datos

En esta página se describe cómo configurar marcas de bases de datos de Cloud SQL y se indican qué marcas puedes establecer en tu instancia. Las marcas de base de datos sirven para ajustar los parámetros y las opciones de PostgreSQL con el fin de configurar y ajustar tu instancia.

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

Cuando estableces, eliminas o modificas una marca de una instancia, dicha instancia puede reiniciarse. Se conserva el valor de la marca para la instancia hasta que lo elimines.

Configurar marcas de bases de datos

Configurar marcas de bases de datos

Consola

  1. En la consola de Google Cloud Platform, crea un nuevo proyecto de la consola de GCP o selecciona el nombre de dicho proyecto para abrirlo.
  2. Abre la instancia y haz clic en Editar.
  3. Desplázate hacia la sección de marcas.
  4. Si quieres configurar una marca que no se haya establecido previamente en la instancia, haz clic en Añadir elemento, elige la marca en el menú desplegable y establece su valor.
  5. Haz clic en Guardar para guardar los cambios.
  6. Confirma los cambios en la sección de marcas de la página de la visión general.

gcloud

Edita la instancia:

gcloud sql instances patch [INSTANCE_NAME] --database-flags [FLAG1=VALUE1,FLAG2=VALUE2]

En el caso de las marcas que no adquieren un valor, especifica el nombre de la marca seguido de un signo igual ("="). Incluye los valores de todas las marcas que quieras establecer en la instancia; las marcas que no se incluyan volverán a tener el valor predeterminado.

cURL

Si quieres establecer una marca en una instancia, usa este método:

ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json' \
     --data '{"settings" : {"databaseFlags" :
         [{ "name": "<FLAG-NAME>",  "value": "<FLAG-VALUE>" }]}}' \
     -X PATCH \
     https://www.googleapis.com/sql/v1beta4/projects/<PROJECT-ID>/instances/<INSTANCE_NAME>

Si hay marcas configuradas en la instancia, cambia el comando anterior para incluirlas. El comando PATCH sustituye las marcas actuales por las especificadas en la petición.

Restablecer todas las marcas a su valor predeterminado

Consola

  1. En la consola de Google Cloud Platform, crea un nuevo proyecto de la consola de GCP o selecciona el nombre de dicho proyecto para abrirlo.
  2. Abre la instancia y haz clic en Editar.
  3. Abre la sección de marcas de base de datos.
  4. Haz clic en la X situada junto a todas las marcas que se muestran.
  5. Haz clic en Guardar para guardar los cambios.

gcloud

Restablece el valor predeterminado de todas las marcas de una instancia de este modo:

gcloud sql instances patch [INSTANCE_NAME] --clear-database-flags

Se te pedirá que aceptes que la instancia se reinicie.

cURL

Si quieres borrar todas las marcas de una instancia, usa este método:

ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
       --header 'Content-Type: application/json' \
       --data '{"settings" : {"databaseFlags" : []}}' \
       -X PATCH \
       https://www.googleapis.com/sql/v1beta4/projects/<PROJECT-ID>/instances/<INSTANCE_NAME>

Visualizar los valores actuales de las marcas de la base de datos

Si quieres visualizar todos los valores actuales de la configuración de PostgreSQL, inicia sesión en la instancia con el cliente psql e introduce la siguiente declaración:

 SELECT name, setting FROM pg_settings;

Ten en cuenta que solo puedes cambiar el valor de las marcas admitidas como se detalla a continuación.

Determinar qué marcas de base de datos se han establecido en una instancia

Si quieres consultar qué marcas se han establecido en una instancia de Cloud SQL, sigue estos pasos:

Consola

  1. En la consola de Google Cloud Platform, crea un nuevo proyecto de la consola de GCP o selecciona el nombre de dicho proyecto para abrirlo.
  2. Selecciona la instancia para abrir la página de visión general de dicha instancia.

    Las marcas de base de datos establecidas se pueden consultar en la sección sobre marcas de base de datos.

gcloud

Obtén el estado de la instancia:

gcloud sql instances describe [INSTANCE_NAME]

En el resultado, las marcas de base de datos se muestran en settings como una recopilación databaseFlags. Si quieres obtener más información sobre la representación de las marcas en el resultado, consulta el apartado sobre representación de recursos de instancias.

cURL

Si quieres identificar los indicadores configurados en una instancia, usa este método:

ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
       --header 'Content-Type: application/json' \
       -X GET \
       https://www.googleapis.com/sql/v1beta4/projects/<PROJECT-ID>/instances/<INSTANCE_NAME>?fields=settings

En la resultado, busca el campo databaseFlags.

Marcas compatibles

Ten en cuenta que, en el caso de una marca concreta, Cloud SQL podría admitir un intervalo distinto del parámetro o la opción PostgreSQL correspondientes.

Marca Cloud SQL Tipo Valor predeterminado Se requiere reiniciar
autovacuum boolean On No
autovacuum_analyze_scale_factor float 0,1 o 10 % del tamaño de la tabla No
autovacuum_analyze_threshold integer 50 No
autovacuum_naptime integer 1 (1 minuto) No
autovacuum_vacuum_scale_factor float 0,2 o 20 % del tamaño de la tabla No
autovacuum_vacuum_threshold integer 50 No
default_statistics_target integer 100 No
log_autovacuum_min_duration integer -1 (almacenamiento de registro de acciones de vacío automático desactivado) No
temp_file_limit integer 10 % del tamaño de almacenamiento actual de la instancia; el valor de esta marca se actualiza cuando se reinicia la instancia, a menos que dicha marca se haya configurado de forma manual No

Siguientes pasos

Más información sobre la configuración del servidor PostgreSQL