Configura marcas de base de datos

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, la réplica también se reiniciará para alinearse con la configuración actual de la instancia.

Configura marcas de base de datos

Cómo definir una marca de base de datos

Console

  1. En Google Cloud Console, crea un proyecto nuevo de Cloud Console o selecciona el nombre de un proyecto existente para abrirlo.
  2. Abre la instancia y haz clic en Editar.
  3. Desplázate hacia abajo hasta la sección Marcas.
  4. 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.
  5. Haz clic en Guardar para guardar los cambios.
  6. 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]

Este comando reemplazará todas las marcas de bases de datos establecidas con anterioridad. Para conservarlos y agregar nuevos, incluye los valores de todas las marcas que desees configurar en la instancia. Cualquier marca que no esté incluida, se establece en su valor predeterminado. Para marcas que no tomen un valor, especifica el nombre de la marca seguido por un signo igual (“=”).

REST

Si deseas configurar una marca para una base de datos existente, usa el siguiente comando:

Antes de usar cualquiera de los datos de solicitud siguientes, realiza los siguientes reemplazos:

  • project-id: El ID del proyecto
  • instance-id: El ID de la instancia

Método HTTP y URL:

PATCH https://www.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 siguiente:

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 todas las marcas a su valor predeterminado

Console

  1. En Google Cloud Console, crea un proyecto nuevo de Cloud Console o selecciona el nombre de un proyecto existente para abrirlo.
  2. Abre la instancia y haz clic en Editar.
  3. Abre la sección Marcas de base de datos.
  4. Haz clic en las X ubicadas junto a todas las marcas que se muestran.
  5. 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

Para borrar todas las marcas de una instancia existente, haz lo siguiente:

Antes de usar cualquiera de los datos de solicitud siguientes, realiza los siguientes reemplazos:

  • project-id: El ID del proyecto
  • instance-id: El ID de la instancia

Método HTTP y URL:

PATCH https://www.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 siguiente:

Ve los valores actuales de las marcas de base de datos

Determina qué marcas de base de datos se configuraron para una instancia

Para ver que marcas se configuraron para una instancia de Cloud SQL, sigue estos pasos:

Console

  1. En Google Cloud Console, crea un proyecto nuevo de Cloud Console o selecciona el nombre de un proyecto existente para abrirlo.
  2. 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 la sección Representación de recursos de instancias.

REST

Para enumerar las marcas configuradas para una instancia, haz lo siguiente:

Antes de usar cualquiera de los datos de solicitud siguientes, realiza los siguientes reemplazos:

  • project-id: El ID del proyecto
  • instance-id: El ID de la instancia

Método HTTP y URL:

GET https://www.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

Marca de Cloud SQL Tipo
Notas y valores aceptables
¿Reinicio
obligatorio?
¿En versión Beta?
1204 (marca de seguimiento) boolean
on|off
No No
1222 (marca de seguimiento) boolean
on|off
No No
1224 (marca de seguimiento) boolean
on|off
No No
2528 (marca de seguimiento) boolean
on|off
No No
3205 (marca de seguimiento) boolean
on|off
No No
3226 (marca de seguimiento) boolean
on|off
No No
3625 (marca de seguimiento) boolean
on|off
No
4199 (marca de seguimiento) boolean
on|off
No No
4616 (marca de seguimiento) boolean
on|off
No No
7806 (marca de seguimiento) boolean
on|off
No
recuento de depósitos de caché de verificación de acceso integer
0 … 65536
No No
cuota de caché de verificación de acceso integer
0 … 2147483647
No No
máscara de afinidad integer
2147483648 … 2147483647
No No
agent xps boolean
on|off
No No
soft-NUMA automático inhabilitado boolean
on|off
No
umbral de costo para paralelismo integer
0 … 32767
No No
autenticación de base de datos contenida boolean
on|off
No No
encadenamiento de propiedad de la base de datos cruzada boolean
on|off
No No
umbral del cursor integer
-1 … 2147483647
No No
idioma de texto completo predeterminado integer
0 … 2147483647
No No
idioma predeterminado integer
0 … 2147483647
No No
seguimiento predeterminado habilitado boolean
on|off
No No
no permitir resultados de activadores boolean
on|off
No No
secuencias de comandos externas habilitadas boolean
on|off
No
ancho de banda de rastreo (máx.) integer
0 … 32767
No No
ancho de banda de rastreo (min.) integer
0 … 32767
No No
ancho de banda de notificación (máx.) integer
0 … 32767
No No
ancho de banda de notificación (min.) integer
0 … 32767
No No
factor de relleno (%) integer
0 … 100
No No
memoria para crear índice (kb) integer
704 … 2147483647
No No
bloqueos integer
5000 … 2147483647
No
memoria máxima del servidor (mb) integer
128 … 2147483647
No No
tamaño máximo de la replicación de texto (b) integer
-1 … 2147483647
No No
máximo de subprocesos de trabajador integer
128 … 65535
No No
activadores anidados boolean
on|off
No No
optimizar para cargas de trabajo ad hoc boolean
on|off
No No
tiempo de espera de ph (s) integer
1 … 3600
No No
límite de costo del controlador de búsquedas integer
0 … 2147483647
No No
esperas de búsquedas (s) integer
-1 … 2147483647
No No
intervalo de recuperación (min.) integer
0 … 32767
No No
acceso remoto boolean
on|off
No No
tiempo de espera de acceso remoto (s) integer
0 … 2147483647
No No
tiempo de espera de búsqueda remota (s) integer
0 … 2147483647
No No
transformar palabras irrelevantes boolean
on|off
No No
corte anual de dos dígitos integer
1753 … 9999
No No
conexiones de usuario integer
0 … 32767
No
opciones de usuario integer
0 … 32767
No No

Qué sigue