DynamoDB VDB Provider

DynamoDB VDB Provider connects Drupal AI Search to Amazon DynamoDB native vector search. It stores content chunks, metadata, and embeddings in DynamoDB and returns relevant results to Drupal AI Search for retrieval-augmented generation (RAG) workflows.

The module is designed for teams that want to evaluate DynamoDB as a vector database while keeping local, development, QA, and production data isolated. Enabling the module does not automatically create AWS resources, change existing Search API servers, or delete DynamoDB data.

Features

• Native Amazon DynamoDB vector search integration for Drupal AI Search.
• Deterministic, environment-specific table names for local, development, QA, and production deployments.
• AWS SDK default credential chain support; AWS access keys are never stored in Drupal configuration.
• Drush commands to preview setup, provision local evaluation tables, and validate connection, ownership, schema, and readiness.
• Cosine similarity search with scalar equality filters on configured inline fields.
• Drupal configuration page plus environment-variable and settings.php overrides for deployment-controlled configuration.
• Deletion protection and strict validation that avoids silently reusing tables with incompatible schemas or ownership.

Installation and configuration

1. Install the module and its Composer dependencies.
2. Enable ai_vdb_provider_dynamodb.
3. Configure the AWS region, account ID, project, environment, owner, collection, vector dimensions, and filter fields at Configuration → AI → Vector DB Providers → DynamoDB configuration.
4. Provide AWS credentials through the normal AWS SDK credential chain, preferably using temporary credentials or workload roles.
5. Run drush dynamodb:setup to review the table plan. For local evaluation, use drush dynamodb:setup --apply; shared environments should be provisioned through reviewed infrastructure tooling.
6. Create or update an AI Search server and select Amazon DynamoDB as its vector provider.

Requirements

• PHP 8.3 or later.
• Drupal 10.3 or Drupal 11.
• Drupal AI 1.4 or later, including AI Search.
• Search API 1.41 or later.
• AWS SDK for PHP 3.394.9 or later.
• An AWS DynamoDB endpoint with vector index support. DynamoDB Local does not support vector indexes.
• Drush 12 or 13 for the optional setup and status commands.

Security and production status

This project is currently experimental and is not covered by Drupal's security advisory policy. Live AWS integration testing and an independent security review are required before a stable production release. Use least-privilege IAM policies, temporary credentials, separate production roles or accounts, and normal Drupal Search API access controls.

Similar projects

Drupal AI includes other vector database providers. This module is specifically for Amazon DynamoDB and adds deterministic environment isolation, ownership validation, and DynamoDB-focused provisioning and operational safeguards.

Documentation

• README and complete usage guide
• Environment provisioning workflow
• AWS IAM guidance
• Contributing