Como inserir, atualizar e excluir dados usando a ferramenta de linha de comando gcloud

Nesta página, descrevemos como inserir, atualizar e excluir dados usando a ferramenta de linha de comando gcloud.

Modificar dados usando a DML

Para executar declarações de linguagem de manipulação de dado (DML, na sigla em inglês), use o comando gcloud spanner databases execute-sql. O exemplo a seguir adiciona uma nova linha à tabela Singers.

gcloud spanner databases execute-sql example-db --instance=test-instance \
    --sql="INSERT Singers (SingerId, FirstName, LastName) VALUES (1, 'Marc', 'Richards')"

Para executar uma declaração DML particionada, use o comando gcloud spanner databases execute-sql com a opção --enable-partitioned-dml. O exemplo a seguir atualiza linhas na tabela Albums.

gcloud spanner databases execute-sql example-db \
    --instance=test-instance --enable-partitioned-dml \
    --sql='UPDATE Albums SET MarketingBudget = 0 WHERE MarketingBudget IS NULL'

Para ver a referência de DML do Cloud Spanner, consulte Sintaxe da linguagem de manipulação de dados.

Como modificar linhas usando o grupo de comandos de linhas

Use o grupo de comandos gcloud spanner rows para modificar dados em um banco de dados:

  • Inserir novas linhas em uma tabela.
  • Atualizar colunas em linhas existentes em uma tabela.
  • Excluir linhas de uma tabela.

O grupo de comandos rows reconhece literais para todos os tipos de coluna válidos.

Inserir uma linha em uma tabela

Para inserir uma nova linha em uma tabela, é preciso incluir valores para as colunas de chave e para outras colunas obrigatórias:

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

No exemplo a seguir, uma nova linha é inserida na tabela Singers:

gcloud spanner rows insert --instance=test-instance --database=example-db \
    --table=Singers \
    --data=SingerId=1,FirstName='Marc',LastName='Richards'

Atualizar uma linha em uma tabela

Para atualizar uma linha em uma tabela, é preciso incluir valores para as colunas de chave e para as colunas que você quer atualizar:

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

No exemplo a seguir, uma linha é atualizada na tabela Singers:

gcloud spanner rows update --instance=test-instance --database=example-db \
    --table=Singers \
    --data=SingerId=1,FirstName='Marc',LastName='Richards'

Não é possível alterar os valores de chave usando o comando update. Para atualizar um valor de chave, é preciso criar uma nova linha e excluir a linha existente.

Excluir uma linha de uma tabela

Para excluir uma linha, você precisa especificar os valores para as colunas de chave primária:

gcloud spanner rows delete --instance=INSTANCE_ID --database=DATABASE_ID  \
    --table=TABLE_NAME \
    --keys=KEY_VALUE_1,KEY_VALUE_2,KEY_VALUE_3
No exemplo a seguir, uma linha da tabela "Singers" é excluída:
gcloud spanner rows delete --instance=test-instance --database=example-db \
    --table=Singers \
    --keys=1

Especificar valores de matriz

Para inserir ou atualizar valores em uma coluna ARRAY, coloque os dados em um arquivo YAML e use a opção --flags-file.

Por exemplo, esse arquivo YAML especifica a matriz [1,2,3] para a coluna Numbers:

# stats.yaml
--data:
    Id: 1
    Locked: True
    Numbers:
        - 1
        - 2
        - 3

Para inserir uma linha com os dados YAML, use a opção --flags-file:

gcloud spanner rows insert --instance=test-instance --database=example-db \
     --table=Stats \
     --flags-file stats.yaml

Para uma matriz NULL, não inclua um valor para o Numbers no arquivo:

# stats.yaml
--data:
    Id: 1
    Locked: True

Para uma matriz vazia, defina-a como []:

# stats.yaml
--data:
    Id: 1
    Locked: True
    Numbers: []

Especificar carimbos de data/hora de confirmação

Para inserir ou atualizar um valor automaticamente em uma coluna de carimbo de data/hora de confirmação, informe spanner.commit_timestamp() como o valor da coluna. No exemplo a seguir, o carimbo de data/hora de commit é gravado na coluna LastUpdated quando a linha é inserida.

gcloud spanner rows insert --instance=test-instance --database=example-db \
    --table=Singers \
    --data=SingerId=1,LastUpdated='spanner.commit_timestamp()'

No exemplo a seguir, um valor de carimbo de data e hora específico é gravado na coluna LastUpdated:

gcloud spanner rows update --instance=test-instance --database=example-db \
    --table=Singers \
    --data=SingerId=1,LastUpdated=2017-01-02T12:34:00.45Z
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Cloud Spanner