Skip to content

Commit c07d2a6

Browse files
committed
fix: address review feedback round 2
- Restore hardcoded limits table (critical for performance, not all are in dev guide, link to DSQL docs prevents stale numbers) - Merge Workflow 9 into Workflow 7 as 'Validate and Migrate to DSQL' (reduces line count, single entry point for all migration sources) - Trim redundant triggers from description (lint SQL covers dsql-lint, migrate to DSQL covers ORM migration DSQL) 290 lines, mise run build passes.
1 parent 588c8f1 commit c07d2a6

1 file changed

Lines changed: 22 additions & 8 deletions

File tree

  • plugins/databases-on-aws/skills/dsql

plugins/databases-on-aws/skills/dsql/SKILL.md

Lines changed: 22 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: dsql
3-
description: "Build with Aurora DSQL — manage schemas, execute queries, handle migrations, diagnose query plans, and develop applications with a serverless, distributed SQL database. Covers IAM auth, multi-tenant patterns, MySQL-to-DSQL migration, DDL operations, query plan explainability, and SQL compatibility validation via dsql-lint. Triggers on phrases like: DSQL, Aurora DSQL, create DSQL table, DSQL schema, migrate to DSQL, distributed SQL database, serverless PostgreSQL-compatible database, DSQL query plan, DSQL EXPLAIN ANALYZE, why is my DSQL query slow, lint SQL for DSQL, validate SQL DSQL compatibility, ORM migration DSQL, dsql-lint."
3+
description: "Build with Aurora DSQL — manage schemas, execute queries, handle migrations, diagnose query plans, and develop applications with a serverless, distributed SQL database. Covers IAM auth, multi-tenant patterns, MySQL-to-DSQL migration, DDL operations, query plan explainability, and SQL compatibility validation via dsql-lint. Triggers on phrases like: DSQL, Aurora DSQL, create DSQL table, DSQL schema, migrate to DSQL, distributed SQL database, serverless PostgreSQL-compatible database, DSQL query plan, DSQL EXPLAIN ANALYZE, why is my DSQL query slow, lint SQL for DSQL."
44
license: Apache-2.0
55
metadata:
66
tags: aws, aurora, dsql, distributed-sql, distributed, distributed-database, database, serverless, serverless-database, postgresql, postgres, sql, schema, migration, multi-tenant, iam-auth, aurora-dsql, mcp, orm
@@ -150,7 +150,25 @@ See [mcp-tools.md](mcp/mcp-tools.md) for detailed usage and examples.
150150

151151
### AWS Knowledge MCP (`awsknowledge`)
152152

153-
Consult for verifying DSQL service limits before advising users. See [development-guide.md](references/development-guide.md) for default limits and verification queries.
153+
Consult for verifying DSQL service limits before advising users. The numeric limits below are
154+
defaults that may change — when a user's decision depends on an exact limit, verify it first:
155+
156+
| Limit | Default | Verify query |
157+
| ------------------------------ | ------------- | ---------------------------------- |
158+
| Max rows per transaction | 3,000 | `aurora dsql transaction limits` |
159+
| Max data size per transaction | 10 MiB | `aurora dsql transaction limits` |
160+
| Max transaction duration | 5 minutes | `aurora dsql transaction limits` |
161+
| Max connections per cluster | 10,000 | `aurora dsql connection limits` |
162+
| Auth token expiry | 15 minutes | `aurora dsql authentication token` |
163+
| Max connection duration | 60 minutes | `aurora dsql connection limits` |
164+
| Max indexes per table | 24 | `aurora dsql index limits` |
165+
| Max columns per index | 8 | `aurora dsql index limits` |
166+
| IDENTITY/SEQUENCE CACHE values | 1 or >= 65536 | `aurora dsql sequence cache` |
167+
| Supported column data types | See docs | `aurora dsql supported data types` |
168+
169+
**When to verify:** Before recommending batch sizes, connection pool settings, or schema designs where hitting a limit would cause failures; any time the exact number can affect user decision.
170+
171+
**Fallback:** If `awsknowledge` is unavailable, use the defaults above and flag that limits should be verified against [DSQL documentation](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/).
154172

155173
## CLI Scripts Available
156174

@@ -221,9 +239,9 @@ DSQL does NOT support direct `ALTER COLUMN TYPE`, `DROP COLUMN`, `DROP CONSTRAIN
221239

222240
MUST load [ddl-migrations/overview.md](references/ddl-migrations/overview.md) before attempting any of these operations.
223241

224-
### Workflow 7: MySQL to DSQL Schema Migration
242+
### Workflow 7: Validate and Migrate to DSQL
225243

226-
Run `dsql_lint(sql=mysql_ddl, fix=true)` to auto-convert. MUST load [mysql-migrations/type-mapping.md](references/mysql-migrations/type-mapping.md) for unfixable issues or types not covered by auto-fix.
244+
Run `dsql_lint(sql=source_sql, fix=true)` to validate and auto-convert SQL from any source (PostgreSQL, MySQL, ORM-generated). MUST load [dsql-lint.md](references/dsql-lint.md) for the full workflow, ORM-specific guidance, and unfixable error resolution. MUST load [mysql-migrations/type-mapping.md](references/mysql-migrations/type-mapping.md) for MySQL-specific types not covered by auto-fix.
227245

228246
### Workflow 8: Query Plan Explainability
229247

@@ -253,10 +271,6 @@ PGPASSWORD="$TOKEN" psql "host=$HOST port=5432 user=admin dbname=postgres sslmod
253271

254272
**Safety.** Plan capture uses `readonly_query` exclusively — it rejects INSERT/UPDATE/DELETE/DDL at the MCP layer. Rewrite DML to SELECT (Phase 1) rather than asking `transact --allow-writes` to run it; write-mode `transact` bypasses all MCP safety checks. **MUST NOT** run arbitrary DDL/DML or pl/pgsql.
255273

256-
### Workflow 9: Validate & Migrate SQL to DSQL
257-
258-
Validates arbitrary SQL for DSQL compatibility. MUST load [dsql-lint.md](references/dsql-lint.md) for the full workflow, ORM-specific guidance, and unfixable error resolution.
259-
260274
---
261275

262276
## Error Scenarios

0 commit comments

Comments
 (0)