Merge pull request #2575 from jojo786/jojo786-feature-lambda-aurora-s…

…erverlessv2-postgresql lambda-aurora-serverlessv2-postgresql: aurora scales to zero
aws-samples · Jan 3, 2025 · 432cffd · 432cffd
2 parents c962753 + aeabfe9
commit 432cffd
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 3 deletions.
diff --git a/lambda-aurora-serverlessv2-postgresql/README.md b/lambda-aurora-serverlessv2-postgresql/README.md
@@ -39,7 +39,7 @@ Important: this application uses various AWS services and there are costs associ
 
 ## How it works
 
-This pattern creates an AWS Lambda function and an [Amazon Aurora PostgreSQL DB](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.AuroraPostgreSQL.html) in an [Aurora Serverless v2](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.html) DB cluster with [RDS Data API](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) and a Secrets Manager secret. The function creates an example table named "music", inserts a row with data from the event object, then returns the results of a select query.
+This pattern creates an AWS Lambda function and an [Amazon Aurora PostgreSQL DB](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.AuroraPostgreSQL.html) in an [Aurora Serverless v2](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.html) DB cluster that scales to zero, with [RDS Data API](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) and a Secrets Manager secret. The function creates an example table named "music", inserts a row with data from the event object, then returns the results of a select query.
 
 ## Testing
 
@@ -67,7 +67,14 @@ Response:
 }
 ```
 
+Aurora Serverless v2 DB instances can automatically pause after a period with no user connections, and automatically resume when a connection request arrives. If it was paused, it will automatically resume and accept the connection. You may see this error in the Lambda logs:
+```
+"An error occurred (DatabaseResumingException) when calling the ExecuteStatement operation: The Aurora DB instance arn:aws:rds:..... is resuming after being auto-paused. Please wait a few seconds and try again."
+```
+
+
 ## Documentation
+- [Amazon Aurora Serverless v2 supports scaling to zero capacity](https://aws.amazon.com/about-aws/whats-new/2024/11/amazon-aurora-serverless-v2-scaling-zero-capacity/)
 - [Using the Data API for Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html)
 - [Data API - ExecuteStatement](https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/API_ExecuteStatement.html)
 - [Data API - ExecuteStatement Response Elements](https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/API_ExecuteStatement.html#API_ExecuteStatement_ResponseElements)

diff --git a/lambda-aurora-serverlessv2-postgresql/template.yaml b/lambda-aurora-serverlessv2-postgresql/template.yaml
@@ -8,10 +8,11 @@ Description: >
 Globals:
   Function:
     CodeUri: ./src
-    Runtime: python3.12
+    Runtime: python3.13
     MemorySize: 128
     Timeout: 10
     LoggingConfig:
+      LogGroup: !Sub /aws/lambda/${AWS::StackName}
       LogFormat: JSON
     Architectures:
       - arm64
@@ -65,11 +66,12 @@ Resources:
       DatabaseName: !Ref DatabaseName
       Engine: aurora-postgresql
       EngineMode: provisioned
+      EngineVersion: '16.4'
       StorageEncrypted: true
       # Enable the Data API for Aurora Serverless
       EnableHttpEndpoint: true
       ServerlessV2ScalingConfiguration:
-        MinCapacity: 0.5
+        MinCapacity: 0 #auto-pause
         MaxCapacity: 1
   AuroraInstance:
     Type: 'AWS::RDS::DBInstance'