Esempi per il servizio dati di Amazon RDS con AWS CLI - Esempi di codice per SDK AWS
Azioni

Sono disponibili altri esempi per SDK AWS nel repository GitHub della documentazione degli esempi per SDK AWS.

Esempi per il servizio dati di Amazon RDS con AWS CLI

Gli esempi di codice seguenti mostrano come eseguire operazioni e implementare scenari comuni utilizzando AWS Command Line Interface con il servizio dati di Amazon RDS.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni 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.

Argomenti

Azioni

L’esempio di codice seguente mostra come utilizzare batch-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 informazioni dettagliate sull’API, consulta BatchExecuteStatement nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare begin-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 informazioni dettagliate sull’API, consulta BeginTransaction in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare commit-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 informazioni dettagliate sull’API, consulta CommitTransaction nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare execute-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 informazioni dettagliate sull’API, consulta ExecuteStatement nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare rollback-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 informazioni dettagliate sull’API, consulta RollbackTransaction in AWS CLI Command Reference.