Exemples d'utilisation d'Amazon RDS Data Service AWS CLI - AWS Command Line Interface
Actions

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Exemples d'utilisation d'Amazon RDS Data Service AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide d'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 montrent comment appeler des fonctions de service individuelles, vous pouvez les visualiser dans leur contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utiliserbatch-execute-statement.

AWS CLI

Pour exécuter une SQL instruction par lots

L'batch-execute-statementexemple suivant exécute une SQL instruction batch sur un tableau de données avec un ensemble 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 aucun résultat.

Pour plus d'informations, consultez la section Utilisation des données API pour Aurora Serverless dans le guide de l'RDSutilisateur Amazon.

L'exemple de code suivant montre comment utiliserbegin-transaction.

AWS CLI

Pour démarrer une SQL transaction

L'begin-transactionexemple suivant démarre une SQL transaction.

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 la section Utilisation des données API pour Aurora Serverless dans le guide de l'RDSutilisateur Amazon.

  • Pour API plus de détails, voir BeginTransactionla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercommit-transaction.

AWS CLI

Pour valider une SQL transaction

L'commit-transactionexemple suivant met fin à la SQL transaction 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 la section Utilisation des données API pour Aurora Serverless dans le guide de l'RDSutilisateur Amazon.

  • Pour API plus de détails, voir CommitTransactionla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserexecute-statement.

AWS CLI

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

L'execute-statementexemple suivant exécute une SQL instruction 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 SQL instruction avec des paramètres

L'execute-statementexemple suivant exécute une SQL instruction 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 la section Utilisation des données API pour Aurora Serverless dans le guide de l'RDSutilisateur Amazon.

  • Pour API plus de détails, voir ExecuteStatementla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserrollback-transaction.

AWS CLI

Pour annuler une SQL transaction

L'rollback-transactionexemple suivant annule la SQL transaction 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 la section Utilisation des données API pour Aurora Serverless dans le guide de l'RDSutilisateur Amazon.

  • Pour API plus de détails, voir RollbackTransactionla section Référence des AWS CLI commandes.