Visão geral de APIs, bibliotecas de cliente e drivers ORM

Interfaces disponíveis

Você pode usar uma das várias interfaces programáticas ao interagir com no Spanner. Estas são as interfaces disponíveis, na ordem em que recomendamos usá-las:

  • Bibliotecas de cliente: as bibliotecas de cliente do Spanner são disponíveis em vários idiomas e são criados em gRPC. Essas bibliotecas de cliente fornecem uma camada de abstração sobre o gRPC e processam os detalhes de gerenciamento de sessão, execução de transações, novas tentativas e muito mais.
  • Drivers ORM e framework: o Google oferece suporte a drivers do Spanner de código aberto para várias bibliotecas conhecidas de mapeamento relacional de objetos (ORMs) e frameworks, como JDBC. Esses drivers permitem o uso de bancos de dados do Spanner APIs definidas por esses frameworks.
  • API RPC: se uma biblioteca de cliente ou driver ORM não estiver disponível para sua opção de linguagem de programação, use a API RPC, que é criada no gRPC. Ele oferece uma série de benefícios de desempenho em comparação ao uso da API REST, incluindo a representação de objetos no formato de buffer de protocolo (que são mais rápidos para produzir e consumir se comparados ao JSON) e conexões persistentes (que resultam em sobrecarga menor por solicitação). Leia mais sobre esses e outros benefícios em Conceitos de gRPC.
  • API REST: se não for possível usar as bibliotecas de cliente do Spanner ou a API RPC, use a API REST. Alguns recursos que estão disponíveis na API RPC não são aceitos na API REST, conforme documentado abaixo.

API REST x RPC

Esta tabela compara os recursos do Spanner disponíveis nas interfaces da API REST e RPC.

Recurso Aceito na API RPC? Aceito na API REST?
Cancelar uma solicitação Sim Não
Definir um prazo ou tempo limite de uma solicitação Sim Não
Enviar uma solicitação de streaming Sim. consulte ExecuteStreamingSQL e StreamingRead. Parcialmente. Streaming HTTP é compatível, mas o controle de fluxo no nível do aplicativo, não.

Suporte a recursos de bibliotecas de cliente

A tabela a seguir lista as bibliotecas de cliente e os principais recursos do Spanner compatíveis com cada uma.

Cliente Go Java Node.js Python Ruby C++ PHP C#
Dicas de instrução
Mutações
DML em lote
DDL em lote
Leituras desatualizadas
Tabelas intercaladas
DML particionada
Marcação de sessões
Prioridade da solicitação
Tipo JSON
Inclusão de tags em solicitações
Opção de líder configurável
Leitura particionada
Interface do PostgreSQL