Neste documento, descrevemos 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 a 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 novo.Este tutorial exige que você tenha um banco de dados na 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 application-default 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 doprojeto. Google CloudLOCATION: a região em que o cluster do AlloyDB está localizado.CLUSTER_ID: o ID do cluster do AlloyDB.INSTANCE_ID: o ID da instância do AlloyDB.
Criar um conjunto de contexto
Para criar um conjunto de contexto, siga estas etapas:
No Google Cloud console, 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 contexto, siga as etapas em Criar contextos usando a CLI do Gemini para criar um arquivo de conjunto de contexto. Em seguida, edite o conjunto de contexto para fazer upload do arquivo.
Editar um conjunto de contexto
Para editar um conjunto de contexto, siga estas etapas:
No Google Cloud console, 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 de conjunto de contexto.
Clique em Salvar.
Excluir um conjunto de contexto
Para excluir um conjunto de contexto, siga estas etapas:
No Google Cloud console, 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 contexto.
Na caixa de diálogo de confirmação Excluir conjunto de contexto, insira o nome do conjunto de contexto.
Clique em Confirmar para excluir o conjunto de contexto.
A seguir
- Saiba mais sobre conjuntos de contexto.
- Saiba como testar um conjunto de contexto.
- Saiba como criar contextos usando a CLI do Gemini.