Registry / database / db-migrate-pg-aurora

db-migrate-pg-aurora

library1.0.0jsnpmunverified

A db-migrate driver for PostgreSQL Aurora Serverless via the Data API. It allows running database migrations on AWS Aurora Serverless clusters using the db-migrate framework, bypassing traditional database connections. Version 1.0.0 is alpha stability, with peer dependency on db-migrate ^0.11.6. Key differentiator: enables migrations on Aurora Serverless where direct PostgreSQL connections are not available. Release cadence is unknown; last updated in 2019. No active maintenance or updates.

database

npm install db-migrate-pg-aurora

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · DB-MIGRATE-PG-AURO

db-migrate-pg-aurora

databasejavascriptv1.0.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

driver

✓ In database.json, set "driver": { "require": "db-migrate-pg-aurora" }

✗ Mistaking it for a module imported in code directly

This is a db-migrate driver, not a library imported in scripts. It is configured via database.json

Configuration example for database.json to use db-migrate-pg-aurora driver with Aurora Serverless

{ "prod": { "driver": { "require": "db-migrate-pg-aurora" }, "database": "<Database Name>", "schema": "<Schema Name>", "secretArn": "<Secrets Manager ARN>", "resourceArn": "<Database Cluster ARN>", "region": "<AWS Region>", "maxRetries": 3, "connectTimeout": 45000 } }

Debug

Known issues

gotchaOnly works with Aurora Serverless (Data API), not standard PostgreSQL or Aurora Provisioned.

fix

Ensure your cluster is Aurora Serverless v1 or v2 with Data API enabled.

affects: >=1.0.0

deprecatedPackage marked as alpha stability; no releases since 2019. May not work with newer db-migrate versions.

fix

Consider using db-migrate-pg with IAM authentication for Aurora Serverless, or evaluate other approaches.

affects: >=1.0.0

gotchaRequires `secretArn` and `resourceArn` from AWS Secrets Manager and RDS; misconfiguration leads to cryptic errors.

fix

Verify ARN format, IAM permissions for RDS Data API and Secrets Manager.

affects: >=1.0.0

breakingPeer dependency on db-migrate ^0.11.6; incompatible with db-migrate 1.x+.

fix

Use db-migrate 0.11.x; check your db-migrate version before installing.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'db-migrate-pg-aurora'

Driver not installed or peer dependency not met.

fix

Run npm install db-migrate-pg-aurora db-migrate@0.11.6 --save

Error: connect ETIMEDOUT

Incorrect ARN, region, or network/VPC configuration.

fix

Check resourceArn, secretArn, region, and ensure database is publicly accessible or use VPC endpoints for Data API.

Upgrade

Version history

1.0.0latest on npm

Audit

Dependencies

db-migraterequiredcore migration framework required as peer dependency

Agent activity

11 hits · last 30 days

node

Resources

githubhttps://github.com/drg-adaptive/db-migrate-pg-aurora ↗

packagedb-migrate-pg-aurora ↗

homepagehttps://github.com/drg-adaptive/db-migrate-pg-aurora ↗