From e48bd082fe895bf27cd8200e9693a3c21e77e670 Mon Sep 17 00:00:00 2001
From: AJ Matthews <alistair.matthews@civica.co.uk>
Date: Thu, 29 Jan 2026 16:18:02 +0000
Subject: [PATCH] Corrected the use of connections strings in several
 integration documents.

---
 .../efcore/mysql/mysql-get-started.mdx        |  6 ++--
 .../databases/efcore/oracle/oracle-host.mdx   |  1 -
 .../efcore/postgres/postgresql-client.mdx     |  3 +-
 .../efcore/sql-server/sql-server-client.mdx   |  2 --
 .../elasticsearch-get-started.mdx             | 34 -------------------
 .../elasticsearch/elasticsearch-host.mdx      |  2 +-
 .../databases/milvus/milvus-get-started.mdx   |  6 ++--
 .../databases/milvus/milvus-host.mdx          |  1 -
 .../databases/mongodb/mongodb-get-started.mdx |  4 +--
 .../databases/mongodb/mongodb-host.mdx        |  3 +-
 .../databases/qdrant/qdrant-get-started.mdx   |  6 ++--
 .../databases/qdrant/qdrant-host.mdx          |  1 -
 .../databases/sql-server/sql-server-host.mdx  |  2 +-
 13 files changed, 14 insertions(+), 57 deletions(-)

diff --git a/src/frontend/src/content/docs/integrations/databases/efcore/mysql/mysql-get-started.mdx b/src/frontend/src/content/docs/integrations/databases/efcore/mysql/mysql-get-started.mdx
index d04f7a65..b09bc796 100644
--- a/src/frontend/src/content/docs/integrations/databases/efcore/mysql/mysql-get-started.mdx
+++ b/src/frontend/src/content/docs/integrations/databases/efcore/mysql/mysql-get-started.mdx
@@ -85,9 +85,9 @@ Aspire exposes each property as an environment variable named `[RESOURCE]_[PROPE
 Use the `GetValue()` method to obtain these environment variables in consuming projects:
 
 ```csharp title="C# - Obtain configuration properties"
-string connectionString = builder.Configuration.GetValue<string>("ConnectionStrings__mysqldb");
-string host = builder.Configuration.GetValue<string>("MYSQLDB_HOST");
-string databaseName = builder.Configuration.GetValue<string>("MYSQLDB_DATABASENAME");
+var connectionUri = builder.Configuration.GetConnectionString("mysqldb");
+var host = builder.Configuration.GetValue<string>("MYSQLDB_HOST");
+var databaseName = builder.Configuration.GetValue<string>("MYSQLDB_DATABASENAME");
 ```
 
 <Aside type="tip">
diff --git a/src/frontend/src/content/docs/integrations/databases/efcore/oracle/oracle-host.mdx b/src/frontend/src/content/docs/integrations/databases/efcore/oracle/oracle-host.mdx
index 24968388..7570c765 100644
--- a/src/frontend/src/content/docs/integrations/databases/efcore/oracle/oracle-host.mdx
+++ b/src/frontend/src/content/docs/integrations/databases/efcore/oracle/oracle-host.mdx
@@ -161,7 +161,6 @@ var pythonApp = builder.AddUvicornApp("api", "./api", "main.app")
 
 The following environment variables are available in the Python application:
 
-- `ConnectionStrings__oracledb` - The connection string for the Oracle database
 - `ORACLEDB_HOST` - The hostname of the Oracle server
 - `ORACLEDB_PORT` - The port number
 - `ORACLEDB_USERNAME` - The username for authentication
diff --git a/src/frontend/src/content/docs/integrations/databases/efcore/postgres/postgresql-client.mdx b/src/frontend/src/content/docs/integrations/databases/efcore/postgres/postgresql-client.mdx
index b284c807..feacd5ce 100644
--- a/src/frontend/src/content/docs/integrations/databases/efcore/postgres/postgresql-client.mdx
+++ b/src/frontend/src/content/docs/integrations/databases/efcore/postgres/postgresql-client.mdx
@@ -76,7 +76,6 @@ When you reference a `PostgresDatabaseResource` (a specific database), the follo
 | `Username` | `[RESOURCE]_USERNAME` | The username for authenticating to the PostgreSQL server. |
 | `Password` | `[RESOURCE]_PASSWORD` | The password for authenticating to the PostgreSQL server. |
 | `DatabaseName` | `[RESOURCE]_DATABASENAME` | The name of the specific database. |
-| `ConnectionString` | `ConnectionStrings__[RESOURCE]` | The full connection string for the database. |
 | `JDBCConnectionString` | `[RESOURCE]_JDBCCONNECTIONSTRING` | The JDBC connection string for the database. |
 
 Here's an example of how these properties are used when you call `WithReference`:
@@ -91,7 +90,7 @@ var myService = builder.AddProject<Projects.ExampleProject>()
                        .WithReference(postgresdb);
 ```
 
