Configurar o Gemini em bancos de dados

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Para configurar o Gemini nos bancos de dados, siga as etapas neste documento:

1. Ative a API Gemini para o Google Cloud em um projeto do Google Cloud. Geralmente, essa etapa é realizada por um administrador.

2. Conceda papéis do Identity and Access Management (IAM) em um projeto do Google Cloud. Geralmente, essa etapa é realizada por um administrador.

3. Ative o Gemini nos bancos de dados.

4. Ative a API Recommender.

5. Ativar o consultor de índice (aplicável apenas ao AlloyDB para PostgreSQL, Cloud SQL para PostgreSQL e Cloud SQL para MySQL).

Antes de começar

Para ativar o Gemini em bancos de dados, você precisa ter o papel do Identity and Access Management (IAM) roles/billing.admin.

Ativar a API Gemini para Google Cloud em um projeto do Google Cloud

Esta seção descreve as etapas necessárias para ativar a API Gemini para Google Cloud em um projeto do Google Cloud.

Console

1. Para ativar a API Gemini para Google Cloud, acesse a página Gemini para Google Cloud.

   Acesse o Gemini para Google Cloud

2. No seletor de projetos, escolha um projeto.

3. Clique em Ativar.

   A página é atualizada e mostra o status Ativado. O Gemini agora está disponível no projeto selecionado do Google Cloud para todos os usuários que têm as funções necessárias do IAM.

gcloud

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

   Activate Cloud Shell

2. No menu do seletor de projetos, selecione um projeto.

3. Ative a API Gemini para Google Cloud para Gemini usando o comando gcloud services enable:

   gcloud services enable cloudaicompanion.googleapis.com
   

   Se você quiser ativar a API Gemini para Google Cloud em um projeto do Google Cloud diferente, adicione o parâmetro --project:

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

   Substitua PROJECT_ID pelo ID do projeto do Google Cloud.

   O resultado será assim:

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

O Gemini para o Google Cloud agora está disponível no projeto especificado do Google Cloud para todos os usuários que têm as funções de IAM necessárias.

Conceder papéis do IAM em um projeto do Google Cloud

Esta seção descreve as etapas necessárias para conceder aos usuários os papéis de IAM do usuário do Gemini para o Google Cloud e do consumidor de uso do serviço.

Console

1. Para conceder os papéis do IAM necessários para usar o Gemini, acesse a página IAM e administrador.

   Acessar IAM e administrador

2. Na coluna Principal, encontre uma principal para a qual você quer dar acesso ao Gemini e clique em Editar principal nessa linha.

3. No painel Editar acesso, clique em Adicionar outro papel.

4. Em Selecionar um papel, selecione Usuário do Gemini para o Google Cloud.

5. Clique em Adicionar outro papel e selecione Consumidor do Service Usage.

6. Clique em Salvar.

gcloud

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

   Activate Cloud Shell

2. No menu do seletor de projetos, selecione um projeto.

3. Conceda a função de usuário do Gemini para o Google Cloud:

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

   Substitua PRINCIPAL pelo identificador do principal. O identificador tem o formato user|group|serviceAccount:email ou domain:domain, por exemplo, user:[e-mail], group:[e-mail], serviceAccount:[e-mail] ou domain:example.domain.com.

   A saída é uma lista de vinculações de política que inclui o seguinte:

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

4. Conceda o papel de Consumidor do Service Usage:

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

   A saída é uma lista de vinculações de política que inclui o seguinte:

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

Para mais informações, consulte Conceder um único papel e gcloud projects add-iam-policy-binding.

Todos os usuários que receberam essas funções podem acessar os recursos do Gemini para o Google Cloud no console do Google Cloud no projeto especificado. Para mais informações, consulte Visão geral do Gemini para o Google Cloud.

Ativar o Gemini em bancos de dados

Importante: pode levar de 24 a 48 horas para ativar o Gemini nos bancos de dados.

Para ativar o Gemini em bancos de dados em um projeto do Google Cloud, siga estas etapas. Um administrador ou proprietário do projeto geralmente realiza essas etapas.

1. No console do Google Cloud, acesse a página Gemini para Google Cloud.

   Gemini para o Google Cloud

2. Clique em Gemini nos bancos de dados.

   O painel Explorar Gemini é exibido.

3. Clique em Ativar o Gemini nos bancos de dados.

   A página Administrador do Gemini é exibida.

4. Escolha a conta de faturamento em que você quer ativar o Gemini em bancos de dados e clique em Continuar para a página do Gemini em bancos de dados.

   A página Gemini em bancos de dados é exibida.

5. Clique em Revisar os termos e ativar.

   A página Ativar o Gemini em bancos de dados é exibida.

6. Clique em Comprar para ativar o Gemini em bancos de dados.

Ative a API Recommender

Enable the Recommender API.

Enable the API

Se a API Recommender não estiver listada, ela já estará ativada para seu projeto.

Ativar o consultor de índice

É possível ativar o consultor de índice para o AlloyDB para PostgreSQL, instâncias do Cloud SQL para MySQL 8.0 e instâncias do Cloud SQL para PostgreSQL 12 e mais recentes.

AlloyDB para PostgreSQL

As etapas a seguir descrevem como ativar o consultor de índice para o AlloyDB para PostgreSQL.

1. Antes de ativar o consultor de índice, ative os Query Insights aprimorados na instância.

2. No console do Google Cloud, acesse a página Clusters.

   Acessar Clusters

3. Na lista de clusters e instâncias, clique em uma instância.
4. Clique em Query Insights.
5. Escolha o banco de dados e o usuário.
6. Clique em Edit Settings.
7. Para ativar as recomendações de criação de índice na página Query Insights de um cluster, selecione Ativar recomendações.
8. Salve as alterações.

Para mais informações sobre como usar o consultor de índice no AlloyDB para PostgreSQL, consulte Usar o consultor de índice com insights de consulta.

Cloud SQL para MySQL

As etapas a seguir descrevem como ativar o consultor de índice para o Cloud SQL para MySQL. O consultor de índice do Cloud SQL para MySQL usa dados do MySQL Performance Schema. Por padrão, o Cloud SQL ativa o esquema de desempenho do MySQL em todas as instâncias do MySQL 8.0 com mais de 15 GB de memória.

1. Antes de ativar o consultor de índice, ative os insights de consulta na instância.
2. Se você já tiver o esquema de desempenho do MySQL ativado nas instâncias do Cloud SQL para MySQL, execute o comando da CLI gcloud abaixo para ativar o consultor de índice:

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

Substitua INSTANCE_NAME pelo nome da instância.

3. Se o esquema de desempenho do MySQL não estiver ativado nas instâncias do Cloud SQL para MySQL, execute o comando da CLI gcloud abaixo para ativar o consultor de índice:

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

Substitua INSTANCE_NAME pelo nome da instância.

Atenção: definir a flag performance_schema como on reinicia a instância automaticamente.

Para mais informações sobre como configurar flags, consulte Configurar flags do banco de dados.

Cloud SQL para PostgreSQL

As etapas a seguir descrevem como ativar o consultor de índice para o Cloud SQL para PostgreSQL.

1. Antes de ativar o consultor de índice, ative os insights de consulta na instância.
2. Para ativar o consultor de índice para instâncias do Cloud SQL para PostgreSQL, execute o seguinte comando da Google Cloud CLI:

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

Substitua INSTANCE_NAME pelo nome da instância.

Para mais informações sobre como configurar flags, consulte Configurar flags do banco de dados.