Skip to content

Commit 514b97a

Browse files
authored
Merge pull request #1927 from MicrosoftDocs/main
Publish to live, Monday 4 AM PST, 4/14
2 parents 928d0f3 + 1c40510 commit 514b97a

42 files changed

Lines changed: 481 additions & 105 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

articles/postgresql/extensions/how-to-load-libraries.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -46,13 +46,19 @@ Using the [Azure portal](https://portal.azure.com):
4646
You can set `shared_preload_libraries` using the CLI [parameter set](/cli/azure/postgres/flexible-server/parameter#az-postgres-flexible-server-parameter-set) command.
4747

4848
```azurecli-interactive
49-
az postgres flexible-server parameter set --resource-group <resource_group> --server-name <server> --name shared_preload_libraries --value <extension_name>,<extension_name>
49+
az postgres flexible-server parameter set \
50+
--resource-group <resource_group> \
51+
--server-name <server> \
52+
--name shared_preload_libraries \
53+
--value <extension_name>,<extension_name>
5054
```
5155

5256
And can restart the server using the CLI [parameter set](/cli/azure/postgres/flexible-server#az-postgres-flexible-server-restart) command.
5357

5458
```azurecli-interactive
55-
az postgres flexible-server restart --resource-group <resource_group> --name <server>
59+
az postgres flexible-server restart \
60+
--resource-group <resource_group> \
61+
--name <server>
5662
```
5763

5864
---

articles/postgresql/flexible-server/how-to-auto-grow-storage.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,10 @@ Using the [Azure portal](https://portal.azure.com/):
5555
You can enable storage autogrow in an existing server via the [az postgres flexible-server update](/cli/azure/postgres/flexible-server#az-postgres-flexible-server-update) command.
5656

5757
```azurecli-interactive
58-
az postgres flexible-server update --resource-group <resource_group> --name <server> --storage-auto-grow enabled
58+
az postgres flexible-server update \
59+
--resource-group <resource_group> \
60+
--name <server> \
61+
--storage-auto-grow enabled
5962
```
6063
---
6164

@@ -88,7 +91,10 @@ Using the [Azure portal](https://portal.azure.com/):
8891
You can enable storage autogrow in an existing server via the [az postgres flexible-server update](/cli/azure/postgres/flexible-server#az-postgres-flexible-server-update) command.
8992

9093
```azurecli-interactive
91-
az postgres flexible-server update --resource-group <resource_group> --name <server> --storage-auto-grow disabled
94+
az postgres flexible-server update \
95+
--resource-group <resource_group> \
96+
--name <server> \
97+
--storage-auto-grow disabled
9298
```
9399

94100
---
@@ -112,7 +118,10 @@ Using the [Azure portal](https://portal.azure.com/):
112118
You can enable storage autogrow while provisioning a new server via the [az postgres flexible-server create](/cli/azure/postgres/flexible-server#az-postgres-flexible-server-create) command.
113119

114120
```azurecli-interactive
115-
az postgres flexible-server create --resource-group <resource_group> --name <server> --storage-auto-grow disabled ...
121+
az postgres flexible-server create \
122+
--resource-group <resource_group> \
123+
--name <server> \
124+
--storage-auto-grow disabled ...
116125
```
117126

118127
> [!NOTE]

articles/postgresql/flexible-server/how-to-configure-high-availability.md

Lines changed: 49 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -81,19 +81,29 @@ You can enable high availability in an existing server via the [az postgres flex
8181
To enable high availability so that standby server is deployed in the same zone as the primary server, use this command:
8282

8383
```azurecli-interactive
84-
az postgres flexible-server update --resource-group <resource_group> --name <server> --high-availability SameZone
84+
az postgres flexible-server update \
85+
--resource-group <resource_group> \
86+
--name <server> \
87+
--high-availability SameZone
8588
```
8689

8790
To enable high availability with standby server deployed in a different zone than the primary server, and if you want the zone to be automatically selected, use this command:
8891

8992
```azurecli-interactive
90-
az postgres flexible-server update --resource-group <resource_group> --name <server> --high-availability ZoneRedundant
93+
az postgres flexible-server update \
94+
--resource-group <resource_group> \
95+
--name <server> \
96+
--high-availability ZoneRedundant
9197
```
9298

9399
Also, optionally, you can select the availability zone in which the standby server should be deployed. To do so, use this command:
94100

95101
```azurecli-interactive
96-
az postgres flexible-server update --resource-group <resource_group> --name <server> --high-availability ZoneRedundant --standby-zone <standby_zone>
102+
az postgres flexible-server update \
103+
--resource-group <resource_group> \
104+
--name <server> \
105+
--high-availability ZoneRedundant \
106+
--standby-zone <standby_zone>
97107
```
98108

99109
If you're enabling high availability with zone redundancy, and the zone specified for standby matches the zone of the primary, you get this error:
@@ -171,7 +181,10 @@ You can disable high availability in an existing server via the [az postgres fle
171181
To disable high availability, use this command:
172182

173183
```azurecli-interactive
174-
az postgres flexible-server update --resource-group <resource_group> --name <server> --high-availability Disabled
184+
az postgres flexible-server update \
185+
--resource-group <resource_group> \
186+
--name <server> \
187+
--high-availability Disabled
175188
```
176189

177190
---
@@ -211,13 +224,20 @@ You can enable high availability while provisioning a new server via the [az pos
211224
To deploy the primary server with a standby server in the same zone, and let the service choose for you the zone, use this command:
212225

213226
```azurecli-interactive
214-
az postgres flexible-server create --resource-group <resource_group> --name <server> --high-availability SameZone ...
227+
az postgres flexible-server create \
228+
--resource-group <resource_group> \
229+
--name <server> \
230+
--high-availability SameZone ...
215231
```
216232

217233
To deploy the primary server with a standby server in the same zone, and explicitly choose the zone, use this command:
218234

219235
```azurecli-interactive
220-
az postgres flexible-server create --resource-group <resource_group> --name <server> --high-availability SameZone --zone <zone> ...
236+
az postgres flexible-server create \
237+
--resource-group <resource_group> \
238+
--name <server> \
239+
--high-availability SameZone \
240+
--zone <zone> ...
221241
```
222242

223243
If the availability zone specified isn't supported in the selected region, you get this error:
@@ -230,19 +250,31 @@ Message: Specified availability zone is not supported in this region. Please cho
230250
To deploy the primary server with a standby server in a different zone, and let the service choose for you both zones, use this command:
231251

232252
```azurecli-interactive
233-
az postgres flexible-server create --resource-group <resource_group> --name <server> --high-availability ZoneRedundant ...
253+
az postgres flexible-server create \
254+
--resource-group <resource_group> \
255+
--name <server> \
256+
--high-availability ZoneRedundant ...
234257
```
235258

236259
To deploy the primary server with a standby server in a different zone, explicitly specify the zone for the primary but let the service choose the zone for the standby, use this command:
237260

238261
```azurecli-interactive
239-
az postgres flexible-server create --resource-group <resource_group> --name <server> --high-availability ZoneRedundant --zone <zone> ...
262+
az postgres flexible-server create \
263+
--resource-group <resource_group> \
264+
--name <server> \
265+
--high-availability ZoneRedundant \
266+
--zone <zone> ...
240267
```
241268

242269
To deploy the primary server with a standby server in a different zone, and explicitly specify the zone for the primary and the standby, use this command:
243270

244271
```azurecli-interactive
245-
az postgres flexible-server create --resource-group <resource_group> --name <server> --high-availability ZoneRedundant --zone <zone> --standby-zone <standby_zone>...
272+
az postgres flexible-server create \
273+
--resource-group <resource_group> \
274+
--name <server> \
275+
--high-availability ZoneRedundant \
276+
--zone <zone> \
277+
--standby-zone <standby_zone>...
246278
```
247279

248280
If you choose zone redundant high availability, and the same value is specified for the zones of the primary and standby servers, you get this error:
@@ -305,7 +337,10 @@ You can enable high availability while provisioning a new server via the [az pos
305337
To initiate a forced failover, use this command:
306338

307339
```azurecli-interactive
308-
az postgres flexible-server restart --resource-group <resource_group> --name <server> --failover Forced
340+
az postgres flexible-server restart \
341+
--resource-group <resource_group> \
342+
--name <server> \
343+
--failover Forced
309344
```
310345

311346
If you try to force a failover of an Azure Database for PostgreSQL flexible server that doesn't have high availability enabled, you get this error:
@@ -371,7 +406,10 @@ You can enable high availability while provisioning a new server via the [az pos
371406
To initiate a forced failover, use this command:
372407

373408
```azurecli-interactive
374-
az postgres flexible-server restart --resource-group <resource_group> --name <server> --failover Planned
409+
az postgres flexible-server restart \
410+
--resource-group <resource_group> \
411+
--name <server> \
412+
--failover Planned
375413
```
376414

377415
If you try to force a failover of an Azure Database for PostgreSQL flexible server that doesn't have high availability enabled, you get this error:

articles/postgresql/flexible-server/how-to-configure-index-tuning.md

Lines changed: 23 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,10 @@ You can enable index tuning in an existing server via the [az postgres flexible-
5555
To enable index tuning, use this command:
5656

5757
```azurecli-interactive
58-
az postgres flexible-server index-tuning update --resource-group <resource_group> --server-name <server> --enabled true
58+
az postgres flexible-server index-tuning update \
59+
--resource-group <resource_group> \
60+
--server-name <server> \
61+
--enabled true
5962
```
6063

6164
If the previous command executes successfully, you should see the following output:
@@ -99,7 +102,10 @@ You can disable index tuning in an existing server via the [az postgres flexible
99102
To disable index tuning, use this command:
100103

101104
```azurecli-interactive
102-
az postgres flexible-server index-tuning update --resource-group <resource_group> --server-name <server> --enabled false
105+
az postgres flexible-server index-tuning update \
106+
--resource-group <resource_group> \
107+
--server-name <server> \
108+
--enabled false
103109
```
104110

105111
If the previous command executes successfully, you should see the following output:
@@ -143,7 +149,9 @@ You can show the state of index tuning in an existing server via the [az postgre
143149
To disable index tuning, use this command:
144150

145151
```azurecli-interactive
146-
az postgres flexible-server index-tuning show --resource-group <resource_group> --server-name <server>
152+
az postgres flexible-server index-tuning show \
153+
--resource-group <resource_group> \
154+
--server-name <server>
147155
```
148156

149157
If index tuning is enabled, you should see the following output:
@@ -183,7 +191,10 @@ You can show the value of a single index tuning setting in an existing server vi
183191
For example, to show the value of the index tuning setting called `analyze_interval`, use this command:
184192

185193
```azurecli-interactive
186-
az postgres flexible-server index-tuning show-settings --resource-group <resource_group> --server-name <server> --name analyze_interval
194+
az postgres flexible-server index-tuning show-settings \
195+
--resource-group <resource_group> \
196+
--server-name <server> \
197+
--name analyze_interval
187198
```
188199

189200
The command returns all information about the server parameter corresponding to that setting of index tuning, and the output is similar to the following:
@@ -214,7 +225,9 @@ Also, you can show the list of all index tuning settings in an existing server v
214225
To list all index tuning settings, use this command:
215226

216227
```azurecli-interactive
217-
az postgres flexible-server index-tuning list-settings --resource-group <resource_group> --server-name <server>
228+
az postgres flexible-server index-tuning list-settings \
229+
--resource-group <resource_group> \
230+
--server-name <server>
218231
```
219232

220233
The command returns all server parameters that control the different settings of index tuning, and the output is similar to the following:
@@ -474,7 +487,11 @@ You can modify the value of a single index tuning setting in an existing server
474487
For example, to set the value of the index tuning setting called `analyze_interval` to `1440`, use this command:
475488

476489
```azurecli-interactive
477-
az postgres flexible-server index-tuning set-settings --resource-group <resource_group> --server-name <server> --name analyze_interval --value 1440
490+
az postgres flexible-server index-tuning set-settings \
491+
--resource-group <resource_group> \
492+
--server-name <server> \
493+
--name analyze_interval \
494+
--value 1440
478495
```
479496

480497
The command returns all information about the server parameter corresponding to that setting of index tuning, and the output is similar to the following:

articles/postgresql/flexible-server/how-to-configure-managed-identities-system-assigned.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -143,7 +143,11 @@ Using the [Azure portal](https://portal.azure.com/):
143143
# Show the system assigned managed identity
144144
resourceGroup=<resource-group>
145145
server=<server>
146-
az postgres flexible-server identity list --resource-group $resourceGroup --server-name $server --query "{principalId:principalId, tenantId:tenantId}" --output table
146+
az postgres flexible-server identity list \
147+
--resource-group $resourceGroup \
148+
--server-name $server \
149+
--query "{principalId:principalId, tenantId:tenantId}" \
150+
--output table
147151
```
148152

149153
---

articles/postgresql/flexible-server/how-to-configure-managed-identities-user-assigned.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,10 @@ You can associate a user assigned identity to an Azure Database for PostgreSQL f
3939
resourceGroup=<resource-group>
4040
server=<server>
4141
identity=<identity>
42-
az postgres flexible-server identity assign --resource-group $resourceGroup --server-name $server --identity $identity
42+
az postgres flexible-server identity assign \
43+
--resource-group $resourceGroup \
44+
--server-name $server \
45+
--identity $identity
4346
```
4447

4548
---
@@ -64,7 +67,10 @@ You can dissociate a user assigned identity from an Azure Database for PostgreSQ
6467
resourceGroup=<resource-group>
6568
server=<server>
6669
identity=<identity>
67-
az postgres flexible-server identity remove --resource-group $resourceGroup --server-name $server --identity $identity
70+
az postgres flexible-server identity remove \
71+
--resource-group $resourceGroup \
72+
--server-name $server \
73+
--identity $identity
6874
```
6975

7076
If you try to remove a user assigned managed identity which is used to access a data encryption key, you get the following error:
@@ -100,7 +106,10 @@ Using the [Azure portal](https://portal.azure.com/):
100106
# List all associated user assigned managed identities
101107
resourceGroup=<resource-group>
102108
server=<server>
103-
az postgres flexible-server identity list --resource-group $resourceGroup --server-name $server --query "userAssignedIdentities"
109+
az postgres flexible-server identity list \
110+
--resource-group $resourceGroup \
111+
--server-name $server \
112+
--query "userAssignedIdentities"
104113
```
105114

106115
---

articles/postgresql/flexible-server/how-to-configure-scheduled-maintenance.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -60,19 +60,28 @@ You can configure the maintenance schedule settings via the [az postgres flexibl
6060
To configure system managed schedule, use this command:
6161

6262
```azurecli-interactive
63-
az postgres flexible-server update --resource-group <resource_group> --name <server> --maintenance-window Disabled
63+
az postgres flexible-server update \
64+
--resource-group <resource_group> \
65+
--name <server> \
66+
--maintenance-window Disabled
6467
```
6568

6669
To configure custom schedule, for a one hour window starting on Wednesdays at 2:29PM (UTC), use this command:
6770

6871
```azurecli-interactive
69-
az postgres flexible-server update --resource-group <resource_group> --name <server> --maintenance-window Wed:14:29
72+
az postgres flexible-server update \
73+
--resource-group <resource_group> \
74+
--name <server> \
75+
--maintenance-window Wed:14:29
7076
```
7177

7278
To configure custom schedule, for a one hour window starting on Saturdays at midnight (UTC), use this command:
7379

7480
```azurecli-interactive
75-
az postgres flexible-server update --resource-group <resource_group> --name <server> --maintenance-window Wed
81+
az postgres flexible-server update \
82+
--resource-group <resource_group> \
83+
--name <server> \
84+
--maintenance-window Wed
7685
```
7786

7887
---

0 commit comments

Comments
 (0)