-In this example, the `ExampleProject` will have access to environment variables like `POSTGRESDB_HOST`, `POSTGRESDB_PORT`, `POSTGRESDB_USERNAME`, `POSTGRESDB_PASSWORD`, `POSTGRESDB_DATABASENAME`, `POSTGRESDB_JDBCCONNECTIONSTRING`, and the connection string `ConnectionStrings__postgresdb`.
+In this example, the `ExampleProject` will have access to environment variables like `POSTGRESDB_HOST`, `POSTGRESDB_PORT`, `POSTGRESDB_USERNAME`, `POSTGRESDB_PASSWORD`, `POSTGRESDB_DATABASENAME`, and `POSTGRESDB_JDBCCONNECTIONSTRING`.
 
 ## Enrich an Npgsql database context
 
diff --git a/src/frontend/src/content/docs/integrations/databases/efcore/sql-server/sql-server-client.mdx b/src/frontend/src/content/docs/integrations/databases/efcore/sql-server/sql-server-client.mdx
index e7a4729f..8b78a714 100644
--- a/src/frontend/src/content/docs/integrations/databases/efcore/sql-server/sql-server-client.mdx
+++ b/src/frontend/src/content/docs/integrations/databases/efcore/sql-server/sql-server-client.mdx
@@ -76,7 +76,6 @@ The SQL Server database resource inherits all properties from its parent `SqlSer
 | Property Name      | Description                                                                                                                   |
 | ------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
 | `DatabaseName`     | The name of the database                                                                                                      |
-| `ConnectionString` | The connection string for the database, with the format `Server={Host},{Port};User ID={Username};Password={Password};Database={DatabaseName};Encrypt=true;TrustServerCertificate=false` |
 | `JdbcConnectionString` | The JDBC connection string for the database, with the format `jdbc:sqlserver://{Host}:{Port};database={DatabaseName};user={Username};password={Password};encrypt=true;` |
 
 For example, if you reference a database resource named `sqldb` in your AppHost project, the following environment variables will be available in the consuming project:
@@ -87,7 +86,6 @@ For example, if you reference a database resource named `sqldb` in your AppHost
 - `SQLDB_USERNAME`
 - `SQLDB_PASSWORD`
 - `SQLDB_DATABASENAME`
-- `ConnectionStrings__sqldb` (the full connection string)
 - `SQLDB_JDBCCONNECTIONSTRING`
 
 ## Enrich a SQL Server database context
diff --git a/src/frontend/src/content/docs/integrations/databases/elasticsearch/elasticsearch-get-started.mdx b/src/frontend/src/content/docs/integrations/databases/elasticsearch/elasticsearch-get-started.mdx
index 6b3cbe35..c0c18b2b 100644
--- a/src/frontend/src/content/docs/integrations/databases/elasticsearch/elasticsearch-get-started.mdx
+++ b/src/frontend/src/content/docs/integrations/databases/elasticsearch/elasticsearch-get-started.mdx
@@ -154,40 +154,6 @@ import { Client } from '@elastic/elasticsearch';
 
 </Pivot>
 
