aligned capitalization for Elastic Clusters #310

JaredMSFT · 2025-09-11T18:06:06Z

removed irrlelevant region question
clarified extensions info
added question regarding public preview to GA transition
added info for pgbouncer and re: port 7432
CMK not available from portal
confirmed Entra is working

removed irrlelevant region question clarified extensions info added question regarding public preview to GA transition added info for pgbouncer and re: port 7432 CMK not available from portal confirmed Entra is working

prmerger-automator · 2025-09-11T18:06:23Z

@JaredMSFT : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

learn-build-service-prod · 2025-09-11T18:09:30Z

Learn Build status updates of commit 7c8e8ec:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml	✅Succeeded

For more details, please refer to the build report.

prmerger-automator · 2025-09-11T18:09:34Z

PRMerger Results

Issue	Description
Yaml File(s)	This PR includes changes to .yml file(s) owned by another author.
File Change Percent	This PR contains file(s) with more than 30% file change.

mulander · 2025-09-11T18:08:18Z

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

 metadata:
-  title: Limitations of elastic clusters (preview)
-  description: "Learn about existing limitations of elastic clusters with Azure Database for PostgreSQL Flexible server during public preview."
+  title: Limitations of Elastic Clusters (preview)


elastic clusters are a feature hence lowercase

mulander · 2025-09-11T18:08:28Z

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

-  title: Limitations of elastic clusters (preview)
-  description: "Learn about existing limitations of elastic clusters with Azure Database for PostgreSQL Flexible server during public preview."
+  title: Limitations of Elastic Clusters (preview)
+  description: "Learn about existing limitations of Elastic Clusters with Azure Database for PostgreSQL Flexible server during public preview."


mulander · 2025-09-11T18:08:36Z

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

  ms.custom: references_regions

-title: "Frequently asked questions about elastic clusters (preview)"
+title: "Frequently asked questions about Elastic Clusters (preview)"


lowercase, plus all other instances in the doc that are not beginning of sentence.

mulander · 2025-09-11T18:11:22Z

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

-            - postgis_topology
-            - TimescaleDB
+      - question: Which extensions are available for Elastic Clusters?
+        answer: Elastic Clusters are compatible with many other powerful extensions, however, it's important to review the list of supported extensions along with any specific release notes.  You can find the list of supported extensions under the [Citus GitHub repo](https://github.com/citusdata/citus/blob/main/EXTENSION_COMPATIBILITY.md).


Do without marketing speak like "powerful extensions". I would say elastic cluster is compatible with the majority of PostgreSQL extensions. For a comprehensive list with support details please refer to the [extension compatibility matrix] in the Citus GitHub repository.

mulander · 2025-09-11T18:12:48Z

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

+        answer: Migrations to/from Elastic Clusters can be done with pg_dump, pg_restore, and pgcopydb. Any other tool working with standard PostgreSQL should work.
+
+      - question: Can I convert my existing Public Preview instance to General Availability (GA) Elastic Clusters?
+        answer: Public Preview clusters cannot be converted/promoted to GA clusters. Migration to GA Elastic Clusters can be made following the migration methods described above.


This is too soft and hiding the intent. We want people to realize they will need to re-create their clusters on GA. This is a scream test.

I will use the banner text.

mulander · 2025-09-11T18:13:26Z

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

-      - question: Can I use PgBouncer for connection pooling with elastic clusters?
-        answer: Yes, you can use PgBouncer with elastic clusters. Port 6432 should be used for schema and node management operations, while port 8432 is load-balanced to PgBouncer instances running across all nodes in the cluster.
+      - question: Can I use PgBouncer for connection pooling with Elastic Clusters?
+        answer: Public Preview does not currently support PgBouncer with Elastic Clusters. 


What happened here? We can use PgBouncer with elastic clusters. The removed text was correct.

mulander · 2025-09-11T18:15:09Z

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

+      - question: Can I use PgBouncer for connection pooling with Elastic Clusters?
+        answer: Public Preview does not currently support PgBouncer with Elastic Clusters. 
+
+      - question: Which ports are used for Elastic Clusters?


Where did this came from?

