Merge pull request #188556 from WilliamDAssafMSFT/20220214-azure-sql-maint-window-ga

20220214 GA for maint window

Author: tamarakhader

articles/azure-sql/database/advance-notifications.md

@@ -9,20 +9,20 @@ ms.devlang:
 ms.topic: how-to
 author: scott-kim-sql
 ms.author: scottkim
-ms.reviewer: kendralittle, mathoma, wiassaf
-ms.date: 09/14/2021
+ms.reviewer: kendralittle, mathoma, wiassaf, urosmil
+ms.date: 03/07/2022
 ---
 # Advance notifications for planned maintenance events (Preview)
-[!INCLUDE[appliesto-sqldb](../includes/appliesto-sqldb.md)]
+[!INCLUDE[appliesto-sqldb-sqlmi](../includes/appliesto-sqldb-sqlmi.md)]
 
-Advance notifications (Preview) is available for databases configured to use a non-default [Maintenance Window (Preview)](maintenance-window.md). Advance notifications enable customers to configure notifications to be sent up to 24 hours in advance of any planned event.
+Advance notifications (Preview) are available for databases configured to use a non-default [maintenance window](maintenance-window.md). Advance notifications enable customers to configure notifications to be sent up to 24 hours in advance of any planned event. 
 
 Notifications can be configured so you can get texts, emails, Azure push notifications, and voicemails when planned maintenance is due to begin in the next 24 hours. Additional notifications are sent when maintenance begins and when maintenance ends.
 
 Advance notifications cannot be configured for the **System default** maintenance window option. Choose a maintenance window other than the **System default** to configure and enable Advance notifications.
 
 > [!NOTE]
-> While the ability to choose a maintenance window is available for Azure SQL managed instances, advance notifications are not currently available for Azure SQL managed instances. 
+> While [maintenance windows](maintenance-window.md) are generally available, advance notifications for maintenance windows are in public preview for Azure SQL Database and Azure SQL Managed Instance.
 
 ## Create an advance notification
 
@@ -46,8 +46,6 @@ Complete the following steps to enable a notification.
 
     :::image type="content" source="media/advance-notifications/notifications.png" alt-text="configure notifications":::
 
-
-
    1. Complete the *Add or edit notification* form that opens and select **OK**: 
 
    2. Actions and Tags are optional. Here you can configure additional actions to be triggered or use tags to categorize and organize your Azure resources. 
@@ -80,6 +78,34 @@ The following table shows additional notifications that may be sent while mainte
 |**Blocked**|There was a problem during maintenance for database *xyz*. We'll notify you when we resume.| 
 |**Resumed**|The problem has been resolved and maintenance will continue at the next maintenance window.|
 
+## Permissions
+
+While Advance Notifications can be sent to any email address, Azure subscription RBAC (role-based access control) policy determines who can access the links in the email. Querying resource graph is covered by [Azure RBAC](../../role-based-access-control/overview.md) access management.  To enable read access, each recipient should have resource group level read access. For more information, see [Steps to assign an Azure role](../../role-based-access-control/role-assignments-steps.md).
+
+## Retrieve the list of impacted resources
+
+[Azure Resource Graph](../../governance/resource-graph/overview.md) is an Azure service designed to extend Azure Resource Management. The Azure Resource Graph Explorer provides efficient and performant resource exploration with the ability to query at scale across a given set of subscriptions so that you can effectively govern your environment. 
+
+You can use the Azure Resource Graph Explorer to query for maintenance events. For an introduction on how to run these queries, see [Quickstart: Run your first Resource Graph query using Azure Resource Graph Explorer](../../governance/resource-graph/first-query-portal.md).
+
+When the advanced notification for planned maintenance is received, you will get a link that opens Azure Resource Graph and executes the query for the exact event, similar to the following. Note that the `notificationId` value is unique per maintenance event.  
+
+```kusto
+resources
+| project resource = tolower(id)
+| join kind=inner (
+    maintenanceresources
+    | where type == "microsoft.maintenance/updates"
+    | extend p = parse_json(properties)
+    | mvexpand d = p.value
+    | where d has 'notificationId' and d.notificationId == 'LNPN-R9Z'
+    | project resource = tolower(name), status = d.status
+) on resource
+|project resource, status
+```
+
+For the full reference of the sample queries and how to use them across tools like PowerShell or Azure CLI, visit [Azure Resource Graph sample queries for Azure Service Health](../../service-health/resource-graph-samples.md).
+
 
 ## Next steps
 

