Esempi di Amazon RDS Data Service utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface con Amazon RDS Data Service.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Azioni

batch-execute-statement

Il seguente esempio di codice mostra come usarebatch-execute-statement.

AWS CLI

Come eseguire un’istruzione SQL in batch

L’esempio batch-execute-statement seguente esegue un’istruzione SQL batch su un array di dati con un set di parametri.

aws rds-data batch-execute-statement \
    --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \
    --database "mydb" \
    --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \
    --sql "insert into mytable values (:id, :val)" \
    --parameter-sets "[[{\"name\": \"id\", \"value\": {\"longValue\": 1}},{\"name\": \"val\", \"value\": {\"stringValue\": \"ValueOne\"}}],
        [{\"name\": \"id\", \"value\": {\"longValue\": 2}},{\"name\": \"val\", \"value\": {\"stringValue\": \"ValueTwo\"}}],
        [{\"name\": \"id\", \"value\": {\"longValue\": 3}},{\"name\": \"val\", \"value\": {\"stringValue\": \"ValueThree\"}}]]"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Utilizzo dell’API dati per Aurora Serverless nella Guida per l’utente di Amazon RDS.

• Per i dettagli sull'API, consulta BatchExecuteStatement AWS CLICommand Reference.

begin-transaction

Il seguente esempio di codice mostra come utilizzarebegin-transaction.

AWS CLI

Come avviare una transazione SQL

L’esempio begin-transaction seguente esegue una transazione SQL.

aws rds-data begin-transaction \
    --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \
    --database "mydb" \
    --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret"

Output:

{
    "transactionId": "ABC1234567890xyz"
}

Per ulteriori informazioni, consulta Utilizzo dell’API dati per Aurora Serverless nella Guida per l’utente di Amazon RDS.

• Per i dettagli sull'API, consulta BeginTransaction AWS CLICommand Reference.

commit-transaction

Il seguente esempio di codice mostra come utilizzarecommit-transaction.

AWS CLI

Come eseguire il commit di una transazione SQL

L’esempio commit-transaction seguente termina la transazione SQL specificata e conferma le modifiche apportate come parte di essa.

aws rds-data commit-transaction \
    --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \
    --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \
    --transaction-id "ABC1234567890xyz"

Output:

{
    "transactionStatus": "Transaction Committed"
}

Per ulteriori informazioni, consulta Utilizzo dell’API dati per Aurora Serverless nella Guida per l’utente di Amazon RDS.

• Per i dettagli sull'API, consulta CommitTransaction AWS CLICommand Reference.

execute-statement

Il seguente esempio di codice mostra come utilizzareexecute-statement.

AWS CLI

Esempio 1: come eseguire un’istruzione SQL inclusa in una transazione

L’esempio execute-statement seguente esegue un’istruzione SQL che fa parte di una transazione.

aws rds-data execute-statement \
    --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \
    --database "mydb" \
    --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \
    --sql "update mytable set quantity=5 where id=201" \
    --transaction-id "ABC1234567890xyz"

Output:

{
    "numberOfRecordsUpdated": 1
}

Esempio 2: come eseguire un’istruzione SQL con parametri

L’esempio execute-statement seguente esegue un’istruzione SQL con parametri.

aws rds-data execute-statement \
    --resource-arn "arn:aws:rds:us-east-1:123456789012:cluster:mydbcluster" \
    --database "mydb" \
    --secret-arn "arn:aws:secretsmanager:us-east-1:123456789012:secret:mysecret" \
    --sql "insert into mytable values (:id, :val)" \
    --parameters "[{\"name\": \"id\", \"value\": {\"longValue\": 1}},{\"name\": \"val\", \"value\": {\"stringValue\": \"value1\"}}]"

Output:

{
    "numberOfRecordsUpdated": 1
}

Per ulteriori informazioni, consulta Utilizzo dell’API dati per Aurora Serverless nella Guida per l’utente di Amazon RDS.

• Per i dettagli sull'API, consulta ExecuteStatement AWS CLICommand Reference.

rollback-transaction

Il seguente esempio di codice mostra come utilizzarerollback-transaction.

AWS CLI

Come eseguire il rollback di una transazione SQL

L’esempio rollback-transaction seguente ripristina la transazione SQL specificata.

aws rds-data rollback-transaction \
    --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \
    --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \
    --transaction-id "ABC1234567890xyz"

Output:

{
    "transactionStatus": "Rollback Complete"
}

Per ulteriori informazioni, consulta Utilizzo dell’API dati per Aurora Serverless nella Guida per l’utente di Amazon RDS.

• Per i dettagli sull'API, consulta RollbackTransaction AWS CLICommand Reference.