Gerenciar conjuntos de contexto no Spanner Studio

Neste documento, descrevemos como criar conjuntos de contexto no Spanner Studio usando um arquivo de conjunto de contexto. Quando você cria um conjunto de contexto no Spanner Studio, ele é armazenado no grupo de conjuntos de contexto default do projeto para a região selecionada e vinculado ao banco de dados atual. Os nomes dos conjuntos de contexto (e os IDs derivados deles) precisam ser exclusivos no grupo de conjuntos de contexto default do projeto para uma determinada região, em todos os bancos de dados e instâncias. No Spanner Studio, a criação de um conjunto de contexto com um nome cujo ID derivado já existe falha na validação. Para substituir o conteúdo mantendo as associações de banco de dados, edite o conjunto de contexto atual. O upload direto pelo agente de engenharia de contexto ou pela API Dataplex com um ID de conjunto de contexto atual substitui o conteúdo e, se especificado, as associações de banco de dados.

A lista Conjuntos de contexto no Spanner Studio mostra apenas os conjuntos de contexto no grupo de conjuntos de contexto default em todas as regiões com disponibilidade que estão vinculadas ao banco de dados atual. Os conjuntos de contexto criados para outro banco de dados ou criados pela API sem vincular o recurso de banco de dados em databases (ou em um grupo de conjuntos de contexto personalizado) não aparecem na lista do Spanner Studio.

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 uma instância do Spanner

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 Aplicar papéis do IAM.
  • Conceda os papéis roles/spanner.databaseReader, roles/serviceusage.serviceUsageConsumer e roles/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.
  • Conceda papéis e permissões ao usuário do IAM para envolvidos no projeto para os bancos de dados necessários.

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

    Acessar o Spanner

  2. Selecione uma instância na lista e, em seguida, um banco de dados.

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

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

  5. Clique em Criar conjunto de contexto.

  6. Em Nome do conjunto de contexto, forneça um nome exclusivo. No Spanner Studio, o nome precisa ter de 4 a 30 caracteres e não pode começar com espaços em branco. O Studio deriva o ID do conjunto de contexto convertendo o nome em letras minúsculas e substituindo caracteres não alfanuméricos por hifens (-). O ID do conjunto de contexto derivado precisa ser exclusivo no grupo de conjuntos de contexto default do projeto para a região selecionada. Por exemplo, o nome do conjunto de contexto querydata_e2e_test tem o ID querydata-e2e-test. Quando você faz upload de um conjunto de contexto diretamente usando o agente de engenharia de contexto ou a API Dataplex, o ID do conjunto de contexto diferencia maiúsculas de minúsculas, não pode conter barras (/) e não é restrito a 4 a 30 caracteres ou caracteres alfanuméricos, hifens e sublinhados.

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

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

  9. Opcional. Para escolher uma região para o conjunto de contexto, clique em Mostrar opções avançadas e selecione uma região em Selecionar um local (o padrão é us-east1 em cada criação). Se você escolher uma região diferente de us-east1, selecione-a antes de inserir o nome do conjunto de contexto para que o Spanner Studio valide a exclusividade do nome nessa região.

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

    Acessar o Spanner

  2. Selecione uma instância na lista e, em seguida, um banco de dados.

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

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

  5. Clique em Editar conjunto de contexto.

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

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

  8. 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 Spanner.

    Acessar o Spanner

  2. Selecione uma instância na lista e, em seguida, um banco de dados.

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

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

  5. Clique em Excluir conjunto de contexto.

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

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

A seguir