-### Use injected Elasticsearch properties
-
-In the AppHost, when you used the `WithReference` method to pass an Elasticsearch resource to a consuming client project, Aspire injects a connection string property that you can use in the consuming project. Aspire exposes the connection string as an environment variable named `ConnectionStrings__elasticsearch`.
-
-<Pivot id="csharp">
-
-Use the `GetValue()` method to obtain this environment variable in consuming projects:
-
-```csharp title="C# - Obtain configuration properties"
-string endpoint = builder.Configuration.GetValue<string>("ConnectionStrings__elasticsearch");
-```
-
-</Pivot>
-
-<Pivot id="python">
-
-Use the `os.getenv()` method to obtain this environment variable in consuming projects:
-
-```python title="Python - Obtain configuration properties"
-elasticsearch_endpoint = os.getenv("ConnectionStrings__elasticsearch")
-```
-
-</Pivot>
-
-<Pivot id="javascript">
-
-Use the `process.env` method to obtain this environment variable in consuming projects:
-
-```javascript title="JavaScript - Obtain configuration properties"
-const elasticsearchEndpoint = process.env.ConnectionStrings__elasticsearch;
-```
-
-</Pivot>
-
 ### Use Elasticsearch resources in client code
 
 <Pivot id="csharp">
diff --git a/src/frontend/src/content/docs/integrations/databases/elasticsearch/elasticsearch-host.mdx b/src/frontend/src/content/docs/integrations/databases/elasticsearch/elasticsearch-host.mdx
index dc2d23e9..e666acd3 100644
--- a/src/frontend/src/content/docs/integrations/databases/elasticsearch/elasticsearch-host.mdx
+++ b/src/frontend/src/content/docs/integrations/databases/elasticsearch/elasticsearch-host.mdx
@@ -129,7 +129,7 @@ from elasticsearch import Elasticsearch
 import os
 
 # Get the Elasticsearch endpoint from environment variables
-elasticsearch_endpoint = os.getenv("ConnectionStrings__elasticsearch")
+elasticsearch_endpoint = os.getenv("ConnectionStrings:elasticsearch")
 
 # Create Elasticsearch client
 es = Elasticsearch(elasticsearch_endpoint)
diff --git a/src/frontend/src/content/docs/integrations/databases/milvus/milvus-get-started.mdx b/src/frontend/src/content/docs/integrations/databases/milvus/milvus-get-started.mdx
index 88d746ec..7ffeadb3 100644
--- a/src/frontend/src/content/docs/integrations/databases/milvus/milvus-get-started.mdx
+++ b/src/frontend/src/content/docs/integrations/databases/milvus/milvus-get-started.mdx
@@ -176,8 +176,8 @@ Aspire exposes each property as an environment variable named `[RESOURCE]_[PROPE
 Use the `GetValue()` method to obtain these environment variables in consuming projects:
 
 ```csharp title="C# - Obtain configuration properties"
-string connectionUri = builder.Configuration.GetValue<string>("ConnectionStrings__milvusdb");
-string token = builder.Configuration.GetValue<string>("MILVUSDB_TOKEN");
+var connectionUri = builder.Configuration.GetConnectionString("milvusdb");
+var token = builder.Configuration.GetValue<string>("MILVUSDB_TOKEN");
 ```
 
 </Pivot>
@@ -187,7 +187,7 @@ string token = builder.Configuration.GetValue<string>("MILVUSDB_TOKEN");
 Use the `os.getenv()` method to obtain these environment variables in consuming projects:
 
 ```python title="Python - Obtain configuration properties"
-connection_uri = os.getenv("ConnectionStrings__milvusdb")
+connection_uri = os.getenv("ConnectionStrings:milvusdb")
 host = os.getenv("MILVUSDB_HOST")
 port = os.getenv("MILVUSDB_PORT")
 token = os.getenv("MILVUSDB_TOKEN")
diff --git a/src/frontend/src/content/docs/integrations/databases/milvus/milvus-host.mdx b/src/frontend/src/content/docs/integrations/databases/milvus/milvus-host.mdx
index 23883541..86fb474b 100644
--- a/src/frontend/src/content/docs/integrations/databases/milvus/milvus-host.mdx
+++ b/src/frontend/src/content/docs/integrations/databases/milvus/milvus-host.mdx
@@ -178,7 +178,6 @@ var pythonApp = builder.AddUvicornApp("api", "./api", "main.app")
 
 The following environment variables are available in the Python application:
 
