In questa pagina viene descritto come inserire, aggiornare ed eliminare i dati utilizzando le mutazioni. Una mutazione rappresenta una sequenza di inserimenti, aggiornamenti ed eliminazioni che Spanner applica atomicamente a righe e tabelle diverse in un database Spanner.
Sebbene sia possibile eseguire il commit delle mutazioni utilizzando gRPC o REST, è più comune accedere alle API tramite le librerie client.
Questa pagina mostra le attività di base di inserimento, aggiornamento ed eliminazione. Puoi trovare altri esempi nei tutorial introduttivi.
Se devi eseguire il commit di un numero elevato di scritture cieche, ma non hai bisogno di una transazione atomica, puoi apportare modifiche collettive alle tabelle Spanner utilizzando la scrittura batch. Per saperne di più, consulta Modificare i dati utilizzando le scritture in batch.
Inserire nuove righe in una tabella
C++
Puoi scrivere i dati utilizzando la funzione InsertMutationBuilder()
.
Client::Commit()
aggiunge nuove righe a una tabella. Tutti gli inserti in un singolo batch
vengono applicati a livello atomico.
Questo codice mostra come scrivere i dati:
C#
Puoi inserire i dati utilizzando il metodo connection.CreateInsertCommand()
, che crea un nuovo SpannerCommand
per inserire righe in una tabella. Il metodo SpannerCommand.ExecuteNonQueryAsync()
aggiunge nuove righe alla tabella.
Questo codice mostra come inserire i dati:
Go
Scrivi i dati utilizzando un
Mutation
. Un Mutation
è un container per le operazioni di mutazione. Un Mutation
rappresenta una sequenza di inserimenti, aggiornamenti, eliminazioni e così via che può essere applicata atomicamente a righe e tabelle diverse in un database Spanner.
Utilizza Mutation.InsertOrUpdate()
per creare una mutazione INSERT_OR_UPDATE
, che aggiunge una nuova riga o aggiorna
i valori della colonna se la riga esiste già. In alternativa, utilizza il metodo Mutation.Insert()
per creare una mutazione INSERT
, che aggiunge una nuova riga.
Client.Apply()
applica
le mutazioni atomicamente a un database.
Questo codice mostra come scrivere i dati:
Java
Scrivi i dati utilizzando un oggetto Mutation
. Un oggetto Mutation
è un container per le operazioni di mutazione. Un Mutation
rappresenta una sequenza di inserimenti, aggiornamenti ed eliminazioni che Spanner si applica atomicamente a righe e tabelle diverse in un database Spanner.
Il metodo newInsertBuilder()
nella classe Mutation
genera una mutazione INSERT
, che inserisce una nuova
riga in una tabella. Se la riga esiste già, la scrittura non riesce. In alternativa,
puoi utilizzare il metodo newInsertOrUpdateBuilder
per creare una mutazione INSERT_OR_UPDATE
, che
aggiorna i valori della colonna se la riga esiste già.
Il metodo write()
nella classe DatabaseClient
scrive
le mutazioni. Tutte le mutazioni in un singolo batch vengono applicate a livello atomico.
Questo codice mostra come scrivere i dati:
Node.js
Scrivi i dati utilizzando
un oggetto Table
. Il metodo Table.insert()
aggiunge nuove righe alla tabella. Tutti gli inserimenti di un singolo batch
vengono applicati a livello atomico.
Questo codice mostra come scrivere i dati:
PHP
Scrivi i dati utilizzando il metodo Database::insertBatch
. insertBatch
aggiunge nuove righe a una tabella. Tutti gli inserti in un singolo batch
vengono applicati atomicamente.
Questo codice mostra come scrivere i dati:
Python
Scrivi i dati utilizzando un oggetto Batch
. Un oggetto Batch
è un container per le operazioni di mutazione. Una mutazione rappresenta una sequenza di inserimenti, aggiornamenti, eliminazioni e così via che può essere applicata atomicamente a righe e tabelle diverse in un database Spanner.
Il metodo insert()
nella classe Batch
viene utilizzato per
aggiungere una o più mutazioni di inserimento al batch. Tutte le mutazioni in un singolo batch
sono applicate atomicamente.
Questo codice mostra come scrivere i dati:
Ruby
Scrivi i dati utilizzando un oggetto Client
. Il metodo Client#commit
crea e sottopone a commit una transazione per le scritture eseguite a livello atomico in un singolo momento logico nel tempo su colonne, righe e tabelle in un database.
Questo codice mostra come scrivere i dati:
Aggiornare le righe in una tabella
Supponiamo che le vendite di Albums(1, 1)
siano inferiori al previsto. Di conseguenza,
vuoi trasferire 200.000 $dal budget di marketing di Albums(2, 2)
a
Albums(1, 1)
, ma solo se il denaro è disponibile nel budget di
Albums(2, 2)
.
Poiché devi leggere i dati nelle tabelle per determinare se scrivere nuovi valori, devi utilizzare una transazione di lettura e scrittura per eseguire le letture e le scritture in modo atomico.
C++
Utilizza la funzione Transaction()
per eseguire una transazione per un client.
Ecco il codice per eseguire la transazione:
C#
Per .NET Standard 2.0 (o .NET 4.5) e versioni successive, puoi utilizzare
TransactionScope()
di .NET Framework per eseguire una transazione. Per tutte le versioni supportate di .NET, puoi creare una transazione impostando il risultato di SpannerConnection.BeginTransactionAsync
come proprietà Transaction
di SpannerCommand
.
Ecco i due modi per eseguire la transazione:
Standard .NET 2.0
Standard .NET 1.5
Go
Utilizza il tipo ReadWriteTransaction
per eseguire un corpo di lavoro nel contesto di una transazione di lettura-scrittura.
Client.ReadWriteTransaction()
restituisce un oggetto ReadWriteTransaction
.
L'esempio utilizza ReadWriteTransaction.ReadRow()
per recuperare una riga di dati.
L'esempio utilizza anche ReadWriteTransaction.BufferWrite()
,
che aggiunge un elenco di mutazioni all'insieme di aggiornamenti che saranno applicati
quando viene eseguito il commit della transazione.
L'esempio utilizza anche il tipo Key
, che rappresenta una chiave di riga in una tabella o un indice Spanner.
Java
Utilizza l'interfaccia TransactionRunner
per eseguire
un'operazione nel contesto di una transazione di lettura/scrittura. Questa interfaccia
contiene il metodo run()
, utilizzato per eseguire una transazione di lettura-scrittura, con nuovi tentativi se necessario. Il metodo readWriteTransaction
della classe DatabaseClient
restituisce un oggetto TransactionRunner
per l'esecuzione di una singola transazione logica.
La classe TransactionRunner.TransactionCallable
contiene un metodo run()
per eseguire un singolo tentativo di una transazione. run()
prende un oggetto
TransactionContext
, che è un contesto
per una transazione.
L'esempio utilizza la classe Struct
, utile per archiviare i risultati delle chiamate readRow()
. L'esempio utilizza anche la classe Key
, che rappresenta una chiave di riga in una tabella o un indice Spanner.
Ecco il codice per eseguire la transazione:
Node.js
Utilizza Database.runTransaction()
per eseguire una transazione.
Ecco il codice per eseguire la transazione:
PHP
Utilizza Database::runTransaction
per eseguire una transazione.
Ecco il codice per eseguire la transazione:
Python
Utilizza il metodo run_in_transaction()
della classe Database
per eseguire una transazione.
Ecco il codice per eseguire la transazione:
Ruby
Utilizza il metodo transaction
della classe Client
per eseguire una transazione.
Ecco il codice per eseguire la transazione:
Eliminare righe in una tabella
Ogni libreria client fornisce diversi modi per eliminare le righe:
- Elimina tutte le righe di una tabella.
- Elimina una singola riga specificando i valori della colonna chiave per la riga.
- Elimina un gruppo di righe creando un intervallo di chiavi.
- Elimina le righe in una tabella con interleaving eliminando le righe padre, se la tabella con interfoliazione include
ON DELETE CASCADE
nella definizione dello schema.
C++
Elimina le righe utilizzando la funzione DeleteMutationBuilder()
per un client.
Questo codice mostra come eliminare i dati:
C#
Elimina le righe utilizzando il metodo connection.CreateDeleteCommand()
, che crea un nuovo SpannerCommand
per eliminare le righe. Il metodo SpannerCommand.ExecuteNonQueryAsync()
elimina le righe dalla tabella.
In questo esempio vengono eliminate singolarmente le righe nella tabella Singers
. Le righe
nella tabella Albums
vengono eliminate perché la tabella Albums
ha interleaving
nella tabella Singers
ed è definita con ON DELETE CASCADE
.
Go
Elimina le righe utilizzando un elemento Mutation
. Utilizza il metodo Mutation.Delete()
per creare una mutazione DELETE
, che elimina una riga. Il metodo Client.Apply()
applica
le mutazioni atomicamente al database.
In questo esempio vengono eliminate singolarmente le righe nella tabella Albums
, quindi
elimina tutte le righe della tabella Singers
utilizzando un valore KeyRange.
Java
Elimina le righe utilizzando il metodo Mutation.delete()
.
In questo esempio viene utilizzato il metodo KeySet.all()
per eliminare tutte
le righe della tabella Albums
. Dopo aver eliminato le righe nella tabella Albums
, l'esempio elimina singolarmente le righe nella tabella Singers
utilizzando le chiavi create con il metodo KeySet.singleKey()
.
Node.js
Elimina le righe utilizzando il metodo table.deleteRows()
.
In questo esempio viene utilizzato il metodo table.deleteRows()
per eliminare tutte le righe
dalla tabella Singers
. Le righe nella tabella Albums
vengono eliminate perché
la tabella Albums
ha interleaving nella tabella Singers
ed è definita con ON
DELETE CASCADE
.
PHP
Elimina le righe utilizzando Database::delete() method
. La pagina Metodo Database::delete()
include un esempio.
Python
Elimina le righe utilizzando il metodo Batch.delete()
.
In questo esempio vengono eliminate singolarmente tutte le righe nelle tabelle Albums
e Singers
utilizzando un oggetto KeySet
.
Ruby
Elimina le righe utilizzando il metodo Client#delete
. La pagina Client#delete
include un esempio.