Panoramica di API, librerie client e driver ORM

Interfacce disponibili

Puoi utilizzare una delle numerose interfacce di pubblicità programmatica quando interagisci Spanner. Di seguito sono riportate le interfacce disponibili, nell'ordine in cui consigliamo di utilizzarle:

  • Librerie client: le librerie client di Spanner vengono sono disponibili in più lingue e sono basate su gRPC. Queste librerie client forniscono un livello di astrazione sopra gRPC e gestiscono i dettagli della gestione delle sessioni, dell'esecuzione delle transazioni, dei tentativi di nuovo invio e altro ancora.
  • Driver ORM e framework: Google supporta Spanner open source per diversi ORM (Object-Relazionale Map Library) e come JDBC. Questi driver consentono di utilizzare i database Spanner tramite le API definite da questi framework.
  • API RPC: se non è disponibile una libreria client o un driver ORM per il linguaggio di programmazione scelto, utilizza l'API RPC, basata su gRPC. gRPC offre una serie di vantaggi in termini di prestazioni rispetto all'utilizzo dell'API REST, tra cui la rappresentazione degli oggetti in formato buffer del protocollo (che sono più rapidi da produrre e consumare rispetto a JSON) e le connessioni permanenti (che comportano un minore overhead per richiesta). Scopri di più su questi e altri vantaggi in Concetti di gRPC.
  • API REST: se non riesci a utilizzare le librerie client di Spanner o l'API RPC, utilizza l'API REST. Tieni presente che alcune funzionalità disponibili nell'API RPC non sono supportati nell'API REST, come documentato di seguito.

RPC e API REST

Questa tabella mette a confronto le funzionalità di Spanner disponibili tramite le interfacce RPC e API REST.

Funzionalità Supportata nell'API RPC? È supportato nell'API REST?
Annullamento di una richiesta No
Impostare una scadenza o un timeout per una richiesta No
Invio di una richiesta di streaming Sì. vedi ExecuteStreamingSQL e StreamingRead. Parziale. Lo streaming HTTP è supportato, ma non il controllo del flusso a livello di applicazione.

Supporto delle funzionalità delle librerie client

La tabella seguente elenca le librerie client, indicando le principali funzionalità di Spanner supportate da ciascuna.

Client Go Java Node.js Python Ruby C++ PHP C#
Suggerimenti relativi alle dichiarazioni
Mutazioni
DML batch
DDL batch
Letture non aggiornate
Tabelle con interleaving
DML partizionato
Etichettatura sessione
Priorità della richiesta
Tipo JSON
Tagging delle richieste
Opzione leader configurabile
Lettura partizionata
Interfaccia PostgreSQL