Gerenciar conjuntos de contexto no AlloyDB Studio

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 projeto.

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

Antes de começar

Conclua os seguintes pré-requisitos 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.
Para este tutorial, é necessário ter 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

  • Ative a autenticação de banco de dados do Identity and Access Management (IAM) na instância definindo a flag de banco de dados alloydb.iam_authentication como on (alloydb.iam_authentication=on). Para mais informações, consulte Ativar e desativar a autenticação do IAM.
  • Adicione um usuário do IAM ou uma conta de serviço ao cluster no nível do banco de dados. Para mais informações, consulte Gerenciar a autenticação do IAM.
  • Conceda os papéis alloydb.databaseUser, serviceusage.serviceUsageConsumer e geminidataanalytics.queryDataUser ao usuário do IAM no nível do projeto. Para mais informações, consulte Adicionar vinculação de política do IAM a um projeto.
  • Para criar, fazer upload e gerenciar conjuntos de contexto, conceda o papel de Editor do Dataplex Catalog (roles/dataplex.catalogEditor) ou Administrador do Dataplex Catalog (roles/dataplex.catalogAdmin) ao usuário do IAM no nível do projeto. Para mais informações, consulte Permissões de conjuntos de contexto.

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",
     }'
Substitua:
  • PROJECT_ID: ID do seu projeto do Google Cloud .
  • LOCATION: 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.
Para realizar as etapas deste tutorial, faça login no Google Cloud e autentique-se no banco de dados usando a autenticação do IAM.

Criar um conjunto de contextos

Para criar um conjunto de contexto, siga estas etapas:

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

    Acessar o AlloyDB

  2. Selecione um cluster na lista.

  3. No menu de navegação, clique em AlloyDB 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, hifens e sublinhados. Os nomes precisam ter de 4 a 30 caracteres.

    O ID do conjunto de contextos é derivado do nome do conjunto, mas não é necessariamente idêntico. Para o ID do conjunto de contexto, o nome do conjunto é convertido em letras minúsculas, e os caracteres não alfanuméricos são substituídos pelo caractere -. Por exemplo, o nome do conjunto de contexto querydata_e2e_test tem o ID querydata-e2e-test.

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

  9. Opcional. Para fazer upload de um arquivo de conjunto de contexto, clique em Procurar na seção Fazer upload do arquivo de conjunto de contexto e selecione o arquivo.

  10. 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 contexto, siga estas etapas:

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

    Acessar o AlloyDB

  2. Selecione um cluster na lista.

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

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

  5. Clique em Ver ações ao lado do conjunto de contexto que você quer editar.

  6. Clique em Editar conjunto de contexto.

  7. Opcional. Editar a descrição do conjunto de contextos.

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

  9. Clique em Salvar.

Excluir um conjunto de contexto

Para excluir um conjunto de contexto, siga estas etapas:

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

    Acessar o AlloyDB

  2. Selecione um cluster na lista.

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

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

  5. Clique em Ver ações ao lado do conjunto de contexto que você quer excluir.

  6. Clique em Excluir conjunto de contexto.

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

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

A seguir