En esta página, se describe cómo configurar las marcas de base de datos de Cloud SQL y se muestra una lista de aquellas que puedes configurar para tu instancia. Las marcas de base de datos se usan en muchas operaciones, como el ajuste de los parámetros de SQL Server, el ajuste de las opciones y la configuración, y el ajuste de una instancia.
Cuando se configura, quita o modifica una marca para una instancia de base de datos, es posible que se reinicie la base de datos. El valor de marca se conserva para la instancia hasta que lo quites. Si la instancia es la fuente de una réplica y la instancia se reinicia, la réplica también se reinicia para alinearse con la configuración actual de la instancia.
Configurar marcas de bases de datos
Establece una marca de base de datos
Console
- En la consola de Google Cloud, selecciona el proyecto que contiene la instancia de Cloud SQL para la que deseas configurar una marca de base de datos.
- Abre la instancia y haz clic en Editar.
- Desplázate hacia abajo hasta la sección Marcas.
- Para configurar una marca que no se configuró antes en la instancia, haz clic en Agregar elemento, elige la marca del menú desplegable y configura su valor.
- Haz clic en Guardar para guardar los cambios.
- Confirma tus cambios en Marcas en la página Descripción general.
gcloud
Edita la instancia:
gcloud sql instances patch INSTANCE_NAME --database-flags=FLAG1=VALUE1,FLAG2=VALUE2
Mediante este comando, se reemplazarán todas las marcas de bases de datos establecidas con anterioridad. Para conservarlas y agregar nuevas, incluye los valores de todas las marcas que desees configurar en la instancia. Cualquier marca que no esté incluida de forma explícita se establecerá con su valor predeterminado. Para marcas que no tomen un valor, especifica el nombre de la marca seguido por un signo igual (“=”).
Por ejemplo, para configurar las marcas 1204
, remote access
y remote query timeout (s)
, puedes usar el siguiente comando:
gcloud sql instances patch INSTANCE_NAME \ --database-flags="1204"=on,"remote access"=on,"remote query timeout (s)"=300
Terraform
Para agregar marcas de base de datos, usa un recurso de Terraform.
Aplique los cambios
Para aplicar tu configuración de Terraform en un proyecto de Google Cloud, completa los pasos de las siguientes secciones.
Prepara Cloud Shell
- Inicia Cloud Shell
-
Establece el proyecto de Google Cloud predeterminado en el que deseas aplicar tus configuraciones de Terraform.
Solo necesitas ejecutar este comando una vez por proyecto y puedes ejecutarlo en cualquier directorio.
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
Las variables de entorno se anulan si configuras valores explícitos en el archivo de configuración de Terraform.
Prepara el directorio
Cada archivo de configuración de Terraform debe tener su propio directorio (también llamado módulo raíz).
-
En Cloud Shell, crea un directorio y un archivo nuevo dentro de ese directorio. El nombre del archivo debe tener la extensión
.tf
, por ejemplo,main.tf
. En este instructivo, el archivo se denominamain.tf
.mkdir DIRECTORY && cd DIRECTORY && touch main.tf
-
Si sigues un instructivo, puedes copiar el código de muestra en cada sección o paso.
Copia el código de muestra en el
main.tf
recién creado.De manera opcional, copia el código de GitHub. Esto se recomienda cuando el fragmento de Terraform es parte de una solución de extremo a extremo.
- Revisa y modifica los parámetros de muestra que se aplicarán a tu entorno.
- Guarda los cambios.
-
Inicializa Terraform. Solo debes hacerlo una vez por directorio.
terraform init
De manera opcional, incluye la opción
-upgrade
para usar la última versión del proveedor de Google:terraform init -upgrade
Aplica los cambios
-
Revisa la configuración y verifica que los recursos que creará o actualizará Terraform coincidan con tus expectativas:
terraform plan
Corrige la configuración según sea necesario.
-
Para aplicar la configuración de Terraform, ejecuta el siguiente comando y, luego, escribe
yes
cuando se te solicite:terraform apply
Espera hasta que Terraform muestre el mensaje “¡Aplicación completa!”.
- Abre tu proyecto de Google Cloud para ver los resultados. En la consola de Google Cloud, navega a tus recursos en la IU para asegurarte de que Terraform los haya creado o actualizado.
Borra los cambios
Para borrar tus cambios, haz lo siguiente:
- Para inhabilitar la protección contra la eliminación, en tu archivo de configuración de Terraform, establece el argumento
deletion_protection
enfalse
.deletion_protection = "false"
- Para aplicar la configuración actualizada de Terraform, ejecuta el siguiente comando y, luego, ingresa
yes
cuando se te solicite:terraform apply
-
Quita los recursos que se aplicaron antes con tu configuración de Terraform a través de la ejecución del siguiente comando y, luego, ingresa
yes
cuando se te solicite:terraform destroy
REST v1
Si deseas configurar una marca para una base de datos existente, haz lo siguiente:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- project-id: el ID del proyecto
- instance-id: Es el ID de la instancia.
Método HTTP y URL:
PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id
Cuerpo JSON de la solicitud:
{ "settings": { "databaseFlags": [ { "name": "flag_name", "value": "flag_value" } ] } }
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Si hay marcas existentes configuradas para la base de datos, modifica el comando anterior a fin de incluirlas. El comando PATCH
reemplaza las marcas existentes con las especificadas en la solicitud.
REST v1beta4
Si deseas configurar una marca para una base de datos existente, haz lo siguiente:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- project-id: el ID del proyecto
- instance-id: Es el ID de la instancia.
Método HTTP y URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id
Cuerpo JSON de la solicitud:
{ "settings": { "databaseFlags": [ { "name": "flag_name", "value": "flag_value" } ] } }
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Si hay marcas existentes configuradas para la base de datos, modifica el comando anterior a fin de incluirlas. El comando PATCH
reemplaza las marcas existentes con las especificadas en la solicitud.
Restablece los valores predeterminados de todas las marcas
Console
- En la consola de Google Cloud, selecciona el proyecto que contiene la instancia de Cloud SQL para la que deseas restablecer todas las marcas.
- Abre la instancia y haz clic en Editar.
- Abre la sección Marcas de base de datos.
- Haz clic en las X ubicadas junto a todas las marcas que se muestran.
- Haz clic en Guardar para guardar los cambios.
gcloud
Restablece todas las marcas a sus valores predeterminados en una instancia:
gcloud sql instances patch INSTANCE_NAME \ --clear-database-flags
Se te solicitará que confirmes que se reiniciará la instancia.
REST v1
Para borrar todas las marcas de una instancia existente, haz lo siguiente:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- project-id: el ID del proyecto
- instance-id: Es el ID de la instancia.
Método HTTP y URL:
PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id
Cuerpo JSON de la solicitud:
{ "settings": { "databaseFlags": [] } }
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
REST v1beta4
Para borrar todas las marcas de una instancia existente, haz lo siguiente:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- project-id: el ID del proyecto
- instance-id: Es el ID de la instancia.
Método HTTP y URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id
Cuerpo JSON de la solicitud:
{ "settings": { "databaseFlags": [] } }
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Determina qué marcas de base de datos se configuraron para una instancia
Para ver qué marcas se configuraron para una instancia de Cloud SQL, sigue estos pasos:
Console
- En la consola de Google Cloud, selecciona el proyecto que contiene la instancia de Cloud SQL para la que deseas ver las marcas de base de datos que se configuraron.
- Selecciona la instancia para abrir la página de descripción general de la instancia.
Las marcas de base de datos que se configuraron se enumeran en la sección 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 indican en settings
como el grupo databaseFlags
. Para obtener más información sobre la representación de las marcas en el resultado, consulta Representación de recursos de instancias.
REST v1
Para enumerar las marcas configuradas para una instancia, haz lo siguiente:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- project-id: el ID del proyecto
- instance-id: Es el ID de la instancia.
Método HTTP y URL:
GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
En el resultado, busca el campo databaseFlags
.
REST v1beta4
Para enumerar las marcas configuradas para una instancia, haz lo siguiente:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- project-id: el ID del proyecto
- instance-id: Es el ID de la instancia.
Método HTTP y URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
En el resultado, busca el campo databaseFlags
.
Marcas compatibles
Cloud SQL solo admite las marcas que se indican en esta sección.
Marcas especiales
En esta sección, se incluye información adicional sobre las marcas de Cloud SQL para SQL Server.
max server memory (mb)
Esta marca limita la cantidad de memoria que Cloud SQL puede asignar para sus grupos internos. La recomendación general es establecer el valor de la marca en un 80% para evitar que SQL Server consuma toda la memoria disponible para la instancia de Cloud SQL. Si estableces un valor superior al 80%, es posible que experimentes inestabilidad, degradación del rendimiento y fallas de la base de datos debido a problemas de memoria insuficiente.
Si no estableces un valor para esta marca, Cloud SQL lo administrará automáticamente en función del tamaño de la RAM de tu instancia. Además, si cambias el tamaño de la instancia, Cloud SQL ajusta el valor de la marca automáticamente para cumplir con nuestras recomendaciones para el nuevo tamaño de la instancia. Esto garantiza que tu base de datos utilice los recursos de manera eficaz, lo que evita la sobreasignación, las fallas y la degradación del rendimiento de tu instancia.
Soluciona problemas
Problema | Soluciona problemas |
---|---|
Quieres modificar la zona horaria de una instancia de Cloud SQL. |
Para ver cómo actualizar la zona horaria de una instancia, consulta Configuración de instancias. En Cloud SQL para SQL Server, puedes usar la función |
¿Qué sigue?
- Obtén más información sobre las opciones de configuración de SQL Server.