Interfacce disponibili
Quando interagisci con Spanner, puoi utilizzare una delle diverse interfacce programmatiche. Di seguito sono riportate le interfacce disponibili, nell'ordine in cui consigliamo di utilizzarle:
- Librerie client: le librerie client di Spanner 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 i driver Spanner open source per diverse librerie di mappatura oggetto-relazionale (ORM) e framework, come JDBC. Questi driver consentono l'utilizzo dei 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 protocol buffer (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 supportate nell'API REST, come descritto di seguito.
API RPC e API REST
Questa tabella mette a confronto le funzionalità di Spanner disponibili tramite le interfacce API RPC e REST.
| Funzionalità | Supportato nell'API RPC? | È supportato nell'API REST? |
|---|---|---|
| Annullamento di una richiesta | Sì | No |
| Impostazione di una scadenza o di un timeout per una richiesta | Sì | No |
| Invio di una richiesta di streaming | Sì. Leggi 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.