Esempi per il servizio dati di Amazon RDS con AWS CLI - AWS Command Line Interface
Operazioni

Questa documentazione è valida solo per la Versione 1 della AWS CLI. Per la documentazione relativa alla versione 2 della AWS CLI, consulta la Guida per l’utente per la Versione 2.

Esempi per il servizio dati di Amazon RDS con AWS CLI

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

Le operazioni 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, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

L’esempio di codice seguente mostra come utilizzare batch-execute-statement.

AWS CLI

Come eseguire un’istruzione SQL in batch

Nell’esempio seguente, la batch-execute-statement 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.

L’esempio di codice seguente mostra come utilizzare begin-transaction.

AWS CLI

Come iniziare una transazione SQL

Nell’esempio seguente begin-transaction 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 in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare execute-statement.

AWS CLI

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

Nell’esempio seguente execute-statement 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: per eseguire un’istruzione SQL con parametri

Nell’esempio seguente execute-statement 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 in AWS CLI Command Reference.

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.