[Enhancement]: Code examples for drivers/plugins/tools built on the AWS SDK

[bartolm]

Background story

Some AWS service teams provide an open-source layer (such as a driver, plugin, tool, etc) built on top of the AWS SDK that enhances interaction with the service's low-level API. In the case of Amazon QLDB, customers use the service's data API to run transactions in their database resource. The QLDB service team doesn't recommend using the data API directly through an AWS SDK because it involves some complex processing logic to successfully make API calls. Instead, they provide an open-source driver (in multiple languages) to streamline interaction with the QLDB data API.

In addition, some service teams (like QLDB) also provide open-source code examples in the form of sample applications in a separate GitHub repository such as aws-samples. It would be great if our AWS SDK code examples library could source code examples directly from other GitHub repo's as well.

What does this example accomplish?

These code examples for QLDB would demonstrate how to run various data transactions on a ledger database by using a QLDB driver, since the QLDB service team doesn't recommend using the data API directly through an AWS SDK. The data transactions would include basic CRUD operations such as:

• Create a table
• Insert a data record into a table
• Query records from a table
• Update a record in a table
• Delete a record from a table

Which AWS service(s)?

Amazon QLDB

Which AWS SDKs or tools?

• [ ] All languages
• [X] .NET
• [X] Go (v2)
• [ ] Java
• [X] Java (v2)
• [ ] JavaScript
• [X] JavaScript (v3)
• [ ] Kotlin
• [ ] PHP
• [X] Python
• [ ] Ruby
• [ ] Rust
• [ ] Swift
• [ ] Not applicable

Are there existing code examples to leverage?

Java sample app in the aws-samples GitHub repo: https://github.com/aws-samples/amazon-qldb-dmv-sample-java (also available for Node.js and Python)

Inline Java code examples in the QLDB Developer Guide (also available for .NET, Go, Node.js, and Python):

• Quick start tutorial: https://docs.aws.amazon.com/qldb/latest/developerguide/driver-quickstart-java.html
• Cookbook reference: https://docs.aws.amazon.com/qldb/latest/developerguide/driver-cookbook-java.html

Do you have any reference code?

No response

[brmur]

@aaronmarkham tagging for awareness

[github-actions[bot]]

Marked stale by the Shirriff. Notifying @awsdocs/aws-sdk-docs-code-maintainers

[Laren-AWS]

The "curated example" feature addresses this. I have a PR (https://github.com/awsdocs/aws-doc-sdk-examples/pull/4186) to get this started. Once that's merged, we can add some metadata to publish QLDB examples and refine as we go.