this is based on info from our docs (https://learn.microsoft.com/en-us/azure/postgresql/flexible-server/concepts-elastic-clusters#architecture)

I have removed for now, but I thought it would be a common question for users when seeking to understand how the elastic cluster ports operate.

mulander · 2025-09-11T18:15:31Z

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

+        answer: Public Preview does not currently support PgBouncer with Elastic Clusters. 
+
+      - question: Which ports are used for Elastic Clusters?
+        answer: Port 7432 is used to balance incoming client connections across all nodes in the Citus cluster, including both coordinator and worker nodes.


This doesn't answer the question. Lists one port out of at least 4 used by elastic clusters. Also describes how the load balancer works.

mulander · 2025-09-11T18:16:36Z

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

-      - question: Can I use replicas with elastic clusters?
+
+      - question: Can I use replicas with Elastic Clusters?
        answer: Currently, replicas aren't supported during the preview.


Replicas are supported now, at least single replicas but multi replicas are not, right?

mulander · 2025-09-11T18:17:38Z

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

-      - question: Can I use Microsoft Entra ID authentication with elastic clusters?
-        answer: Currently, Microsoft Entra ID authentication isn't supported during the preview.
+      - question: Can I use Microsoft Entra ID authentication with Elastic Clusters?
+        answer: Yes!  Microsoft Entra ID authentication is currently supported and follows the same principles found in Flexible Server.


We are flexible server. I would just say "Yes, refer to [name of documentation] for details" and just link to the flex docs.

v-dirichards · 2025-09-11T20:12:12Z

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

incorporated feedback comments.

learn-build-service-prod · 2025-09-13T00:37:06Z

Learn Build status updates of commit d382591:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml	✅Succeeded

For more details, please refer to the build report.

prmerger-automator · 2025-09-13T00:37:10Z

PRMerger Results

Issue	Description
Yaml File(s)	This PR includes changes to .yml file(s) owned by another author.
File Change Percent	This PR contains file(s) with more than 30% file change.

learn-build-service-prod · 2025-09-13T00:40:08Z

Learn Build status updates of commit 71c76f6:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml	✅Succeeded

For more details, please refer to the build report.

prmerger-automator · 2025-09-13T00:40:12Z

PRMerger Results

Issue	Description
Yaml File(s)	This PR includes changes to .yml file(s) owned by another author.
File Change Percent	This PR contains file(s) with more than 30% file change.

mulander · 2025-09-17T13:54:41Z

#sign-off

ttorble · 2025-09-17T14:30:28Z

@JaredMSFT and @mulander

Microsoft email addresses aren't allowed in Learn content. Can you remove or rewrite the last sentence at line 68 to comply with this guidance? (Unauthorized content, item 8).

#hold-off
@MicrosoftDocs/public-repo-pr-review-team

mulander · 2025-09-18T06:42:38Z

@JaredMSFT and @mulander

Microsoft email addresses aren't allowed in Learn content. Can you remove or rewrite the last sentence at line 68 to comply with this guidance? (Unauthorized content, item 8).

#hold-off @MicrosoftDocs/public-repo-pr-review-team

@ttorble the linked guide is not found (404). Can you point us at the correct resource?

learn-build-service-prod · 2025-09-18T13:00:20Z

Learn Build status updates of commit ccd9798:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml	✅Succeeded

For more details, please refer to the build report.

denzilribeiro

Left few comments.

denzilribeiro · 2025-09-18T16:21:49Z

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

-          
-      - question: Elastic clusters aren't available in the region I need, what can I do?
-        answer: |
-          We're enabling other regions shortly, if you're interested in specific regions fill out [this form](https://aka.ms/preview-pg-citus).


We should not direct them to a form, there are concerns around PII... Rather open a support case with Capacity management type thing, Aka this si the "same" as Flex being available in any region no different

This PR removes that section completely, but point taken and noted.

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

learn-build-service-prod · 2025-09-24T17:53:49Z

Learn Build status updates of commit b1e078f:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml	✅Succeeded

For more details, please refer to the build report.

prmerger-automator · 2025-09-24T17:53:53Z

PRMerger Results

Issue	Description
Yaml File(s)	This PR includes changes to .yml file(s) owned by another author.
File Change Percent	This PR contains file(s) with more than 30% file change.

v-dirichards · 2025-09-24T20:26:14Z

@JaredMSFT and @mulander
Microsoft email addresses aren't allowed in Learn content. Can you remove or rewrite the last sentence at line 68 to comply with this guidance? (Unauthorized content, item 8).
#hold-off @MicrosoftDocs/public-repo-pr-review-team

@ttorble the linked guide is not found (404). Can you point us at the correct resource?

Make sure you're signed in and the link should work.

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

mulander · 2025-09-26T18:44:53Z

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

+        answer: Migrations to/from elastic clusters can be done with pg_dump, pg_restore, and pgcopydb. Any other tool working with standard PostgreSQL should work.
+
+      - question: Can I convert my existing Public Preview instance to General Availability (GA) elastic clusters?
+        answer: If you have created any elastic clusters during the Public Preview phase, you are required to re-create them once the feature becomes Generally Available.  If this raises concerns, or if you need help determining whether your server meets the necessary requirements, please contact us by going to the Azure portal, selecting your Azure Postgres resource, and following the instructions in the banner.


Not sure if it's not better to ask them to raise a support request? The banner doesn't show in all cases.

I'm concerned raising a support incident will cause more complexity and hassle for the customer and for the customer support org. At least the banner instructs them to contact us directly. Can we determine why the banner does not show in all relevant cases?

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

learn-build-service-prod · 2025-09-26T21:12:43Z

Learn Build status updates of commit 537fc5b:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml	✅Succeeded

For more details, please refer to the build report.

prmerger-automator · 2025-09-26T21:12:48Z

PRMerger Results

Issue	Description
Yaml File(s)	This PR includes changes to .yml file(s) owned by another author.
File Change Percent	This PR contains file(s) with more than 30% file change.

mulander · 2025-09-26T21:35:15Z

#sign-off

learn-build-service-prod · 2025-09-27T02:15:43Z

Learn Build status updates of commit 3c23e37:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml	✅Succeeded

For more details, please refer to the build report.

prmerger-automator · 2025-09-27T02:15:47Z

PRMerger Results

Issue	Description
Yaml File(s)	This PR includes changes to .yml file(s) owned by another author.
File Change Percent	This PR contains file(s) with more than 30% file change.

ttorble · 2025-09-29T14:08:37Z

@JaredMSFT and @mulander

Updates to this article contain future promises, which are not allowed in Learn content.

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

Lines 35, 44, 84: Reword this content to only describe what is possible with the released product to avoid confusion or mistrust if future features are delayed or canceled.

Note that contributor guidance has moved to https://learn.microsoft.com/help/
To access the guides, you must log in with your Learn profile. If you don't have a Learn profile, follow the instructions at Manage your Microsoft Learn profile settings | Microsoft Learn to create one.

Thanks
#hold-off
cc @MicrosoftDocs/public-repo-pr-review-team

prmerger-automator · 2025-09-29T14:08:41Z

You typed hold-off, but the PR wasn't signed off, so nothing was changed.

Copilot

Pull Request Overview

This PR updates the FAQ documentation for Azure Database for PostgreSQL Elastic Clusters to reflect current capabilities and prepare for the transition from public preview to general availability (GA). The changes include removing outdated questions, clarifying feature availability, and providing more detailed information about supported functionality.

Key changes:

Removed irrelevant region availability question and clarified extension compatibility
Added information about the public preview to GA transition requirements
Updated networking, authentication, and performance capabilities to reflect current state

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml

learn-build-service-prod · 2025-10-06T18:27:53Z

Learn Build status updates of commit 533fcf7:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml	✅Succeeded

For more details, please refer to the build report.

prmerger-automator · 2025-10-06T18:27:57Z

PRMerger Results

Issue	Description
Yaml File(s)	This PR includes changes to .yml file(s) owned by another author.
File Change Percent	This PR contains file(s) with more than 30% file change.

learn-build-service-prod · 2025-10-06T18:48:59Z

Learn Build status updates of commit 12c2430:

✅ Validation status: passed

File	Status	Preview URL	Details
articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml	✅Succeeded

For more details, please refer to the build report.

prmerger-automator · 2025-10-06T18:49:03Z

PRMerger Results

Issue	Description
Yaml File(s)	This PR includes changes to .yml file(s) owned by another author.
File Change Percent	This PR contains file(s) with more than 30% file change.

v-dirichards · 2025-10-16T21:40:06Z

@mulander - Would you add a comment to indicate what action to take on this PR? Thanks!

aligned capitalization for Elastic Clusters

7c8e8ec

removed irrlelevant region question clarified extensions info added question regarding public preview to GA transition added info for pgbouncer and re: port 7432 CMK not available from portal confirmed Entra is working

prmerger-automator bot added the do-not-merge label Sep 11, 2025

prmerger-automator bot assigned mulander Sep 11, 2025

prmerger-automator bot requested review from markingmyname and mulander September 11, 2025 18:06

prmerger-automator bot added azure-database-postgresql/svc Change sent to author labels Sep 11, 2025

prmerger-automator bot added the needs-human-review label Sep 11, 2025

mulander suggested changes Sep 11, 2025

View reviewed changes

prmerger-automator bot added the aq-pr-triaged C+L Pull Request Review Team label label Sep 11, 2025

JaredMSFT added 2 commits September 12, 2025 20:34

corrected case.

d382591

incorporated feedback comments.

missed case fix

71c76f6

prmerger-automator bot added ready-to-merge and removed do-not-merge labels Sep 17, 2025

prmerger-automator bot added do-not-merge and removed ready-to-merge labels Sep 17, 2025

removed whitespace

afdcb23

replaced email address with alternate contact instructions

ccd9798

denzilribeiro suggested changes Sep 18, 2025

View reviewed changes

incorporating latest round of content updates.

b1e078f

mulander suggested changes Sep 26, 2025

View reviewed changes

updated content to align w/ comments

537fc5b

prmerger-automator bot added ready-to-merge and removed do-not-merge labels Sep 26, 2025

Merge remote-tracking branch 'upstream/main' into ec-faq-updates

3c23e37

prmerger-automator bot added do-not-merge and removed ready-to-merge labels Sep 27, 2025

v-dirichards requested a review from Copilot September 29, 2025 20:15

Copilot AI reviewed Sep 29, 2025

View reviewed changes

articles/postgresql/flexible-server/concepts-elastic-clusters-limitations.yml Outdated Show resolved Hide resolved

Merge branch 'main' into ec-faq-updates

533fcf7

removing any references to future GA releases

12c2430

JaredMSFT closed this Oct 20, 2025

JaredMSFT deleted the ec-faq-updates branch October 20, 2025 15:18

aligned capitalization for Elastic Clusters #310

aligned capitalization for Elastic Clusters #310

Uh oh!

Conversation

JaredMSFT commented Sep 11, 2025

Uh oh!

prmerger-automator bot commented Sep 11, 2025

Uh oh!

learn-build-service-prod bot commented Sep 11, 2025

✅ Validation status: passed

Uh oh!

prmerger-automator bot commented Sep 11, 2025

PRMerger Results

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

v-dirichards commented Sep 11, 2025

Uh oh!

learn-build-service-prod bot commented Sep 13, 2025

✅ Validation status: passed

Uh oh!

prmerger-automator bot commented Sep 13, 2025

PRMerger Results

Uh oh!

learn-build-service-prod bot commented Sep 13, 2025

✅ Validation status: passed

Uh oh!

prmerger-automator bot commented Sep 13, 2025

PRMerger Results

Uh oh!

mulander commented Sep 17, 2025

Uh oh!

ttorble commented Sep 17, 2025

Uh oh!

mulander commented Sep 18, 2025

Uh oh!

learn-build-service-prod bot commented Sep 18, 2025

✅ Validation status: passed

Uh oh!

denzilribeiro left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

learn-build-service-prod bot commented Sep 24, 2025

✅ Validation status: passed

Uh oh!