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 y la instancia se reinicia, la réplica también se reinicia 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]

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, puedes usar el siguiente comando:

gcloud sql instances patch [INSTANCE_NAME] --database-flags  \
    "1204"=on,"remote access"=on,"remote query timeout (s)"=300

API de 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 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://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 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.

API de REST v1beta4

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://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 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 Representación de recursos de instancias.

API de REST v1beta4

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://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

Las marcas no mencionadas a continuación no son compatibles.

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

¿Qué sigue?