Create database for Postgres resource

[sebastienros]

Description

Support database creation for AddDatabase() in Postgres container resource. If the database already exists nothing is done. Custom scripts can be provided.

Updated PgAdmin container version.

Part of #7101

Checklist

• Is this feature complete?
  • Yes. Ready to ship.
  • No. Follow-up changes expected.
• Are you including unit tests for the changes and scenario tests if relevant?
  • Yes
  • No
• Did you add public API?
  • Yes
    • If yes, did you have an API Review for it?
      • Yes
      • No
    • Did you add <remarks /> and <code /> elements on your triple slash comments?
      • Yes
      • No
  • No
• Does the change make any security assumptions or guarantees?
  • Yes
    • If yes, have you done a threat model and had a security review?
      • Yes
      • No
  • No
• Does the change require an update in our Aspire docs?
  • Yes
    • Is this introducing a breaking change?
      • Yes
        • Link to aspire-docs issue (please use this breaking-change template):
      • No
        • Link to aspire-docs issue (please use this doc-idea template):
  • No

[Copilot]

Pull Request Overview

This PR adds support for database creation in the Postgres container resource, including the ability to run a custom SQL creation script. Key changes include updating test cases to validate database creation scenarios, enhancing the builder extension logic for Postgres and database resources, and updating container image tags for PgAdmin.

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
tests/Aspire.Hosting.PostgreSQL.Tests/PostgresFunctionalTests.cs	Updated test cases removing redundant environment settings and adding new scenarios for custom scripts, special names, resiliency, and multi-database creation.
src/Aspire.Hosting.PostgreSQL/PostgresBuilderExtensions.cs	Refactored the AddPostgres and AddDatabase logic to handle connection string subscriptions and database creation through a dedicated CreateDatabaseAsync method.
src/Aspire.Hosting.PostgreSQL/PostgresDatabaseResource.cs	Revised the ConnectionStringExpression to use a DbConnectionStringBuilder for constructing the connection string.
src/Aspire.Hosting.PostgreSQL/PostgresContainerImageTags.cs	Updated the PgAdmin container image tag to a newer version.
playground/PostgresEndToEnd/PostgresEndToEnd.AppHost/Program.cs	Adjusted the pgAdmin builder usage by removing an explicit image tag override.

Comments suppressed due to low confidence (3)

src/Aspire.Hosting.PostgreSQL/PostgresDatabaseResource.cs:36

• Ensure that the connection string constructed via DbConnectionStringBuilder.ToString() produces the expected format with all required parameters for consumers. Validate that no essential connection properties are omitted.

return ReferenceExpression.Create($"{Parent};{connectionStringBuilder.ToString()}");

src/Aspire.Hosting.PostgreSQL/PostgresBuilderExtensions.cs:589

• When executing a user-provided creation script, consider propagating the exception after logging instead of only logging the error, to avoid silent failures in database creation.

command.CommandText = scriptAnnotation?.Script;

playground/PostgresEndToEnd/PostgresEndToEnd.AppHost/Program.cs:16

• [nitpick] Removing the explicit call to WithImageTag may lead to an unintended pgAdmin image version being deployed; verify that the desired image version is correctly set via configuration or defaults to ensure compatibility.

var pg6 = builder.AddPostgres("pg6").WithPgAdmin(c => c.WithHostPort(8999)).PublishAsContainer();

[davidfowl]

Don't we want to handle catch (PostgresException p) when (p.SqlState == "42P04") here too? Or is the expectation that they are already checking for database existence.

[sebastienros]

Since the script could contain other things than create database I didn't want to hide errors. But now it's only supporting create db so it's doing the same thing.

[davidfowl]

What's special about this that we need to use the builder? Does it escape properly?

[sebastienros]

It does, and there is a functional test to validate we can pass database name with special chars to ensure the connection string and the default CREATE DATABASE script are correctly escaping.

[sebastienros]

I did it for Sql Server too btw.