Skip to content

[RDBMS] BREAKING CHANGE az postgres flexible-server create: Remove default value to --version and remove arguments --create-default-database and --database-name#32398

Merged
evelyn-ys merged 9 commits intoAzure:devfrom
nasc17:nasc/removeCreateDefaultDB115
Nov 10, 2025

Conversation

@nasc17
Copy link
Copy Markdown
Member

@nasc17 nasc17 commented Nov 7, 2025

Related command
az postgres flexible-server create

Description
PG default version Currently 'PG17'. Remove hardcoded value being set for version, instead utilize capabilities API.
Last breaking change we removed having a database be created as default for every server. Remove the argument '--create-default-database' and stick to having customers use the 'az postgres flexible-server database' group, if they want to create any databases.

Testing Guide
Manual

History Notes
[RDBMS] BREAKING CHANGE: az postgres flexible-server create: Remove default value to --version and remove arguments --create-default-database and --database-name

Copilot AI review requested due to automatic review settings November 7, 2025 07:33
@azure-client-tools-bot-prd
Copy link
Copy Markdown

azure-client-tools-bot-prd bot commented Nov 7, 2025

️✔️AzureCLI-FullTest
️✔️acr
️✔️latest
️✔️3.12
️✔️3.13
️✔️acs
️✔️latest
️✔️3.12
️✔️3.13
️✔️advisor
️✔️latest
️✔️3.12
️✔️3.13
️✔️ams
️✔️latest
️✔️3.12
️✔️3.13
️✔️apim
️✔️latest
️✔️3.12
️✔️3.13
️✔️appconfig
️✔️latest
️✔️3.12
️✔️3.13
️✔️appservice
️✔️latest
️✔️3.12
️✔️3.13
️✔️aro
️✔️latest
️✔️3.12
️✔️3.13
️✔️backup
️✔️latest
️✔️3.12
️✔️3.13
️✔️batch
️✔️latest
️✔️3.12
️✔️3.13
️✔️batchai
️✔️latest
️✔️3.12
️✔️3.13
️✔️billing
️✔️latest
️✔️3.12
️✔️3.13
️✔️botservice
️✔️latest
️✔️3.12
️✔️3.13
️✔️cdn
️✔️latest
️✔️3.12
️✔️3.13
️✔️cloud
️✔️latest
️✔️3.12
️✔️3.13
️✔️cognitiveservices
️✔️latest
️✔️3.12
️✔️3.13
️✔️compute_recommender
️✔️latest
️✔️3.12
️✔️3.13
️✔️computefleet
️✔️latest
️✔️3.12
️✔️3.13
️✔️config
️✔️latest
️✔️3.12
️✔️3.13
️✔️configure
️✔️latest
️✔️3.12
️✔️3.13
️✔️consumption
️✔️latest
️✔️3.12
️✔️3.13
️✔️container
️✔️latest
️✔️3.12
️✔️3.13
️✔️containerapp
️✔️latest
️✔️3.12
️✔️3.13
️✔️core
️✔️latest
️✔️3.12
️✔️3.13
️✔️cosmosdb
️✔️latest
️✔️3.12
️✔️3.13
️✔️databoxedge
️✔️latest
️✔️3.12
️✔️3.13
️✔️dls
️✔️latest
️✔️3.12
️✔️3.13
️✔️dms
️✔️latest
️✔️3.12
️✔️3.13
️✔️eventgrid
️✔️latest
️✔️3.12
️✔️3.13
️✔️eventhubs
️✔️latest
️✔️3.12
️✔️3.13
️✔️feedback
️✔️latest
️✔️3.12
️✔️3.13
️✔️find
️✔️latest
️✔️3.12
️✔️3.13
️✔️hdinsight
️✔️latest
️✔️3.12
️✔️3.13
️✔️identity
️✔️latest
️✔️3.12
️✔️3.13
️✔️iot
️✔️latest
️✔️3.12
️✔️3.13
️✔️keyvault
️✔️latest
️✔️3.12
️✔️3.13
️✔️lab
️✔️latest
️✔️3.12
️✔️3.13
️✔️managedservices
️✔️latest
️✔️3.12
️✔️3.13
️✔️maps
️✔️latest
️✔️3.12
️✔️3.13
️✔️marketplaceordering
️✔️latest
️✔️3.12
️✔️3.13
️✔️monitor
️✔️latest
️✔️3.12
️✔️3.13
️✔️mysql
️✔️latest
️✔️3.12
️✔️3.13
️✔️netappfiles
️✔️latest
️✔️3.12
️✔️3.13
️✔️network
️✔️latest
️✔️3.12
️✔️3.13
️✔️policyinsights
️✔️latest
️✔️3.12
️✔️3.13
️✔️privatedns
️✔️latest
️✔️3.12
️✔️3.13
️✔️profile
️✔️latest
️✔️3.12
️✔️3.13
️✔️rdbms
️✔️latest
️✔️3.12
️✔️3.13
️✔️redis
️✔️latest
️✔️3.12
️✔️3.13
️✔️relay
️✔️latest
️✔️3.12
️✔️3.13
️✔️resource
️✔️latest
️✔️3.12
️✔️3.13
️✔️role
️✔️latest
️✔️3.12
️✔️3.13
️✔️search
️✔️latest
️✔️3.12
️✔️3.13
️✔️security
️✔️latest
️✔️3.12
️✔️3.13
️✔️servicebus
️✔️latest
️✔️3.12
️✔️3.13
️✔️serviceconnector
️✔️latest
️✔️3.12
️✔️3.13
️✔️servicefabric
️✔️latest
️✔️3.12
️✔️3.13
️✔️signalr
️✔️latest
️✔️3.12
️✔️3.13
️✔️sql
️✔️latest
️✔️3.12
️✔️3.13
️✔️sqlvm
️✔️latest
️✔️3.12
️✔️3.13
️✔️storage
️✔️latest
️✔️3.12
️✔️3.13
️✔️synapse
️✔️latest
️✔️3.12
️✔️3.13
️✔️telemetry
️✔️latest
️✔️3.12
️✔️3.13
️✔️util
️✔️latest
️✔️3.12
️✔️3.13
️✔️vm
️✔️latest
️✔️3.12
️✔️3.13