-- `ConnectionStrings__milvusdb` - The connection string for the Milvus database
 - `MILVUSDB_HOST` - The hostname of the Milvus server
 - `MILVUSDB_PORT` - The gRPC port number
 - `MILVUSDB_TOKEN` - The authentication token (format: `root:{password}`)
diff --git a/src/frontend/src/content/docs/integrations/databases/mongodb/mongodb-get-started.mdx b/src/frontend/src/content/docs/integrations/databases/mongodb/mongodb-get-started.mdx
index 9b0cfc4f..e5598d77 100644
--- a/src/frontend/src/content/docs/integrations/databases/mongodb/mongodb-get-started.mdx
+++ b/src/frontend/src/content/docs/integrations/databases/mongodb/mongodb-get-started.mdx
@@ -178,7 +178,7 @@ Aspire exposes each property as an environment variable named `[RESOURCE]_[PROPE
 Use the `GetValue()` method to obtain these environment variables in consuming projects:
 
 ```csharp title="C# - Obtain configuration properties"
-string connectionUri = builder.Configuration.GetValue<string>("ConnectionStrings__mongodb");
+var connectionUri = builder.Configuration.GetConnectionString("mongodb");
 string host = builder.Configuration.GetValue<string>("MONGODB_HOST");
 string databaseName = builder.Configuration.GetValue<string>("MONGODB_DATABASENAME");
 ```
@@ -190,7 +190,7 @@ string databaseName = builder.Configuration.GetValue<string>("MONGODB_DATABASENA
 Use the `os.getenv()` method to obtain these environment variables in consuming projects:
 
 ```python title="Python - Obtain configuration properties"
-connection_uri = os.getenv("ConnectionStrings__mongodb")
+connection_uri = os.getenv("ConnectionStrings:mongodb")
 host = os.getenv("MONGODB_HOST")
 port = os.getenv("MONGODB_PORT")
 username = os.getenv("MONGODB_USERNAME")
diff --git a/src/frontend/src/content/docs/integrations/databases/mongodb/mongodb-host.mdx b/src/frontend/src/content/docs/integrations/databases/mongodb/mongodb-host.mdx
index cf123da0..eeba9488 100644
--- a/src/frontend/src/content/docs/integrations/databases/mongodb/mongodb-host.mdx
+++ b/src/frontend/src/content/docs/integrations/databases/mongodb/mongodb-host.mdx
@@ -237,7 +237,6 @@ var pythonApp = builder.AddUvicornApp("api", "./api", "main.app")
 
 The following environment variables are available in the Python application:
 
-- `ConnectionStrings__mongodb` - The connection string for the MongoDB database
 - `MONGODB_HOST` - The hostname of the MongoDB server
 - `MONGODB_PORT` - The port number
 - `MONGODB_USERNAME` - The username for authentication
@@ -254,7 +253,7 @@ from pymongo import MongoClient
 import os
 
 # Get connection properties
-connection_uri = os.getenv("ConnectionStrings__mongodb")
+connection_uri = os.getenv("ConnectionStrings:mongodb")
 database_name = os.getenv("MONGODB_DATABASENAME")
 
 # Create MongoDB client
diff --git a/src/frontend/src/content/docs/integrations/databases/qdrant/qdrant-get-started.mdx b/src/frontend/src/content/docs/integrations/databases/qdrant/qdrant-get-started.mdx
index 394f0d78..b3b76413 100644
--- a/src/frontend/src/content/docs/integrations/databases/qdrant/qdrant-get-started.mdx
+++ b/src/frontend/src/content/docs/integrations/databases/qdrant/qdrant-get-started.mdx
@@ -172,8 +172,8 @@ Aspire exposes each property as an environment variable named `[RESOURCE]_[PROPE
 Use the `GetValue()` method to obtain these environment variables in consuming projects:
 
 ```csharp title="C# - Obtain configuration properties"
-string connectionString = builder.Configuration.GetValue<string>("ConnectionStrings__qdrant");
-string apiKey = builder.Configuration.GetValue<string>("QDRANT_APIKEY");
+var connectionUri = builder.Configuration.GetConnectionString("qdrant");
+var apiKey = builder.Configuration.GetValue<string>("QDRANT_APIKEY");
 ```
 
 </Pivot>
@@ -183,7 +183,6 @@ string apiKey = builder.Configuration.GetValue<string>("QDRANT_APIKEY");
 Use the `os.getenv()` method to obtain these environment variables in consuming projects:
 
 ```python title="Python - Obtain configuration properties"
