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 em bancos de dados, execute a etapas neste documento:

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

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

3. Ativar o Gemini em bancos de dados.

4. Ative a API Recommender.

5. Ativar o consultor de índice (aplicável somente a 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 roles/billing.admin Cloud Identity and Access Management (IAM).

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

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

Console

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

   Acessar 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 já está disponível nas edições selecionadas projeto do Google Cloud a todos os usuários que tenham os papéis do IAM.

gcloud

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

   Activate Cloud Shell

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

3. Ativar 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 de uma forma projeto do Google Cloud, 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 Google Cloud já está disponível no projeto do Google Cloud a todos os usuários com o papéis do IAM necessários.

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

Nesta seção, descrevemos as etapas necessárias para conceder ao usuário do Cloud AI Companion e de consumidor do Service Usage e do IAM aos usuários.

Console

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

   Acessar IAM e administrador

2. Na coluna Principal, encontre a principal que você quer ativar o acesso ao Gemini e clicar em Edite o principal nessa linha.

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

4. Em Selecionar papel, escolha Usuário do Cloud AI Companion.

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, escolha um projeto.

3. Conceda o papel de usuário do Cloud AI Companion:

   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 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 esses papéis podem acessar Os recursos do Gemini para Google Cloud na Console do Google Cloud no projeto especificado. Para mais informações, consulte Informações gerais do Gemini para Google Cloud.

Ativar o Gemini em bancos de dados

Importante :a ativação do Gemini em bancos de dados pode levar de 24 a 48 horas.

Para ativar o Gemini nos bancos de dados de um projeto do Google Cloud, execute o etapas a seguir. Um administrador ou proprietário de projeto normalmente realiza essas etapas.

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

   Gemini para o Google Cloud

2. Clique em Gemini em bancos de dados.

   O painel Conheça o Gemini é mostrado.

3. Clique em Ver o Gemini em bancos de dados.

   A página Administrador do Gemini é mostrada.

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

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

5. Clique em Ler 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 aparecer na lista, ela já está ativada para seu projeto.

Ativar o consultor de índice

É possível ativar o consultor de índice para o AlloyDB para PostgreSQL, Cloud SQL para MySQL 8.0 e 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 o Query Insights aprimorado 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. Ativar recomendações de criação de índice no 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, confira 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 Cloud SQL para MySQL. O consultor de índice do Cloud SQL para MySQL usa dados de MySQL Performance Schema. Por padrão, o Cloud SQL ativa o MySQL Performance Schema em todo o MySQL 8.0 instâncias com mais de 15 GB de memória.

1. Antes de ativar o consultor de índice, ative o Query Insights na instância.
2. Se o esquema de desempenho do MySQL já estiver ativado Instâncias do Cloud SQL para MySQL e, para ativar o consultor de índice, execute o seguinte comando da CLI gcloud:

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 nos seus para as instâncias do Cloud SQL para MySQL e, em seguida, para ativar o consultor de índice, execute o seguinte Comando da CLI gcloud:

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

Substitua INSTANCE_NAME pelo nome da instância.

Cuidado: definindo a flag performance_schema como on reinicia a instância automaticamente.

Para mais informações sobre a configuração de sinalizações, consulte Configure as flags do banco de dados.

Cloud SQL para PostgreSQL

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

1. Antes de ativar o consultor de índice, ativar o Query Insights na instância.
2. Para ativar o consultor de índice para instâncias do Cloud SQL para PostgreSQL, execute o comando 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 a configuração de sinalizações, consulte Configure as flags do banco de dados.