Administra conjuntos de contexto en AlloyDB Studio

En este documento, se describe cómo crear conjuntos de contexto en AlloyDB para PostgreSQL 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 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:

Prepara un clúster, una instancia y una base de datos de AlloyDB para PostgreSQL

Asegúrate de tener acceso a un clúster y una instancia existentes de AlloyDB, o crea uno nuevo.
En este instructivo, se requiere que tengas una base de datos en tu instancia de AlloyDB. Para obtener más información, consulta Crea una base de datos.

Roles y permisos requeridos

Otorga permiso de executesql a la instancia de AlloyDB para PostgreSQL

Para otorgar el permiso executesql a la instancia de AlloyDB para PostgreSQL y establecer el parámetro de configuración de la instancia data_api_access en el valor ALLOW_DATA_API, usa el siguiente comando curl :
   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=dataApiAccess \
     -d '{
       "dataApiAccess": "ENABLED",
     }'
Reemplaza lo siguiente:
  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION: Es la región en la que se encuentra tu clúster de AlloyDB.
  • CLUSTER_ID: Es el ID de tu clúster de AlloyDB.
  • INSTANCE_ID: Es el ID de tu instancia de AlloyDB.
Para seguir 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 contextos

Para crear un conjunto de contexto, sigue estos pasos:

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

    Ir a AlloyDB

  2. Selecciona un clúster de la lista.

  3. En el menú de navegación, haz clic en AlloyDB 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 contextos, proporciona un nombre único para el conjunto de contextos. 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 Context set description, agrega una descripción para tu conjunto de contexto.

  9. Haz clic en Crear.

Crea conjuntos de contextos

Después de crear un conjunto de información contextual, sigue los pasos que se indican en Cómo compilar contextos con Gemini CLI para crear un archivo de conjunto de información contextual. Luego, puedes editar tu conjunto de contexto para subir el archivo correspondiente.

Cómo editar un conjunto de contextos

Para editar un conjunto de contexto, sigue estos pasos:

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

    Ir a AlloyDB

  2. Selecciona un clúster de la lista.

  3. En el menú de navegación, haz clic en AlloyDB 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 contextos

Para borrar un conjunto de contexto, sigue estos pasos:

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

    Ir a AlloyDB

  2. Selecciona un clúster de la lista.

  3. En el menú de navegación, haz clic en AlloyDB 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 el conjunto de contextos.

  7. En el 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.

¿Qué sigue?