Administra conjuntos de contexto en Cloud SQL Studio para MySQL

MySQL   |  PostgreSQL   |  SQL Server

Vista previa

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio y las Condiciones Adicionales para Productos de IA Generativa en Versión Preliminar. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para obtener más información sobre el acceso a esta versión, consulta la página de solicitud de acceso.

En este documento, se describe cómo crear conjuntos de contexto en Cloud SQL para MySQL Studio con un archivo de conjunto de contexto. Los nombres de los conjuntos de contexto deben ser únicos dentro de una base de datos.

Para obtener más información sobre los conjuntos de contexto, consulta Descripción general de los conjuntos de contexto.

Antes de comenzar

Completa los siguientes requisitos previos antes de crear un agente.

Habilita los servicios obligatorios

Habilita los siguientes servicios para tu proyecto:

• API de Data Analytics with Gemini
• API de Gemini for Google Cloud
• API de Dataplex Universal Catalog

Prepara una instancia de Cloud SQL

• Asegúrate de tener acceso a una instancia de Cloud SQL existente o crea una nueva. Para obtener más información, consulta Crea instancias para Cloud SQL.
• Asegúrate de crear una base de datos en tu instancia en la que crearás las tablas. Para obtener más información, consulta Crea una base de datos en la instancia de Cloud SQL.

Roles y permisos requeridos

• Agrega un usuario o una cuenta de servicio de IAM a nivel de la instancia. Para obtener más información, consulta Agrega una vinculación de política de IAM a un usuario, una cuenta de servicio o un grupo.
• Otorga las funciones cloudsql.studioUser, cloudsql.instanceUser y geminidataanalytics.queryDataUser al usuario o la cuenta de servicio de IAM a nivel del proyecto. Para obtener más información, consulta Agrega una vinculación de política de IAM para un proyecto.
• Debes tener un usuario con privilegios que otorgue privilegios de base de datos a el usuario o la cuenta de servicio de IAM.
  
  GRANT SELECT PRIVILEGES ON * TO "IAM_USERNAME";.
  
  Para obtener más información, consulta Otorga privilegios de base de datos a un usuario o una cuenta de servicio de IAM individual.

Otorga permiso executesql a la instancia de Cloud SQL

Para otorgar el permiso executesql a la instancia de Cloud SQL y habilitar la API de Cloud SQL Data, ejecuta el siguiente comando:

gcloud config set project PROJECT_ID
gcloud components update
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID de tu Google Cloud proyecto.
• INSTANCE_ID: Es el ID de tu instancia de Cloud SQL.

Para realizar los pasos de este instructivo, accede a Google Cloud y, luego, autentícate en la base de datos con la autenticación de IAM.

Crea un conjunto de contexto

Para crear un conjunto de contexto, sigue estos pasos:

1. En la Google Cloud consola de, ve a la página de Cloud SQL.

   Ir a Cloud SQL

2. Elige una instancia de la lista.

3. En el menú de navegación, haz clic en Cloud SQL Studio.

4. Accede a Studio con la autenticación de IAM.

5. En el panel Explorador, junto a Conjuntos de contexto, haz clic en Ver acciones.

6. Haz clic en Crear conjunto de contexto.

7. En Nombre del conjunto de contexto, proporciona un nombre único para el conjunto de contexto. El nombre del conjunto de contexto distingue mayúsculas de minúsculas y puede contener letras, números, guiones y guiones bajos.

8. Es opcional. En Descripción del conjunto de contexto, agrega una descripción para tu conjunto de contexto.

9. Haz clic en Crear.

Nota: La creación del primer conjunto de contexto en un proyecto puede tardar varios minutos.

Compila conjuntos de contexto

Después de crear un conjunto de contexto, sigue los pasos que se indican en Compila contextos con Gemini CLI para crear un archivo de conjunto de contexto. Luego, puedes editar tu conjunto de contexto para subir el archivo de conjunto de contexto.

Edita un conjunto de contexto

Para editar un conjunto de contexto, sigue estos pasos:

1. En la Google Cloud consola de, ve a la página de Cloud SQL.

   Ir a Cloud SQL

2. Elige una instancia de la lista.

3. En el menú de navegación, haz clic en Cloud SQL Studio.

4. Accede a Studio con la autenticación de Identity and Access Management.

5. En el panel Explorador, junto a Conjuntos de contexto, haz clic en Ver acciones.

6. Haz clic en Editar conjunto de contexto.

7. Opcional: Edita la Descripción del conjunto de contexto.

8. Haz clic en Examinar en la sección Subir archivo de conjunto de contexto y selecciona el archivo de conjunto de contexto.

9. Haz clic en Guardar.

Borra un conjunto de contexto

Para borrar un conjunto de contexto, sigue estos pasos:

1. En la Google Cloud consola de, ve a la página de Cloud SQL.

   Ir a Cloud SQL

2. Elige una instancia de la lista.

3. En el menú de navegación, haz clic en Cloud SQL Studio.

4. Accede a Studio con la autenticación de Identity and Access Management.

5. En el panel Explorador, junto a Conjuntos de contexto, haz clic en Ver acciones.

6. Haz clic en Borrar conjunto de contexto.

7. En el cuadro de diálogo de confirmación Borrar conjunto de contexto, ingresa el nombre del conjunto de contexto.

8. Haz clic en Confirmar para borrar el conjunto de contexto.

Nota: Antes de borrar una base de datos, debes borrar todos los conjuntos de contexto asociados con esa base de datos.

¿Qué sigue?

• Obtén más información sobre los conjuntos de contexto.
• Obtén información para probar un conjunto de contexto.
• Obtén información para compilar contextos con Gemini CLI.