Objetivos
Neste tutorial, você vai conhecer as seguintes etapas usando a biblioteca de cliente do Spanner para Java:
- Crie uma instância e um banco de dados do Spanner.
- Gravar, ler e executar consultas SQL em dados contidos no banco de dados.
- Atualizar o esquema do banco de dados.
- Atualizar dados usando uma transação de leitura e gravação.
- Adicionar um índice secundário ao banco de dados.
- Usar o índice para ler e executar consultas SQL nos dados.
- Recuperar dados usando uma transação somente leitura.
Custos
Neste tutorial, usamos o Spanner, que é um componente faturável do Google Cloud. Para informações sobre o custo do uso do Spanner, consulte Preços.
Antes de começar
Conclua as etapas descritas em Configurar, que abrangem a criação e a configuração de um projeto padrão do Google Cloud , o faturamento, a API Cloud Spanner e a configuração do OAuth 2.0 para receber credenciais de autenticação para usar a API Cloud Spanner.
Especificamente, execute gcloud auth
application-default login para configurar o ambiente de desenvolvimento local com credenciais de autenticação.
Prepare seu ambiente Java local
Instale os seguintes itens na sua máquina de desenvolvimento se ainda não estiverem instalados:
- Java 8 JDK (fazer o download).
- Maven 3 (fazer download).
Clone o repositório do app de amostra na máquina local:
git clone https://github.com/googleapis/google-cloud-java.gitMude para o diretório que contém o exemplo de código do Spanner:
cd google-cloud-java/java-spanner/samples/snippetsGere o arquivo JAR de amostra:
mvn clean package
Criar uma instância
Ao usar o Spanner pela primeira vez, é necessário criar uma instância, que é uma alocação de recursos usados pelos bancos de dados do Spanner. Ao criar uma instância, escolha uma configuração que determine onde os dados serão armazenados e também o número de nós a serem usados. Isso determina a quantidade de recursos de exibição e armazenamento na instância.
Consulte Criar uma instância para saber como criar uma instância do Spanner usando um dos seguintes métodos. Você pode nomear sua instância como test-instance para usar com
outros tópicos neste documento que fazem referência a uma instância chamada test-instance.
- A Google Cloud CLI
- O console do Google Cloud
- Uma biblioteca de cliente (C++, C#, Go, Java, Node.js, PHP, Python ou Ruby)
Consultar os arquivos de amostra
O repositório de amostras contém um exemplo que mostra como usar o Spanner com Java.
Criar um banco de dados
GoogleSQL
java -jar target/spanner-snippets/spanner-google-cloud-samples.jar \
createdatabase test-instance example-db
PostgreSQL
java -jar target/spanner-snippets/spanner-google-cloud-samples.jar \
createpgdatabase test-instance example-db
Você verá:
Created database [example-db]