@azure-client-tools-bot-prd
Copy link
Copy Markdown

Hi @nasc17,
Since the current milestone time is less than 7 days, this pr will be reviewed in the next milestone.

@azure-client-tools-bot-prd
Copy link
Copy Markdown

azure-client-tools-bot-prd bot commented Nov 7, 2025

❌AzureCLI-BreakingChangeTest
❌rdbms
rule cmd_name rule_message suggest_message
1007 - ParaRemove postgres flexible-server create cmd postgres flexible-server create removed parameter create_default_db please add back parameter create_default_db for cmd postgres flexible-server create
1007 - ParaRemove postgres flexible-server create cmd postgres flexible-server create removed parameter database_name please add back parameter database_name for cmd postgres flexible-server create
⚠️ 1004 - CmdPropRemove postgres flexible-server create cmd postgres flexible-server create removed property deprecate_info_target
⚠️ 1009 - ParaPropRemove postgres flexible-server create cmd postgres flexible-server create update parameter version: removed property default=17

Please submit your Breaking Change Pre-announcement ASAP if you haven't already. Please note:

  • Breaking changes can only be merged during the designated breaking change window
  • A pre-announcement must be released at least one month in advance

For more details on how to introduce breaking changes, refer to the documentation: azure-cli/doc/how_to_introduce_breaking_changes.md

@yonzhan
Copy link
Copy Markdown
Collaborator

yonzhan commented Nov 7, 2025

Thank you for your contribution! We will review the pull request and get back to you soon.

@github-actions
Copy link
Copy Markdown

github-actions bot commented Nov 7, 2025

The git hooks are available for azure-cli and azure-cli-extensions repos. They could help you run required checks before creating the PR.

Please sync the latest code with latest dev branch (for azure-cli) or main branch (for azure-cli-extensions).
After that please run the following commands to enable git hooks:

pip install azdev --upgrade
azdev setup -c <your azure-cli repo path> -r <your azure-cli-extensions repo path>

@microsoft-github-policy-service microsoft-github-policy-service bot added the Auto-Assign Auto assign by bot label Nov 7, 2025
@nasc17 nasc17 changed the title [RDBMS] BREAKING CHANGE az postgres flexible-server create: Remove default value to --version and remove argument --create-default-database [RDBMS] BREAKING CHANGE az postgres flexible-server create: Remove default value to --version and remove arguments --create-default-database and --database-name Nov 7, 2025
@nasc17
Copy link
Copy Markdown
Member Author

nasc17 commented Nov 7, 2025

@yonzhan @evelyn-ys @calvinhzy please trigger test checks

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR removes the deprecated database creation parameters from the PostgreSQL flexible server create command, making database creation a separate step. The changes align with Azure's deprecation of certain features and update test infrastructure to use current regional availability and SKU configurations.

  • Removes --database-name and --create-default-database parameters from server creation
  • Updates default version selection to dynamically use the latest supported version instead of hardcoded version 17
  • Migrates test locations from India regions to Canada regions and updates SKUs to newer versions

Reviewed Changes

Copilot reviewed 4 out of 30 changed files in this pull request and generated 1 comment.

File Description
test_rdbms_flexible_commands.py Updates test commands to remove database creation parameters, changes test locations to Canada regions, updates SKUs to newer versions, and removes validation checks for deprecated replica.capacity field
flexible_server_custom_postgres.py Removes database creation logic from server create function, adds dynamic version defaulting, and updates connection string generation to use default postgres database
_params.py Removes --database-name and --create-default-database parameter definitions and removes hardcoded version default
_breaking_change.py Deletes file containing breaking change registration for deprecated features

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@yonzhan
Copy link
Copy Markdown
Collaborator

yonzhan commented Nov 7, 2025

/azp run

@azure-pipelines
Copy link
Copy Markdown

Azure Pipelines successfully started running 3 pipeline(s).

Copy link
Copy Markdown
Member

@nachoalonsoportillo nachoalonsoportillo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM.

Once we upgrade Python SDK to the one version supporting 2025-08-01 API, we'll have to introduce support for users to override the default database name for Elastic Clusters. At that point, we might want to introduce a new parameter called --default-database-name with a default of postgres. And the parameter should only be present when --cluster-option is set to ElasticCluster.

@nasc17
Copy link
Copy Markdown
Member Author

nasc17 commented Nov 7, 2025

LGTM.

Once we upgrade Python SDK to the one version supporting 2025-08-01 API, we'll have to introduce support for users to override the default database name for Elastic Clusters. At that point, we might want to introduce a new parameter called --default-database-name with a default of postgres. And the parameter should only be present when --cluster-option is set to ElasticCluster.

Let's talk more about this for planning SDK update :-)

@evelyn-ys evelyn-ys merged commit cf053cd into Azure:dev Nov 10, 2025
58 of 59 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Auto-Assign Auto assign by bot

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants