Exemples d’utilisation de l’AWS CLI avec Amazon RDS Data Service - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec Amazon RDS Data Service

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec Amazon RDS Data Service.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser batch-execute-statement.

AWS CLI

Pour exécuter une instruction SQL par lots

L’exemple batch-execute-statement suivant exécute une instruction SQL par lots sur un tableau de données avec un jeu de paramètres.

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\"}}]]"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Using the Data API for Aurora Serverless dans le Guide de l’utilisateur Amazon RDS.

  • Pour plus de détails sur l’API, consultez BatchExecuteStatement dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser begin-transaction.

AWS CLI

Pour démarrer une transaction SQL

L’exemple begin-transaction suivant démarre une transaction 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"

Sortie :

{
    "transactionId": "ABC1234567890xyz"
}

Pour plus d’informations, consultez Using the Data API for Aurora Serverless dans le Guide de l’utilisateur Amazon RDS.

  • Pour plus de détails sur l’API, consultez BeginTransaction dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser commit-transaction.

AWS CLI

Pour valider une transaction SQL

L’exemple commit-transaction suivant met fin à la transaction SQL spécifiée et valide les modifications que vous avez apportées dans le cadre de celle-ci.

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"

Sortie :

{
    "transactionStatus": "Transaction Committed"
}

Pour plus d’informations, consultez Using the Data API for Aurora Serverless dans le Guide de l’utilisateur Amazon RDS.

  • Pour plus de détails sur l’API, consultez CommitTransaction dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser execute-statement.

AWS CLI

Exemple 1 : pour exécuter une instruction SQL faisant partie d’une transaction

L’exemple execute-statement suivant exécute une instruction SQL faisant partie d’une transaction.

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"

Sortie :

{
    "numberOfRecordsUpdated": 1
}

Exemple 2 : pour exécuter une instruction SQL avec des paramètres

L’exemple execute-statement suivant exécute une instruction SQL avec des paramètres.

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\"}}]"

Sortie :

{
    "numberOfRecordsUpdated": 1
}

Pour plus d’informations, consultez Using the Data API for Aurora Serverless dans le Guide de l’utilisateur Amazon RDS.

  • Pour plus de détails sur l’API, consultez ExecuteStatement dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser rollback-transaction.

AWS CLI

Pour restaurer une transaction SQL

L’exemple rollback-transaction suivant restaure la transaction SQL spécifiée.

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"

Sortie :

{
    "transactionStatus": "Rollback Complete"
}

Pour plus d’informations, consultez Using the Data API for Aurora Serverless dans le Guide de l’utilisateur Amazon RDS.

  • Pour plus de détails sur l’API, consultez RollbackTransaction dans la Référence des commandes de l’AWS CLI.