This is the repository for the Dynamodb source connector in Java. For information about how to use this connector within Airbyte, see the User Documentation.
From the Airbyte repository root, run:
./gradlew :airbyte-integrations:connectors:source-dynamodb:build
If you are a community contributor, generate the necessary credentials and place them in secrets/config.json
conforming to the spec file in src/main/resources/spec.json
.
Note that the secrets
directory is git-ignored by default, so there is no danger of accidentally checking in sensitive information.
If you are an Airbyte core member, follow the instructions to set up the credentials.
Build the connector image via Gradle:
./gradlew :airbyte-integrations:connectors:source-dynamodb:buildConnectorImage
Once built, the docker image name and tag on your host will be airbyte/source-dynamodb:dev
.
the Dockerfile.
Then run any of the connector commands as follows:
docker run --rm airbyte/source-dynamodb:dev spec
docker run --rm -v $(pwd)/secrets:/secrets airbyte/source-dynamodb:dev check --config /secrets/config.json
docker run --rm -v $(pwd)/secrets:/secrets airbyte/source-dynamodb:dev discover --config /secrets/config.json
docker run --rm -v $(pwd)/secrets:/secrets -v $(pwd)/integration_tests:/integration_tests airbyte/source-dynamodb:dev read --config /secrets/config.json --catalog /integration_tests/configured_catalog.json
We use JUnit
for Java tests.
Place unit tests under src/test/...
Place integration tests in src/test-integration/...
Airbyte has a standard test suite that all source connectors must pass. Implement the TODO
s in
src/test-integration/java/io/airbyte/integrations/sources/dynamodbSourceAcceptanceTest.java
.
All commands should be run from airbyte project root. To run unit tests:
./gradlew :airbyte-integrations:connectors:source-dynamodb:unitTest
To run acceptance and custom integration tests:
./gradlew :airbyte-integrations:connectors:source-dynamodb:integrationTest
You've checked out the repo, implemented a million dollar feature, and you're ready to share your changes with the world. Now what?
- Make sure your changes are passing our test suite:
airbyte-ci connectors --name=source-dynamodb test
- Bump the connector version in
metadata.yaml
: increment thedockerImageTag
value. Please follow semantic versioning for connectors. - Make sure the
metadata.yaml
content is up to date. - Make the connector documentation and its changelog is up to date (
docs/integrations/sources/dynamodb.md
). - Create a Pull Request: use our PR naming conventions.
- Pat yourself on the back for being an awesome contributor.
- Someone from Airbyte will take a look at your PR and iterate with you to merge it into master.