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
- 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.
- Abre la instancia y haz clic en Editar.
- Desplázate hacia la sección de marcas.
- 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.
- Haz clic en Guardar para guardar los cambios.
- 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
- 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.
- Abre la instancia y haz clic en Editar.
- Abre la sección de marcas de base de datos.
- Haz clic en la X situada junto a todas las marcas que se muestran.
- 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 clientepsql 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
- 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.
- 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 |