In questa pagina viene descritto come inserire, aggiornare ed eliminare i dati utilizzando lo strumento a riga di comando gcloud.
Modifica dei dati utilizzando DML
Per eseguire le istruzioni DML (Data Manipulation Language), utilizza il
comando gcloud spanner databases execute-sql . L'esempio seguente aggiunge una 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 l'opzione --enable-partitioned-dml. L'esempio seguente aggiorna le righe nella 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 la pagina relativa alla 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 i
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 per tutte le altre colonne obbligatorie:
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
L'esempio seguente inserisce 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 di una tabella, devi includere i valori per le colonne chiave e per le colonne che vuoi 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 coppia chiave-valore, devi creare una nuova riga ed eliminare quella 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
L'esempio seguente elimina una riga dalla tabella "Singers":
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 i dati in un file YAML e utilizza l'opzione --flags-file.
Ad esempio, questo file YAML specifica l'array [1,2,3] per la colonna Numbers:
# 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 una colonna di timestamp di commit, passa spanner.commit_timestamp() come valore della colonna. L'esempio seguente
scrive il timestamp di commit nella colonna LastUpdated quando viene inserita la riga.
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 di timestamp specifico nella colonna LastUpdated:
gcloud spanner rows update --instance=test-instance --database=example-db \
--table=Singers \
--data=SingerId=1,LastUpdated=2017-01-02T12:34:00.45Z