articles/azure-sql/database/doc-changes-updates-release-notes-whats-new.md

@@ -10,7 +10,7 @@ ms.subservice: service-overview
 ms.custom: sqldbrb=2, references_regions, ignite-fall-2021
 ms.devlang: 
 ms.topic: conceptual
-ms.date: 03/02/2022
+ms.date: 03/07/2022
 ---
 # What's new in Azure SQL Database?
 [!INCLUDE[appliesto-sqldb](../includes/appliesto-sqldb.md)]
@@ -33,7 +33,7 @@ The following table lists the features of Azure SQL Database that are currently
 | [Elastic queries](elastic-query-overview.md) | The elastic queries feature allows for cross-database queries in Azure SQL Database. |
 | [Elastic transactions](elastic-transactions-overview.md) | Elastic transactions allow you to execute transactions distributed among cloud databases in Azure SQL Database. |
 | [Ledger](ledger-overview.md) | The Azure SQL Database ledger feature allows you to cryptographically attest to other parties, such as auditors or other business parties, that your data hasn't been tampered with. | 
-| [Maintenance window](maintenance-window.md)| The maintenance window feature allows you to configure maintenance schedule for your Azure SQL Database. |
+| [Maintenance window advance notifications](../database/advance-notifications.md)| Advance notifications are available for databases configured to use a non-default [maintenance window](maintenance-window.md). Advance notifications for maintenance windows are in public preview for Azure SQL Database. |
 | [Query editor in the Azure portal](connect-query-portal.md) | The query editor in the portal allows you to run queries against your Azure SQL Database directly from the [Azure portal](https://portal.azure.com).|
 | [Query Store hints](/sql/relational-databases/performance/query-store-hints?view=azuresqldb-current&preserve-view=true) | Use query hints to optimize your query execution via the OPTION clause. |
 | [SQL Analytics](../../azure-monitor/insights/azure-sql.md)|Azure SQL Analytics is an advanced cloud monitoring solution for monitoring performance of all of your Azure SQL databases at scale and across multiple subscriptions in a single view. Azure SQL Analytics collects and visualizes key performance metrics with built-in intelligence for performance troubleshooting.|
@@ -47,6 +47,7 @@ The following table lists the features of Azure SQL Database that have transitio
 
 | Feature | GA Month | Details |
 | ---| --- |--- |
+| [Maintenance window](../database/maintenance-window.md)| March 2022 | The maintenance window feature allows you to configure maintenance schedule for your Azure SQL Database. [Maintenance window advance notifications](../database/advance-notifications.md), however, are in preview.|
 | [Storage redundancy for Hyperscale databases](automated-backups-overview.md#configure-backup-storage-redundancy) | March 2022 |  When creating a Hyperscale database, you can choose your preferred storage type: read-access geo-redundant storage (RA-GRS), zone-redundant storage (ZRS), or locally redundant storage (LRS) Azure standard storage. The selected storage redundancy option will be used for the lifetime of the database for both data storage redundancy and backup storage redundancy. |
 | [Azure Active Directory-only authentication](authentication-azure-ad-only-authentication.md) | November 2021 | It's possible to configure your Azure SQL Database to allow authentication only from Azure Active Directory. | 
 | [Azure AD service principal](authentication-aad-service-principal.md) |  September 2021 | Azure Active Directory (Azure AD) supports user creation in Azure SQL Database on behalf of Azure AD applications (service principals).| 
@@ -62,6 +63,7 @@ Learn about significant changes to the Azure SQL Database documentation.
 
 | Changes | Details |
 | --- | --- |
+| **GA for maintenance window** | The [maintenance window](maintenance-window.md) feature allows you to configure a maintenance schedule for your Azure SQL Database and receive advance notifications of maintenance windows. [Maintenance window advance notifications](../database/advance-notifications.md) are in public preview for databases configured to use a non-default [maintenance window](maintenance-window.md).| 
 | **Hyperscale zone redundant configuration preview** | It's now possible to create new Hyperscale databases with zone redundancy to make your databases resilient to a much larger set of failures. This feature is currently in preview for the Hyperscale service tier. To learn more, see [Hyperscale zone redundancy](high-availability-sla.md#hyperscale-service-tier-zone-redundant-availability-preview). | 
 | **Hyperscale storage redundancy GA** | Choosing your storage redundancy for your databases in the Hyperscale service tier is now generally available. See [Configure backup storage redundancy](automated-backups-overview.md#configure-backup-storage-redundancy) to learn more. 
 ||| 
@@ -75,7 +77,6 @@ Learn about significant changes to the Azure SQL Database documentation.
 
 ### 2021 
 
-
 | Changes | Details |
 | --- | --- |
 | **Azure AD-only authentication** | Restricting authentication to your Azure SQL Database only to Azure Active Directory users is now generally available. To learn more, see [Azure AD-only authentication](../database/authentication-azure-ad-only-authentication.md). | 
@@ -90,7 +91,6 @@ Learn about significant changes to the Azure SQL Database documentation.
 |||
 
 
-
 ## Contribute to content
 
 To contribute to the Azure SQL documentation, see the [Docs contributor guide](/contribute/).

articles/azure-sql/database/maintenance-window-configure.md

@@ -1,5 +1,5 @@
 ---
-title: Configure maintenance window (Preview)
+title: Configure maintenance window
 description: Learn how to set the time when planned maintenance should be performed on your Azure SQL databases, elastic pools, and managed instance databases.
 services: sql-database
 ms.service: sql-db-mi
@@ -8,13 +8,13 @@ ms.topic: how-to
 author: scott-kim-sql
 ms.author: scottkim
 ms.reviewer: kendralittle, mathoma
-ms.date: 03/23/2021
+ms.date: 03/07/2022
 ---
-# Configure maintenance window (Preview)
+# Configure maintenance window
 
 [!INCLUDE[appliesto-sqldb-sqlmi](../includes/appliesto-sqldb-sqlmi.md)]
 
-Configure the [maintenance window (Preview)](maintenance-window.md) for an Azure SQL database, elastic pool, or Azure SQL Managed Instance database during resource creation, or anytime after a resource is created.
+Configure the [maintenance window](maintenance-window.md) for an Azure SQL database, elastic pool, or Azure SQL Managed Instance database during resource creation, or anytime after a resource is created.
 
 The *System default* maintenance window is 5PM to 8AM daily (local time of the Azure region the resource is located) to avoid peak business hours interruptions. If the *System default* maintenance window is not the best time, select one of the other available maintenance windows.
 
@@ -415,6 +415,6 @@ Be sure to delete unneeded resources after you're finished with them to avoid un
 
 ## Next steps
 
-- To learn more about maintenance window, see [Maintenance window (Preview)](maintenance-window.md).
+- To learn more about maintenance window, see [Maintenance window](maintenance-window.md).
 - For more information, see [Maintenance window FAQ](maintenance-window-faq.yml).
 - To learn about optimizing performance, see [Monitoring and performance tuning in Azure SQL Database and Azure SQL Managed Instance](monitor-tune-overview.md).

articles/azure-sql/database/maintenance-window-faq.yml

@@ -10,7 +10,7 @@ metadata:
   ms.author: wiassaf
   ms.reviewer: kendralittle, mathoma
   ms.custom: 
-  ms.date: 09/30/2021
+  ms.date: 03/07/2022
 
 title: Maintenance window FAQ
 summary: This article answers frequently asked questions about the maintenance window for [Azure SQL database](sql-database-paas-overview.md) and [SQL managed instance](../managed-instance/sql-managed-instance-paas-overview.md).
@@ -19,27 +19,27 @@ sections:
     questions: 
       - question: What is the maintenance window feature?
         answer: |
-         The maintenance window feature provides you with the ability to onboard Azure SQL resource to prescheduled time blocks outside of business hours. See [Maintenance window schedules](maintenance-window.md#gain-more-predictability-with-maintenance-window) for more information.
+         The maintenance window feature provides you with the ability to onboard Azure SQL resource to prescheduled time blocks outside of business hours. For more information, see [Maintenance window schedules](maintenance-window.md#gain-more-predictability-with-maintenance-window).
 
-      - question: What is the default maintenance policy if I do not choose any specific window? 
+      - question: What is the default maintenance policy if I don't choose any specific window? 
         answer: |
           Maintenance events will occur during the default window 5PM to 8AM local time, Monday - Sunday. 
 
       - question: Users work in a different time zone than the Azure data center. Which time zone is local?
         answer: |
-          Local time is determined by the location of Azure region that hosts the resource and may observe daylight saving time in accordance with local time zone definition. It is not determined by the time zone configured on SQL database (always UTC) or managed instance.
+          Local time is determined by the location of Azure region that hosts the resource and may observe daylight saving time in accordance with local time zone definition. It isn't determined by the time zone configured on SQL database (always UTC) or managed instance.
 
       - question: Can I choose a specific time/day for the maintenance window?
         answer: |
           No, you can choose between pre-scheduled weekday or weekend windows. The maintenance can happen any time or day within the window.  
 
       - question: What happens once I choose a maintenance window? 
         answer: | 
-          Configuring maintenance window is a long running asynchronous operation, similar to changing the service tier of your Azure SQL resource. The resource is available during the process, except a short reconfiguration that happens at the end of the operation and typically lasts up to 8 seconds even in case of interrupted long-running transactions. To minimize the impact of the reconfiguration you should perform the operation outside of the peak hours. In case of managed instance, IP address of the instance will change.
+          Configuring maintenance window is a long running asynchronous operation, similar to changing the service tier of your Azure SQL resource. The resource is available during the process, except a short reconfiguration that happens at the end of the operation and typically lasts up to 8 seconds even in case of interrupted long-running transactions. To minimize the impact of the reconfiguration, you should perform the operation outside of the peak hours. In case of managed instance, IP address of the instance will change.
 
       - question: What types of updates are typically performed during a maintenance window? 
         answer: |
-          The maintenance event may contain updates for hardware, firmware, operating system, satellite software components, and SQL engine. They are typically combined into a single batch to minimize the incidence of maintenance events.
+          The maintenance event may contain updates for hardware, firmware, operating system, satellite software components, and SQL engine. They're typically combined into a single batch to minimize the incidence of maintenance events.
 
       - question: What can I expect during a maintenance event?
         answer: |
@@ -63,19 +63,19 @@ sections:
         
       - question: Would I receive a notification of the maintenance window?
         answer: |
-          You can opt in to receive notification 24 hours prior to the maintenance event, immediately before maintenance starts, and when the maintenance window is completed. The Resource health center can be checked for more information. To receive emails, advance notification must be configured, for more information see [Advance notifications](advance-notifications.md).
+          You can opt in to receive notification 24 hours prior to the maintenance event, immediately before maintenance starts, and when the maintenance window is completed. The Resource health center can be checked for more information. To receive emails, advance notifications must be configured. For more information, see [Advance notifications](advance-notifications.md).
 
       - question: In which service level objectives (SLOs) can I choose a maintenance window? 
         answer: |
           Choosing a maintenance window is available in most SLOs with some exceptions, see [maintenance window supported service level objectives](maintenance-window.md#supported-service-level-objectives).
 
-      - question: If I have selected a maintenance window for a resource, and I downscale to a service level objective (SLO) where choosing a maintenance window is not supported, what happens to my database?
+      - question: If I've selected a maintenance window for a resource, and I downscale to a service level objective (SLO) where choosing a maintenance window isn't supported, what happens to my database?
         answer: |
-          In this case, the maintenance window would revert to the default option which is 5PM to 8AM local time.
+          In this case, the maintenance window would revert to the default option, which is 5PM to 8AM local time.
       
       - question: Can I cancel or postpone a planned maintenance event based on the received notification?
         answer: |
-          No. Cancelling or postponing an upcoming maintenance event is not supported. Notifications help you to prepare for the event.
+          No. Cancelling or postponing an upcoming maintenance event isn't supported. Notifications help you to prepare for the event.
 
       - question: How long does it take to process a maintenance window schedule change?
         answer: |
@@ -103,11 +103,15 @@ sections:
 
       - question: I have the default maintenance window selected. Can I enable advance notifications for that maintenance?
         answer: |
-          No, advance notifications cannot be configured for the default maintenance window option. When choosing a maintenance window, choose an option other than **System default** to configure and enable advance notifications.
+          No, advance notifications can't be configured for the default maintenance window option. When choosing a maintenance window, choose an option other than **System default** to configure and enable advance notifications.
 
-      - question: I am not able to set up advance notifications for planned maintenance, will I still see planned maintenance event in Service Health dashboard?
+      - question: I'm not able to set up advance notifications for planned maintenance, will I still see planned maintenance event in Service Health dashboard?
         answer: |
-          No, if advance notifications are not configured, Service Health will not show the planned maintenance events. 
+          No, if advance notifications aren't configured, Service Health won't show the planned maintenance events. 
+
+      - question: Does advance notification cover all maintenance events? 
+        answer: | 
+          No, advance notifications focus only on planned maintenance events that can cause a service interruption. 
 
 
 additionalContent: |