aurora-dsql

Provisions and manages Aurora DSQL clusters with IAM-authenticated psql queries and safe SQL construction.

Updated Jul 1, 2026
One-click install
npx skills add https://github.com/sakicodes/BuildFestHackathon26 --skill aurora-dsql-sakicodes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aurora-dsql
Source: https://github.com/sakicodes/BuildFestHackathon26/tree/main/.agents/skills/aurora-dsql
Command: npx skills add https://github.com/sakicodes/BuildFestHackathon26 --skill aurora-dsql-sakicodes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Working with Amazon Aurora DSQL requires navigating IAM token authentication, DSQL-specific DDL constraints (one DDL per transaction, async indexes, no foreign keys), transaction limits, and SQL injection risks when building queries from untrusted input. This Skill provides the scripts, reference guides, and enforced patterns to perform DSQL operations correctly without memorizing every constraint. ## Core Features & Use Cases - Cluster Lifecycle Management: Create, list, inspect, and delete DSQL clusters via bundled bash scripts that wrap the AWS CLI with tagging and deletion protection. - IAM-Authenticated Query Execution: Run ad-hoc queries through psql-connect.sh, which handles auth token generation, TLS configuration, and single-statement guards. - Safe SQL Construction: Build every query with safe_query.build() validators (allow, regex, ident, keyword, literal) to prevent SQL injection from tenant IDs, UUIDs, sort columns, and free text. - Migration & Diagnostics: Execute table-recreation DDL migrations, MySQL-to-DSQL schema migrations, and structured query-plan diagnosis with EXPLAIN ANALYZE and GUC experiments. - Use Case: A developer building a multi-tenant app asks the agent to create a DSQL cluster, set up scoped database roles, and write a batch insert — the Skill enforces tenant_id isolation, 3,000-row transaction chunking, and validated SQL at every step. ## Quick Start Ask the agent to create an Aurora DSQL cluster and connect to it with psql to list the tables in the public schema.

Frequently Asked Questions about aurora-dsql

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect to an Aurora DSQL cluster with psql?

Generate an IAM auth token with aws dsql generate-db-connect-auth-token, then connect via psql with sslmode=verify-full. The bundled psql-connect.sh script wraps token generation, TLS configuration, and single-statement guards in one command.

How do I prevent SQL injection when building DSQL queries?

Build every query with safe_query.build() using validators: allow() for known sets, regex() for UUIDs and tenant slugs, ident() for table and column names, and literal() for free text. Never use f-strings or concatenation with untrusted input.

Does Aurora DSQL support ALTER COLUMN TYPE or DROP COLUMN?

No, DSQL does not support direct ALTER COLUMN TYPE, DROP COLUMN, DROP CONSTRAINT, or MODIFY PRIMARY KEY. These changes require the Table Recreation Pattern: create a new table, batch-copy data under 3,000 rows per transaction, verify, and swap.

What are the Aurora DSQL transaction limits?

Default limits are 3,000 rows mutated per transaction, 10 MiB of data per write transaction, and 5-minute transaction duration. Verify current values against DSQL documentation since limits may change.

Can I use the bare pg or psycopg driver with Aurora DSQL?

Bare drivers work only until the first 15-minute IAM token expiry, then fail with auth errors on new connections. Use the official DSQL Connector for your language, which handles automatic IAM token refresh and TLS defaults.

How do I migrate a MySQL schema to Aurora DSQL?

Load the mysql-migrations references for type mappings and DDL translation. Key conversions include replacing AUTO_INCREMENT with IDENTITY or UUID, replacing ENUM and SET types, and moving foreign key enforcement to the application layer.