Este documento descreve como criar conjuntos de contexto no AlloyDB 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:Preparar um cluster, uma instância e um banco de dados do AlloyDB para PostgreSQL
Verifique se você tem acesso a um cluster e uma instância do AlloyDB ou crie um.Este tutorial exige que você tenha um banco de dados na sua instância do AlloyDB. Para mais informações, consulte Criar um banco de dados.
Papéis e permissões necessárias
- Adicione um usuário ou uma conta de serviço do Identity and Access Management (IAM) ao cluster no nível do banco de dados. Para mais informações, consulte Gerenciar usuários do banco de dados.
- Conceda os papéis
alloydb.databaseUser,serviceusage.serviceUsageConsumeregeminidataanalytics.queryDataUserao 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.
Conceder permissão executesql à instância do AlloyDB para PostgreSQL
Para conceder a permissão executesql à instância do AlloyDB para PostgreSQL e definir a configuração da instância data_api_access como o valor ALLOW_DATA_API, use o seguinte comando curl :
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth 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",
}'
PROJECT_ID: o ID do seu projeto do Google Cloud .LOCATION: a região em que o cluster do AlloyDB está localizado.CLUSTER_ID: o ID do seu cluster do AlloyDB.INSTANCE_ID: o ID da sua instância do AlloyDB.
Criar um conjunto de contextos
Para criar um conjunto de contextos, siga estas etapas:
No console Google Cloud , acesse a página do AlloyDB.
Selecione um cluster na lista.
No menu de navegação, clique em AlloyDB Studio.
Faça login no Studio usando a autenticação do IAM.
No painel "Explorer", ao lado de Conjuntos de contexto, clique em Ver ações.
Clique em Criar conjunto de contexto.
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.
Opcional. Em Descrição do conjunto de contexto, adicione uma descrição para o conjunto de contexto.
Clique em Criar.
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:
No console Google Cloud , acesse a página do AlloyDB.
Selecione um cluster na lista.
No menu de navegação, clique em AlloyDB Studio.
Faça login no Studio usando a autenticação do Identity and Access Management.
No painel "Explorer", ao lado de Conjuntos de contexto, clique em Ver ações.
Clique em Editar conjunto de contexto.
Opcional: edite a Descrição do conjunto de contexto.
Clique em Procurar na seção Fazer upload do arquivo de conjunto de contexto e selecione o arquivo.
Clique em Salvar.
Excluir um conjunto de contextos
Para excluir um conjunto de contextos, siga estas etapas:
No console Google Cloud , acesse a página do AlloyDB.
Selecione um cluster na lista.
No menu de navegação, clique em AlloyDB Studio.
Faça login no Studio usando a autenticação do Identity and Access Management.
No painel "Explorer", ao lado de Conjuntos de contexto, clique em Ver ações.
Clique em Excluir conjunto de contextos.
Na caixa de diálogo de confirmação Excluir conjunto de contexto, insira o nome do conjunto.
Clique em Confirmar para excluir o conjunto de contextos.
A seguir
- Saiba mais sobre conjuntos de contexto.
- Saiba como testar um conjunto de contexto.
- Saiba como criar contextos usando a CLI do Gemini.