Nesta página, apresentamos um breve exercício de criação de um aplicativo TaskList de linha de comando com a API Firestore no modo Datastore. O aplicativo TaskList armazena, lista, atualiza e remove tarefas.
Pré-requisitos
- Capacidade de gravar e executar um aplicativo de linha de comando nas linguagens de programação usadas neste tópico
Além de um entendimento básico de como desenvolver aplicativos, é necessário fazer o download e instalar outras bibliotecas antes de tentar este tutorial. - Um projeto do Google Cloud com a API Datastore mode ativada
Os aplicativos que usam o modo Datastore estão associados a uma projeto do Google Cloud com o API do modo Datastore ativada. Esse projeto fornece as credenciais de autenticação que você usa no aplicativo para que ele seja identificado pelo Google e autorizado a usar a API Datastore mode.
Siga estas instruções para criar um projeto, ative a API Datastore mode para ele e configure seu ambiente de desenvolvimento local com credenciais de autenticação usando o comandogcloud auth login
. Anote o código do projeto, ele será usado posteriormente.
Instalação e configuração
Instale bibliotecas de cliente e defina as configurações adicionais para o ambiente de desenvolvimento.
C#
- Verifique se você tem o Visual Studio (versão 2013 ou posterior) instalado.
- Faça o download do aplicativo de amostra TaskList no repositório de amostras.
- Extraia os arquivos do zip em um diretório na pasta Documentos.
- No Visual Studio, abra o arquivo
dotnet-docs-samples-master\datastore\api\Datastore.sln
. - Na janela Gerenciador de soluções do Visual Studio, clique com o botão direito do mouse em TaskList. projeto e escolha Definir como projeto de inicialização.
- Clique com o botão direito do mouse no projeto TaskList novamente e escolha Propriedades.
Na janela Properties, clique em Debug e digite o ID do o projeto do Google Cloud na caixa Argumentos da linha de comando:.
Clique em Arquivo e, em seguida, em Salvar para salvar suas alterações.
Execute o aplicativo. Pressione F5 no teclado.
Go
Clone o aplicativo de amostra TaskList.
go get github.com/GoogleCloudPlatform/golang-samples/datastore/tasks
Altere os diretórios em que você clonou a amostra:
cd $GOPATH/src/github.com/GoogleCloudPlatform/golang-samples/datastore/tasks
Em um prompt de comando, execute o seguinte comando, em que
<project-id>
é o ID do seu projeto do Google Cloud.export DATASTORE_PROJECT_ID=<project-id>
Usuários do Windows: use
set
em vez deexport
.Execute o aplicativo.
go run tasks.go
Java
Verifique se o Maven e o Java (versão 8 ou posterior) estão instalados.
Faça o download do aplicativo de amostra TaskList no repositório de exemplos (link em inglês).
Em um prompt de comando, extraia o download:
unzip main.zip
Altere os diretórios para o aplicativo TaskList:
cd java-datastore-main/samples/snippets
Execute o seguinte comando, em que
<project-id>
é o ID do seu projeto do Google Cloud.gcloud config set project <project-id>
Compile e execute o aplicativo.
mvn clean compile mvn exec:java -Dexec.mainClass="com.google.datastore.snippets.TaskList"
Node.js
Faça o download do aplicativo de amostra TaskList no repositório de amostras.
Extraia o download:
unzip master.zip
Altere os diretórios para o aplicativo TaskList:
cd nodejs-datastore-master/samples
Instale as dependências e vincule o aplicativo:
npm install
Em um prompt de comando, execute o seguinte comando, em que
<project-id>
é o ID do seu projeto do Google Cloud.export GCLOUD_PROJECT=<project-id>
Usuários do Windows: use
set
em vez deexport
.Execute o aplicativo.
node tasks.js
PHP
- Certifique-se de ter o PHP (versão 5.6 ou posterior) e o Composer instalados.
- Faça o download do aplicativo de amostra TaskList no repositório de amostras.
Extraia o download:
unzip master.zip
Altere os diretórios para o aplicativo TaskList:
cd php-docs-samples-master/datastore/tutorial
Instale as dependências.
composer install
Execute o aplicativo.
php src/list_tasks.php
Python
- Verifique se o Python (versão 2.7.9 ou posterior), o pip e o virtualenv estão instalados.
Ative uma sessão
virtualenv
.virtualenv venv source venv/bin/activate
Faça o download do aplicativo de amostra TaskList no repositório de exemplos (link em inglês).
Extraia o download:
unzip master.zip
Altere os diretórios para o aplicativo TaskList:
cd python-docs-samples-master/datastore/cloud-client
Instale as dependências:
pip install -r requirements.txt
Execute o aplicativo. Use o ID do seu projeto do Google Cloud para
<project-id>
.python tasks.py new project-id
Ruby
Faça o download do aplicativo de amostra TaskList no repositório de amostras.
Extraia o download:
unzip master.zip
Altere os diretórios para o aplicativo TaskList:
cd google-cloud-ruby-master/google-cloud-datastore/samples
Instale as dependências:
bundle install
Em um prompt de comando, execute o seguinte comando, em que
<project-id>
é o ID do seu projeto do Google Cloud.export GOOGLE_CLOUD_PROJECT=<project-id>
Usuários do Windows: use
set
em vez deexport
.Execute o aplicativo.
bundle exec ruby tasks.rb
Como criar um objeto de serviço autorizado
Para fazer solicitações autenticadas nas APIs do Google Cloud usando as bibliotecas de cliente das APIs do Google, é preciso:
- buscar a credencial a ser usada nas solicitações;
- criar um objeto de serviço que usa essa credencial.
Em seguida, faça chamadas para APIs chamando métodos no objeto de serviço do Datastore.
Neste exemplo, você buscará o Application Default Credentials do ambiente e o transferirá como um argumento para criar o objeto de serviço.
Veja o chamada para criar o objeto de serviço autorizado no modo Datastore:
C#
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API C# do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API Go do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API Java do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API Node.js do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API PHP do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API Python do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API Ruby do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Como armazenar dados
Os objetos no Datastore são conhecidos como entidades, e cada entidade é de um
tipo específico. O aplicativo TaskList armazenará entidades do tipo
Task
, com as seguintes propriedades:
description
: uma string especificada pelo usuário como a descrição da tarefacreated
: uma data que mostra quando a tarefa foi criada inicialmentedone
: um booleano que indica se a tarefa foi concluída
Quando o usuário adiciona uma nova tarefa, o aplicativo TaskList cria um Task
.
entidade com valores para as propriedades listadas anteriormente:
C#
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API C# do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API Go do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API Java do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API Node.js do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API PHP do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API Python do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API Ruby do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Neste aplicativo, também oferecemos um método para atualizar o done
.
, para indicar que a tarefa está concluída:
C#
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API C# do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API Go do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API Java do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API Node.js do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API PHP do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API Python do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API Ruby do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Este é o método para excluir uma entidade Task
, usando a chave da entidade Task
:
C#
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API C# do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API Go do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API Java do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API Node.js do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API PHP do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API Python do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API Ruby do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Como executar uma consulta
Além de recuperar entidades do Datastore diretamente por meio das chaves delas, um aplicativo pode realizar uma consulta para recuperar as entidades usando os valores das propriedades delas. Uma consulta típica inclui:
- um tipo de entidade ao qual a consulta se aplica
- zero ou mais filtros, por exemplo, para selecionar os tipos cujas propriedades correspondem a um valor
- zero ou mais ordens de classificação, para colocar os resultados em sequência.
Para este aplicativo, consultaremos o modo Datastore para entidades Task
classificadas
por tempo de criação:
C#
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API C# do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API Go do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a documentação de referência da API Java do Cloud Datastore.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API Node.js do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para saber como instalar e usar a biblioteca de cliente do Cloud Datastore, consulte as Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API PHP do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API Python do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para aprender a instalar e usar a biblioteca de cliente do Cloud Datastore, consulte Bibliotecas de cliente do Cloud Datastore. Para mais informações, consulte a API Ruby do Cloud Datastore documentação de referência.
Para autenticar no Cloud Datastore, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
A seguir
Este tutorial abrange apenas as etapas mais básicas necessárias para fazer chamadas para a API do modo Datastore a partir de um aplicativo de linha de comando. O Datastore é compatível com transações ACID rápidas e altamente escalonáveis, como consultas semelhantes a SQL, índices e mais.
- Para uma visão mais detalhada dos recursos do modo Datastore, consulte O que é o Firestore no modo Datastore?.
- Para informações sobre como usar o emulador do modo Datastore durante o desenvolvimento do aplicativo, consulte Emulador do modo Datastore.