Editar uma entidade no console

Nesta página, descrevemos como editar uma entidade usando o console do Google Cloud.

Para aprender como modificar uma entidade de maneira programática, veja Como atualizar uma entidade.

Antes de começar

Nesta página, presume-se que você já tenha criado uma entidade armazenada no Firestore no modo Datastore. É possível criar uma entidade por meio da API Datastore, conforme descrito em Como começar a usar a API Datastore, ou pelo editor de entidades no Console do Google Cloud, conforme descrito no Guia de início rápido.

Selecione uma entidade para editar

  1. No Console do Google Cloud, acesse a página Bancos de Dados.

    Acessar "Bancos de dados"

  2. Selecione o banco de dados necessário na lista de bancos de dados.

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

  4. Localize a entidade que você quer editar especificando o namespace, o tipo e/ou os filtros dos valores de propriedade. Para saber como, veja Executar uma consulta.

  5. Clique no Nome/ID de uma entidade. A tela será semelhante a esta:

    A página de visão geral da entidade mostrando informações sobre uma entidade.

Editar uma propriedade

  1. Abra a página Editar entidade de uma entidade. Em Propriedades, clique em Editar na propriedade que você quer editar.

  2. No painel Editar propriedade, modifique o Nome, Tipo ou Valor da propriedade. Você também pode especificar se a propriedade é ou não indexada. Para saber mais sobre o impacto da inclusão ou exclusão de uma propriedade de índices, veja Propriedades excluídas.

    Clique no botão de edição para modificar uma propriedade.

  3. Clique em Concluído. O painel Editar propriedade é fechado, e a tabela de propriedades mostra as mudanças. As alterações não serão confirmadas no banco de dados até que você clique em Salvar. A tabela de propriedades destaca as alterações não confirmadas com um ponto azul ao lado do nome da propriedade.

  4. Faça outras mudanças em outras propriedades. Ao concluir as edições, clique em Salvar para confirmar as mudanças no banco de dados.

    O console confirma as mudanças e leva você de volta à página do Datastore Studio.

Adicionar uma propriedade

  1. Abra a página Editar entidade de uma entidade. Clique em Adicionar propriedade.
  2. No painel Adicionar uma propriedade, especifique um nome para a propriedade.
  3. Selecione um tipo para os dados da propriedade.
  4. Especifique um valor para a propriedade.

  5. Especifique se a propriedade é indexada. Para aprender sobre o impacto da inclusão ou exclusão de uma propriedade de índices, veja Propriedades excluídas.

    O painel para adicionar uma propriedade.

  6. Clique em Adicionar. O painel Adicionar uma propriedade será fechado, e a tabela de propriedades exibirá as alterações. As alterações não serão confirmadas no banco de dados até que você clique em Salvar. A tabela de propriedades destaca as alterações não confirmadas com um ponto azul ao lado do nome da propriedade.

  7. Faça outras mudanças em outras propriedades. Ao concluir as edições, clique em Salvar para confirmar as mudanças no banco de dados.

    O console confirma as mudanças e leva você de volta à página do Datastore Studio.

Excluir uma propriedade

  1. Abra a página Editar entidade de uma entidade. Em Propriedades, clique em Excluir na propriedade que você quer excluir.

    O botão "Excluir" na tabela de propriedades.

  2. A tabela de propriedades vai mostrar as mudanças. As alterações não serão confirmadas no banco de dados até que você clique em Salvar. A tabela de propriedades destaca exclusões de propriedades não confirmadas com nomes e valores de propriedade riscados.

    É possível desfazer uma exclusão não confirmada clicando em Restaurar na linha da tabela da propriedade.

  3. Faça outras mudanças em outras propriedades. Ao concluir as edições, clique em Salvar para confirmar as mudanças no banco de dados.

Propriedades complexas

O editor de entidades é compatível com propriedades de tipos complexos como Array e Embedded entity.

Propriedades da matriz

Ao adicionar ou modificar o valor de uma propriedade Array, forneça um valor no formato JSON.

Um exemplo de JSON válido para uma propriedade de matriz.

Ao inserir um JSON inválido no campo Valor, uma mensagem de erro aparecerá. Não será possível adicionar a propriedade se o JSON for inválido.

Propriedades da entidade incorporada

Ao adicionar ou modificar o valor de uma propriedade Embedded entity, forneça um valor no formato JSON.

Exemplo de JSON válido para uma propriedade de entidade incorporada

Ao inserir um JSON inválido no campo Valor, uma mensagem de erro aparecerá. Não será possível adicionar a propriedade se o JSON for inválido.

A seguir