Configura Gemini en bases de datos

Vista previa

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para configurar Gemini en bases de datos, sigue los pasos que se indican en este documento:

1. Habilita la API de Gemini para Google Cloud en un proyecto de Google Cloud. Por lo general, un administrador realiza este paso.

2. Otorga roles de Identity and Access Management (IAM) en un proyecto de Google Cloud. Por lo general, un administrador realiza este paso.

3. Activa Gemini en bases de datos.

4. Habilita la API del Recomendador.

5. Activa el asesor de índices (solo se aplica a AlloyDB para PostgreSQL, Cloud SQL para PostgreSQL y Cloud SQL para MySQL).

Antes de comenzar

Para activar Gemini en Bases de datos, debes tener el rol de Identity and Access Management (IAM) roles/billing.admin.

Habilita la API de Gemini para Google Cloud en un proyecto de Google Cloud

En esta sección, se describen los pasos necesarios para habilitar la API de Gemini para Google Cloud en un proyecto de Google Cloud.

Console

1. Para habilitar la API de Gemini para Google Cloud, ve a la página de Gemini para Google Cloud.

   Ir a Gemini para Google Cloud

2. En el selector de proyectos, elige un proyecto.

3. Haz clic en Habilitar.

   La página se actualiza y muestra el estado Enabled. Gemini ahora está disponible en el proyecto de Google Cloud seleccionado para todos los usuarios que tengan los roles de IAM requeridos.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. En el menú de selección de proyectos, elige un proyecto.

3. Habilita la API de Gemini para Google Cloud con el comando gcloud services enable:

   gcloud services enable cloudaicompanion.googleapis.com
   

   Si quieres habilitar la API de Gemini para Google Cloud en un proyecto de Google Cloud diferente, agrega el parámetro --project:

   gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
   

   Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud.

   El resultado es similar a este:

   Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
   Operation finished successfully.
   

Gemini para Google Cloud ahora está disponible en el proyecto de Google Cloud especificado para todos los usuarios que tengan los roles de IAM requeridos.

Otorga roles de IAM en un proyecto de Google Cloud

En esta sección, se describen los pasos necesarios para otorgar a los usuarios los roles de IAM de usuario y consumidor de Gemini para Google Cloud.

Console

1. Para otorgar los roles de IAM necesarios para usar Gemini, ve a la página IAM y administración.

   Ir a IAM y administración

2. En la columna Principal, busca una principal para la que deseas otorgar acceso a Gemini y, luego, haz clic en Editar principal en esa fila.

3. En el panel Editar permisos, haz clic en Agregar otra función.

4. En Selecciona un rol, selecciona Usuario de Gemini para Google Cloud.

5. Haz clic en Agregar otro rol y selecciona Consumidor de Service Usage.

6. Haz clic en Guardar.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. En el menú de selección de proyectos, elige un proyecto.

3. Otorga el rol de usuario de Gemini para Google Cloud:

   gcloud projects add-iam-policy-binding  PROJECT_ID \
       --member=PRINCIPAL --role=roles/cloudaicompanion.user
   

   Reemplaza PRINCIPAL por el identificador de la principal. El identificador tiene la forma user|group|serviceAccount:email o domain:domain, por ejemplo: user:[e-mail], group:[e-mail], serviceAccount:[e-mail] odomain:example.domain.com.

   El resultado es una lista de vinculaciones de políticas que incluye lo siguiente:

   - members:
     - user:PRINCIPAL
     role: roles/cloudaicompanion.user
   

4. Otorga el rol de consumidor de Service Usage:

   gcloud projects add-iam-policy-binding  PROJECT_ID \
       --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer
   

   El resultado es una lista de vinculaciones de políticas que incluye lo siguiente:

   - members:
     - user:PRINCIPAL
     role: roles/serviceusage.serviceUsageConsumer
   

Para obtener más información, consulta Otorga un solo rol y gcloud projects add-iam-policy-binding.

Todos los usuarios a los que se les otorgaron estos roles pueden acceder a las funciones de Gemini para Google Cloud en la consola de Google Cloud dentro del proyecto especificado. Para obtener más información, consulta la descripción general de Gemini para Google Cloud.

Activa Gemini en bases de datos

Importante: La activación de Gemini en Bases de datos puede tardar entre 24 y 48 horas.

