Gerenciar conjuntos de contexto no Cloud SQL para PostgreSQL Studio

MySQL   |  PostgreSQL   |  SQL Server

Visualizar

Este recurso está sujeito aos "Termos da Pré-GA" nos Termos Gerais de Serviço dos Termos Específicos de Serviço e aos Termos Adicionais para Produtos Pré-lançamento de IA Generativa. Os 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 das fases de lançamento.

Para informações sobre o acesso a essa versão, consulte a página de solicitação de acesso.

Este documento descreve como criar conjuntos de contexto no Cloud SQL para PostgreSQL Studio usando um arquivo de conjunto de contexto. Os nomes dos conjuntos de contexto precisam ser exclusivos em um banco de dados.

Para saber mais sobre conjuntos de contexto, consulte Visão geral dos conjuntos de contexto.

Antes de começar

Conclua os pré-requisitos a seguir antes de criar um agente.

Ativar serviços obrigatórios

Ative os seguintes serviços para seu projeto:

• API Data Analytics com Gemini
• API Gemini para o Google Cloud
• API Dataplex Universal Catalog

Preparar uma instância do Cloud SQL

Verifique se você tem acesso a uma instância do Cloud SQL ou crie uma nova. Para mais informações, consulte Criar instâncias para o Cloud SQL.

Este tutorial exige que você tenha um banco de dados na sua instância do Cloud SQL. Para mais informações, consulte Criar um banco de dados na instância do Cloud SQL.

Papéis e permissões necessárias

• Adicione um usuário do IAM ou uma conta de serviço à instância. Para mais informações, consulte Gerenciar usuários com autenticação de banco de dados do IAM para Cloud SQL.
• Conceda os papéis cloudsql.studioUser, cloudsql.instanceUser e geminidataanalytics.queryDataUser ao usuário do IAM no nível do projeto. Para mais informações, consulte Adicionar uma vinculação de política do IAM a um projeto.
• Você também precisa conceder privilégios de banco de dados somente leitura a um usuário do IAM ou conta de serviço fazendo login como um usuário com privilégios de superusuário, como o usuário postgres.
  
  GRANT SELECT ON ALL TABLES IN SCHEMA public TO USER_NAME;
  
  Substitua USER_NAME pelo endereço de e-mail do usuário. É preciso usar aspas ao redor do e-mail porque ele contém caracteres especiais (@ e .).
  
  Para mais informações, consulte Conceder privilégios de banco de dados a um usuário individual do IAM ou a uma conta de serviço.

Conceder permissão executesql à instância do Cloud SQL

Para conceder a permissão executesql à instância do Cloud SQL e ativar a API Data do Cloud SQL, execute o seguinte comando:

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

Substitua o seguinte:

• PROJECT_ID: o ID do seu projeto do Google Cloud .
• INSTANCE_ID: o ID da sua instância do Cloud SQL.

Para realizar as etapas deste tutorial, faça login em Google Cloud e autentique o banco de dados usando a autenticação do IAM.

Criar um conjunto de contextos

Para criar um conjunto de contextos, siga estas etapas:

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

   Acessar o Cloud SQL

2. Selecione uma instância na lista.

3. No menu de navegação, clique em Cloud SQL Studio.

4. Faça login no Studio usando a autenticação do IAM.

5. No painel "Explorer", ao lado de Conjuntos de contexto, clique em Ver ações.

6. Clique em Criar conjunto de contexto.

7. Em Nome do conjunto de contexto, forneça um nome exclusivo. O nome do conjunto de contexto diferencia maiúsculas de minúsculas e pode conter letras, números, hífens e sublinhados.

8. Opcional. Em Descrição do conjunto de contexto, adicione uma descrição para o conjunto de contexto.

9. Clique em Criar.

Observação: a criação do primeiro conjunto de contextos em um projeto pode levar vários minutos.

Criar conjuntos de contexto

Depois de criar um conjunto de contextos, siga as etapas em Criar contextos usando a CLI do Gemini para criar um arquivo de conjunto de contextos. Em seguida, edite o conjunto de contexto para fazer upload do arquivo.

Editar um conjunto de contextos

Para editar um conjunto de contextos, siga estas etapas:

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

   Acessar o Cloud SQL

2. Selecione uma instância na lista.

3. No menu de navegação, clique em Cloud SQL Studio.

4. Faça login no Studio usando a autenticação do Identity and Access Management.

5. No painel "Explorer", ao lado de Conjuntos de contexto, clique em Ver ações.

6. Clique em Editar conjunto de contexto.

7. Opcional: edite a Descrição do conjunto de contexto.

8. Clique em Procurar na seção Fazer upload do arquivo de conjunto de contexto e selecione o arquivo.

9. Clique em Salvar.

Excluir um conjunto de contextos

Para excluir um conjunto de contextos, siga estas etapas:

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

   Acessar o Cloud SQL

2. Selecione uma instância na lista.

3. No menu de navegação, clique em Cloud SQL Studio.

4. Faça login no Studio usando a autenticação do Identity and Access Management.

5. No painel "Explorer", ao lado de Conjuntos de contexto, clique em Ver ações.

6. Clique em Excluir conjunto de contextos.

7. Na caixa de diálogo de confirmação Excluir conjunto de contexto, insira o nome do conjunto.

8. Clique em Confirmar para excluir o conjunto de contextos.

Observação: antes de excluir um banco de dados, é necessário excluir todos os conjuntos de contexto associados a ele.

A seguir

• Saiba mais sobre conjuntos de contexto.
• Saiba como testar um conjunto de contexto.
• Saiba como criar contextos usando a CLI do Gemini.