-connection_string = os.getenv("ConnectionStrings__qdrant")
 api_key = os.getenv("QDRANT_APIKEY")
 grpc_host = os.getenv("QDRANT_GRPCHOST")
 grpc_port = os.getenv("QDRANT_GRPCPORT")
@@ -196,7 +195,6 @@ grpc_port = os.getenv("QDRANT_GRPCPORT")
 Use the `process.env` property to obtain these environment variables in consuming projects:
 
 ```javascript title="JavaScript - Obtain configuration properties"
-const connectionString = process.env.ConnectionStrings__qdrant;
 const apiKey = process.env.QDRANT_APIKEY;
 const grpcHost = process.env.QDRANT_GRPCHOST;
 const grpcPort = process.env.QDRANT_GRPCPORT;
diff --git a/src/frontend/src/content/docs/integrations/databases/qdrant/qdrant-host.mdx b/src/frontend/src/content/docs/integrations/databases/qdrant/qdrant-host.mdx
index 1ca25cd6..44e2b612 100644
--- a/src/frontend/src/content/docs/integrations/databases/qdrant/qdrant-host.mdx
+++ b/src/frontend/src/content/docs/integrations/databases/qdrant/qdrant-host.mdx
@@ -146,7 +146,6 @@ var pythonApp = builder.AddUvicornApp("api", "./api", "main.app")
 
 The following environment variables are available in the Python application:
 
-- `ConnectionStrings__qdrant` - The connection string for the Qdrant server
 - `QDRANT_GRPCHOST` - The gRPC hostname of the Qdrant server
 - `QDRANT_GRPCPORT` - The gRPC port number
 - `QDRANT_HTTPHOST` - The HTTP hostname of the Qdrant server
diff --git a/src/frontend/src/content/docs/integrations/databases/sql-server/sql-server-host.mdx b/src/frontend/src/content/docs/integrations/databases/sql-server/sql-server-host.mdx
index ee219bd0..ea146081 100644
--- a/src/frontend/src/content/docs/integrations/databases/sql-server/sql-server-host.mdx
+++ b/src/frontend/src/content/docs/integrations/databases/sql-server/sql-server-host.mdx
@@ -240,7 +240,7 @@ The preceding code uses the `2025-RTM-ubuntu-24.04-preview` tag for the SQL Serv
 
 ## Connect to database resources
 
-When the Aspire AppHost runs, the server's database resources can be accessed from external tools, such as [SQL Server Management Studio (SSMS)](https://learn.microsoft.com/sql/ssms/download-sql-server-management-studio-ssms) or [MSSQL for Visual Studio Code](https://learn.microsoft.com/sql/tools/visual-studio-code-extensions/mssql/mssql-extension-visual-studio-code). The connection string for the database resource is available in the dependent resources environment variables and is accessed using the [Aspire dashboard: Resource details](/dashboard/explore/#resource-details) pane. The environment variable is named `ConnectionStrings__{name}` where `{name}` is the name of the database resource, in this example it's `database`. Use the connection string to connect to the database resource from external tools. Imagine that you have a database named `todos` with a single `dbo.Todos` table.
+When the Aspire AppHost runs, the server's database resources can be accessed from external tools, such as [SQL Server Management Studio (SSMS)](https://learn.microsoft.com/sql/ssms/download-sql-server-management-studio-ssms) or [MSSQL for Visual Studio Code](https://learn.microsoft.com/sql/tools/visual-studio-code-extensions/mssql/mssql-extension-visual-studio-code). The connection string for the database resource is available in the dependent resources environment variables and is accessed using the [Aspire dashboard: Resource details](/dashboard/explore/#resource-details) pane. The environment variable is named `ConnectionStrings:{name}` where `{name}` is the name of the database resource, in this example it's `database`. Use the connection string to connect to the database resource from external tools. Imagine that you have a database named `todos` with a single `dbo.Todos` table.
 
 <Tabs>
     <TabItem label="SQL Server Management Studio" id="ssms">