Para activar Gemini en Bases de datos en un proyecto de Google Cloud, sigue estos pasos: Por lo general, un administrador o propietario del proyecto realiza estos pasos.

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

   Gemini para Google Cloud

2. Haz clic en Gemini en bases de datos.

   Se mostrará el panel Explorar Gemini.

3. Haz clic en Obtener Gemini en bases de datos.

   Se mostrará la página Administrador de Gemini.

4. Elige la cuenta de facturación para la que deseas activar Gemini en Bases de datos y haz clic en Continuar a la página Gemini en Bases de datos.

   Se muestra la página Gemini en bases de datos.

5. Haz clic en Revisar los términos y activar.

   Se mostrará la página Activar Gemini en bases de datos.

6. Haz clic en Comprar para activar Gemini en bases de datos.

Habilita la API de recomendador

Enable the Recommender API.

Enable the API

Si la API de Recommender no aparece en la lista, significa que ya está habilitada para tu proyecto.

Cómo activar el asesor de índices

Puedes activar el asesor de índices para AlloyDB para PostgreSQL, instancias de Cloud SQL para MySQL 8.0 y de Cloud SQL para PostgreSQL 12 y versiones posteriores.

AlloyDB para PostgreSQL

En los siguientes pasos, se describe cómo activar el asesor de índices para AlloyDB para PostgreSQL.

1. Antes de activar el asesor de índices, habilita las Estadísticas de consultas mejoradas en la instancia.

2. En la consola de Google Cloud, ve a la página Clústeres.

   Ir a los clústeres

3. En la lista de clústeres e instancias, haz clic en una instancia.
4. Haz clic en Estadísticas de consultas.
5. Elige la base de datos y el usuario.
6. Haga clic en Edit Settings.
7. Para activar las recomendaciones de creación de índices en la página Estadísticas de consultas de un clúster, selecciona Habilitar recomendaciones.
8. Guarda los cambios.

Para obtener más información sobre cómo usar el asesor de índices en AlloyDB para PostgreSQL, consulta Cómo usar el asesor de índices con estadísticas de consultas.

Cloud SQL para MySQL

En los siguientes pasos, se describe cómo habilitar el asesor de índices para Cloud SQL para MySQL. El asesor de índices de Cloud SQL para MySQL usa datos del esquema de rendimiento de MySQL. De forma predeterminada, Cloud SQL habilita el esquema de rendimiento de MySQL en todas las instancias de MySQL 8.0 que tienen más de 15 GB de memoria.

1. Antes de habilitar el asesor de índice, habilita las Estadísticas de consultas en la instancia.
2. Si ya tienes habilitado el esquema de rendimiento de MySQL en tus instancias de Cloud SQL para MySQL, para habilitar el asesor de índices, ejecuta el siguiente comando de gcloud CLI:

gcloud sql instances patch INSTANCE_NAME \
    --database-flags=cloudsql_index_advisor=on

Reemplaza INSTANCE_NAME por el nombre de tu instancia.

3. Si no tienes habilitado el esquema de rendimiento de MySQL en tus instancias de Cloud SQL para MySQL, para habilitar el asesor de índices, ejecuta el siguiente comando de gcloud CLI:

gcloud sql instances patch INSTANCE_NAME \
   --database-flags=cloudsql_index_advisor=on,performance_schema=on

Reemplaza INSTANCE_NAME por el nombre de tu instancia.

Precaución: Si configuras la marca performance_schema en on, se reiniciará tu instancia automáticamente.

Para obtener más información sobre la configuración de marcas, consulta Configura marcas de base de datos.

Cloud SQL para PostgreSQL

En los siguientes pasos, se describe cómo habilitar el asesor de índices para Cloud SQL para PostgreSQL.

1. Antes de habilitar el asesor de índice, habilita las Estadísticas de consultas en la instancia.
2. Para habilitar el asesor de índices para instancias de Cloud SQL para PostgreSQL, ejecuta el siguiente comando de Google Cloud CLI:

gcloud sql instances patch INSTANCE_NAME \
   --database-flags=cloudsql.enable_index_advisor=on
    

Reemplaza INSTANCE_NAME por el nombre de tu instancia.

Para obtener más información sobre la configuración de marcas, consulta Configura marcas de base de datos.