Editar uma entidade no Console

Nesta página, você verá 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 pela API de Datastore, conforme descrito em Primeiros passos com a API de Datastore, ou do editor da entidade no Console do Cloud, conforme descrito em Guia de início rápido.

Como selecionar uma entidade para edição

  1. Acesse a página Entidades do Datastore no Console do Cloud.
    Acesse a página Entidades do Datastore
  2. 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.
  3. Clique em uma entidade para ser editada. A tela deve ser semelhante a esta:

    Editor de entidades

Como editar uma propriedade

  1. Em Propriedades, clique na propriedade a ser editada.
  2. No painel Editar propriedade, modifique o Nome, o Tipo e/ou o 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, consulte Propriedades excluídas.

    Como editar uma propriedade

  3. Clique em Concluído para fechar o painel Editar propriedade.

  4. Clique em Salvar para salvar a entidade.

    As alterações feitas em uma propriedade só serão armazenadas no banco de dados depois que você clicar em Salvar.

Como adicionar uma propriedade

  1. Clique no botão Adicionar propriedade.
  2. No painel Nova propriedade, especifique um nome para a propriedade.
  3. Selecione um tipo para os dados da propriedade.
  4. Opcionalmente, 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.

    Como adicionar uma propriedade

  6. Clique em Concluído para fechar o painel Nova propriedade.

  7. Clique em Salvar para salvar a entidade.

    As alterações feitas em uma propriedade só serão armazenadas no banco de dados depois que você clicar em Salvar.

Como excluir uma propriedade

Quando você salva uma entidade, todas as propriedades listadas como exclusão pendente serão excluídas permanentemente.

  1. Em Propriedades, passe o mouse sobre a propriedade a ser excluída. O ícone "Excluir" será exibido.

    Como excluir uma propriedade

  2. Clique no ícone "Excluir".

Como alternativa, em vez de passar o mouse sobre uma propriedade para ver o ícone "Excluir", você pode clicar em uma propriedade para abrir o painel Editar propriedade e, em seguida, clicar no ícone "Excluir".

Você não poderá desfazer a exclusão de uma propriedade depois de salvar a entidade. No entanto, se ainda não tiver salvado a entidade, você poderá cancelar uma exclusão pendente:

  • Em Propriedades, clique em Desfazer na propriedade com exclusão pendente.

    Como desfazer a exclusão de uma propriedade

Quando terminar de excluir uma propriedade ou cancelar uma exclusão pendente, clique em Salvar para salvar a entidade.

Como salvar uma entidade

  • Clique em Salvar.

    Como salvar uma entidade

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.

Propriedade da matriz

Ao inserir um JSON inválido no campo Valor, uma mensagem de erro aparecerá. Você não poderá salvar uma entidade se ela tiver um JSON inválido em uma propriedade da matriz.

Propriedades da entidade incorporada

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

Propriedade da entidade incorporada

Ao inserir um JSON inválido no campo Valor, uma mensagem de erro aparecerá. Você não poderá salvar uma entidade se ela tiver um JSON inválido em uma propriedade da entidade incorporada.

A seguir