In questa pagina viene descritto come inserire, aggiornare ed eliminare dati utilizzando
gcloud
.
Modifica dei dati utilizzando DML
Per eseguire istruzioni DML (Data Manipulation Language), utilizza la classe
Comando gcloud spanner databases execute-sql
. Nell'esempio seguente viene aggiunta
nuova riga alla tabella Singers
.
gcloud spanner databases execute-sql example-db --instance=test-instance \ --sql="INSERT Singers (SingerId, FirstName, LastName) VALUES (1, 'Marc', 'Richards')"
Per eseguire un'istruzione DML partizionata, utilizza
il comando gcloud spanner databases execute-sql
con
Opzione --enable-partitioned-dml
. L'esempio seguente aggiorna le righe in
Tabella Albums
.
gcloud spanner databases execute-sql example-db \ --instance=test-instance --enable-partitioned-dml \ --sql='UPDATE Albums SET MarketingBudget = 0 WHERE MarketingBudget IS NULL'
Per il riferimento DML di Spanner, consulta Sintassi di Data Manipulation Language.
Modifica di righe utilizzando il gruppo di comandi rows
Utilizza il gruppo di comandi gcloud spanner rows
per modificare i dati in un database:
- Inserisci nuove righe in una tabella.
- Aggiorna le colonne nelle righe esistenti di una tabella.
- Eliminare righe da una tabella.
Il gruppo di comandi rows
riconosce i valori letterali per tutti
tipi di colonna validi:
Inserire una riga in una tabella
Per inserire una nuova riga in una tabella, devi includere i valori per le colonne chiave e qualsiasi altra colonna obbligatoria:
gcloud spanner rows insert --instance=INSTANCE_ID --database=DATABASE_ID \ --table=TABLE_NAME \ --data=COL_NAME_1=COL_VALUE_1,COL_NAME_2=COL_VALUE_2,COL_NAME_3=COL_VALUE_3,...,COL_NAME_N=COL_VALUE_N
Nell'esempio seguente viene inserita una nuova riga nella tabella Singers
:
gcloud spanner rows insert --instance=test-instance --database=example-db \ --table=Singers \ --data=SingerId=1,FirstName='Marc',LastName='Richards'
Aggiornare una riga in una tabella
Per aggiornare una riga in una tabella, devi includere i valori per le colonne chiave e colonne da aggiornare:
gcloud spanner rows update --instance=INSTANCE_ID --database=DATABASE_ID \ --table=TABLE_NAME \ --data=COL_NAME_1=COL_VALUE_1,COL_NAME_2=COL_VALUE_2,COL_NAME_3=COL_VALUE_3,...,COL_NAME_N=COL_VALUE_N
L'esempio seguente aggiorna una riga nella tabella Singers
:
gcloud spanner rows update --instance=test-instance --database=example-db \ --table=Singers \ --data=SingerId=1,FirstName='Marc',LastName='Richards'
Non puoi modificare le coppie chiave-valore utilizzando il comando update
. Per aggiornare una chiave
devi creare una nuova riga ed eliminare la riga esistente.
Eliminare una riga da una tabella
Per eliminare una riga, devi specificare i valori per le colonne di chiave primaria:
gcloud spanner rows delete --instance=INSTANCE_ID --database=DATABASE_ID \ --table=TABLE_NAME \ --keys=KEY_VALUE_1,KEY_VALUE_2,KEY_VALUE_3
gcloud spanner rows delete --instance=test-instance --database=example-db \ --table=Singers \ --keys=1
Specifica i valori di ARRAY
Per inserire o aggiornare i valori in una colonna ARRAY
, inserisci
in un file YAML e utilizzare
--flags-file
.
Ad esempio, questo file YAML specifica l'array [1,2,3]
per Numbers
colonna:
# stats.yaml
--data:
Id: 1
Locked: True
Numbers:
- 1
- 2
- 3
Per inserire una riga con i dati YAML, utilizza l'opzione --flags-file
:
gcloud spanner rows insert --instance=test-instance --database=example-db \ --table=Stats \ --flags-file stats.yaml
Per un array NULL
, non includere un valore per Numbers
nel file:
# stats.yaml
--data:
Id: 1
Locked: True
Per un array vuoto, definisci l'array come []
:
# stats.yaml
--data:
Id: 1
Locked: True
Numbers: []
Specifica i timestamp di commit
Per inserire o aggiornare automaticamente un valore in un
colonna commit timestamp, superamento
spanner.commit_timestamp()
come valore della colonna. Nell'esempio che segue
scrive il timestamp di commit nella colonna LastUpdated
quando la riga è
inserito.
gcloud spanner rows insert --instance=test-instance --database=example-db \ --table=Singers \ --data=SingerId=1,LastUpdated='spanner.commit_timestamp()'
L'esempio seguente scrive un valore timestamp specifico nell'elemento LastUpdated
colonna:
gcloud spanner rows update --instance=test-instance --database=example-db \ --table=Singers \ --data=SingerId=1,LastUpdated=2017-01-02T12:34:00.45Z