Merge pull request MicrosoftDocs#82720 from anumjs/backup-restore

Backup restore docs

articles/sql-data-warehouse/TOC.yml

@@ -281,6 +281,16 @@
  href: sql-data-warehouse-manage-monitor.md
  - name: Monitor Gen2 cache
  href: sql-data-warehouse-how-to-monitor-cache.md
+ - name: Backup and restore
+ items:
+ - name: Create restore points
+ href: sql-data-warehouse-restore-points.md
+ - name: Restore an existing data warehouse
+ href: sql-data-warehouse-restore-active-paused-dw.md
+ - name: Restore a deleted data warehouse 
+ href: sql-data-warehouse-restore-deleted-dw.md
+ - name: Restore from a geo-backup 
+ href: sql-data-warehouse-restore-from-geo-backup.md 
  - name: Integrate
  items:
  - name: Use machine learning

articles/sql-data-warehouse/sql-data-warehouse-restore-active-paused-dw.md

@@ -0,0 +1,122 @@
+---
+title: Restore an existing Azure SQL Data Warehouse | Microsoft Docs
+description: How-to guide for restoring an existing Azure SQL Data Warehouse.
+services: sql-data-warehouse
+author: anumjs
+manager: craigg
+ms.service: sql-data-warehouse
+ms.topic: conceptual
+ms.subservice: manage
+ms.date: 08/29/2018
+ms.author: anjangsh
+ms.reviewer: igorstan
+---
+
+# Restore an existing Azure SQL Data Warehouse
+
+In this article, you learn to restore an existing SQL Data Warehouse through Azure portal and PowerShell:
+
+[!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
+
+**Verify your DTU capacity.** Each SQL Data Warehouse is hosted by a SQL server (for example, myserver.database.windows.net) which has a default DTU quota. Verify the SQL server has enough remaining DTU quota for the database being restored. To learn how to calculate DTU needed or to request more DTU, see [Request a DTU quota change][Request a DTU quota change].
+
+## Before you begin
+
+1. Make sure to [install Azure PowerShell][Install Azure PowerShell].
+2. Have an existing restore point that you want to restore from. If you want to create a new restore, see [the tutorial to create a new user-defined restore point][the tutorial to create a new user-defined restore point].
+
+## Restore an existing data warehouse through PowerShell
+
+To restore an existing data warehouse from a restore point use the [Restore-AzSqlDatabase][Restore-AzSqlDatabase] PowerShell cmdlet.
+
+1. Open PowerShell.
+
+2. Connect to your Azure account and list all the subscriptions associated with your account.
+
+3. Select the subscription that contains the database to be restored.
+
+4. List the restore points for the data warehouse.
+
+5. Pick the desired restore point using the RestorePointCreationDate.
+
+6. Restore the data warehouse to the desired restore point using [Restore-AzSqlDatabase][Restore-AzSqlDatabase] PowerShell cmdlet.
+ 1. To restore the SQL Data Warehouse to a different logical server, make sure to specify the other logical server name. This logical server can also be in a different resource group and region.
+ 2. To restore to a different subscription, use the 'Move' button to move the logical server to another subscription.
+
+7. Verify that the restored data warehouse is online.
+
+8. After the restore has completed, you can configure your recovered data warehouse by following [configure your database after recovery][Configure your database after recovery].
+
+```Powershell
+
+$SubscriptionName="<YourSubscriptionName>"
+$ResourceGroupName="<YourResourceGroupName>"
+$ServerName="<YourServerNameWithoutURLSuffixSeeNote>" # Without database.windows.net
+#$TargetResourceGroupName="<YourTargetResourceGroupName>" # uncomment to restore to a different logical server.
+#$TargetServerName="<YourtargetServerNameWithoutURLSuffixSeeNote>" 
+$DatabaseName="<YourDatabaseName>"
+$NewDatabaseName="<YourDatabaseName>"
+
+Connect-AzAccount
+Get-AzSubscription
+Select-AzSubscription -SubscriptionName $SubscriptionName
+
+# Or list all restore points
+Get-AzSqlDatabaseRestorePoints -ResourceGroupName $ResourceGroupName -ServerName $ServerName -DatabaseName $DatabaseName
+
+# Get the specific database to restore
+$Database = Get-AzSqlDatabase -ResourceGroupName $ResourceGroupName -ServerName $ServerName -DatabaseName $DatabaseName
+
+# Pick desired restore point using RestorePointCreationDate "xx/xx/xxxx xx:xx:xx xx"
+$PointInTime="<RestorePointCreationDate>" 
+
+# Restore database from a restore point
+$RestoredDatabase = Restore-AzSqlDatabase –FromPointInTimeBackup –PointInTime $PointInTime -ResourceGroupName $Database.ResourceGroupName -ServerName $Database.ServerName -TargetDatabaseName $NewDatabaseName –ResourceId $Database.ResourceID
+
+# Use the following command to restore to a different logical server
+#$RestoredDatabase = Restore-AzSqlDatabase –FromPointInTimeBackup –PointInTime $PointInTime -ResourceGroupName $Database.ResourceTargetGroupName -ServerName $TargetServerName -TargetDatabaseName $NewDatabaseName –ResourceId $Database.ResourceID
+
+# Verify the status of restored database
+$RestoredDatabase.status
+
+```
+
+## Restore an existing data warehouse through the Azure portal
+
+1. Sign in to the [Azure portal][Azure portal].
+2. Navigate to the SQL data warehouse that you want to restore from.
+3. At the top of the Overview blade, select **Restore**.
+
+ ![ Restore Overview](./media/sql-data-warehouse-restore-active-paused-dw/restoring-01.png)
+
+4. Select either **Automatic Restore Points** or **User-Defined Restore Points**. If the data warehouse doesn't have any automatic restore points, wait a few hours or create a user defined restore point before restoring. For User-Defined Restore Points, select an existing one or create a new one. For **Server**, you can pick a logical server in a different resource group and region or create a new one. After providing all the parameters, click **Review + Restore**.
+
+ ![Automatic Restore Points](./media/sql-data-warehouse-restore-active-paused-dw/restoring-11.png)
+
+## Next Steps
+- [Restore a deleted data warehouse][Restore a deleted data warehouse]
+- [Restore from a geo-backup data warehouse][Restore from a geo-backup data warehouse]
+
+<!--Image references-->
+
+<!--Article references-->
+[Azure SQL Database business continuity overview]: ../sql-database/sql-database-business-continuity.md
+[Request a DTU quota change]: ./sql-data-warehouse-get-started-create-support-ticket.md
+[Configure your database after recovery]: ../sql-database/sql-database-disaster-recovery.md#configure-your-database-after-recovery
+[How to install and configure Azure PowerShell]: /powershell/azureps-cmdlets-docs
+[Overview]: ./sql-data-warehouse-restore-database-overview.md
+[Portal]: ./sql-data-warehouse-restore-database-portal.md
+[PowerShell]: ./sql-data-warehouse-restore-database-powershell.md
+[REST]: ./sql-data-warehouse-restore-database-rest-api.md
+[Configure your database after recovery]: ../sql-database/sql-database-disaster-recovery.md#configure-your-database-after-recovery
+[the tutorial to create a new user-defined restore point]:../sql-data-warehouse/sql-data-warehouse-restore-points.md
+[Install Azure PowerShell]: https://docs.microsoft.com/powershell/azure/overview
+[Restore an existing data warehouse]:./sql-data-warehouse-restore-active-paused-dw.md
+[Restore a deleted data warehouse]:./sql-data-warehouse-restore-deleted-dw.md
+[Restore from a geo-backup data warehouse]:./sql-data-warehouse-restore-from-geo-backup.md
+
+<!--MSDN references-->
+[Restore-AzSqlDatabase]: https://docs.microsoft.com/powershell/module/az.sql/restore-azsqldatabase
+
+<!--Other Web references-->
+[Azure Portal]: https://portal.azure.com/

articles/sql-data-warehouse/sql-data-warehouse-restore-deleted-dw.md

@@ -0,0 +1,108 @@
+---
+title: Restore a deleted Azure SQL Data Warehouse | Microsoft Docs
+description: How to guide for restoring a deleted Azure SQL Data Warehouse.
+services: sql-data-warehouse
+author: anumjs
+manager: craigg
+ms.service: sql-data-warehouse
+ms.topic: conceptual
+ms.subservice: manage
+ms.date: 08/29/2018
+ms.author: anjangsh
+ms.reviewer: igorstan
+---
+
+# Restore a deleted Azure SQL Data Warehouse
+
+In this article, you learn to restore a deleted SQL Data Warehouse using Azure portal and PowerShell:
+
+## Before you begin
+
+[!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
+
+**Verify your DTU capacity.** Each SQL Data Warehouse is hosted by a SQL server (for example, myserver.database.windows.net) which has a default DTU quota. Verify that the SQL server has enough remaining DTU quota for the database being restored. To learn how to calculate DTU needed or to request more DTU, see [Request a DTU quota change][Request a DTU quota change].
+
+## Restore a deleted data warehouse through PowerShell
+
+To restore a deleted SQL Data Warehouse, use the [Restore-AzSqlDatabase][Restore-AzSqlDatabase] cmdlet. If the corresponding logical server has been deleted as well, you can't restore that data warehouse.
+
+1. Before you begin, make sure to [install Azure PowerShell][Install Azure PowerShell].
+2. Open PowerShell.
+3. Connect to your Azure account and list all the subscriptions associated with your account.
+4. Select the subscription that contains the deleted data warehouse to be restored.
+5. Get the specific deleted data warehouse.
+6. Restore the deleted data warehouse
+ 1. To restore the deleted SQL Data Warehouse to a different logical server, make sure to specify the other logical server name. This logical server can also be in a different resource group and region.
+ 1. To restore to a different subscription, use the [Move][Move] button to move the logical server to another subscription.
+1. Verify that the restored data warehouse is online.
+1. After the restore has completed, you can configure your recovered data warehouse by following [configure your database after recovery][Configure your database after recovery].
+
+```Powershell
+$SubscriptionName="<YourSubscriptionName>"
+$ResourceGroupName="<YourResourceGroupName>"
+$ServerName="<YourServerNameWithoutURLSuffixSeeNote>" # Without database.windows.net
+#$TargetResourceGroupName="<YourTargetResourceGroupName>" # uncomment to restore to a different logical server.
+#$TargetServerName="<YourtargetServerNameWithoutURLSuffixSeeNote>" 
+$DatabaseName="<YourDatabaseName>"
+$NewDatabaseName="<YourDatabaseName>"
+
+Connect-AzAccount
+Get-AzSubscription
+Select-AzSubscription -SubscriptionName $SubscriptionName
+
+# Get the deleted database to restore
+$DeletedDatabase = Get-AzSqlDeletedDatabaseBackup -ResourceGroupName $ResourceGroupName -ServerName $ServerName -DatabaseName $DatabaseName
+
+# Restore deleted database
+$RestoredDatabase = Restore-AzSqlDatabase –FromDeletedDatabaseBackup –DeletionDate $DeletedDatabase.DeletionDate -ResourceGroupName $DeletedDatabase.ResourceGroupName -ServerName $DeletedDatabase.ServerName -TargetDatabaseName $NewDatabaseName –ResourceId $DeletedDatabase.ResourceID
+
+# Use the following command to restore deleted data warehouse to a different logical server
+#$RestoredDatabase = Restore-AzSqlDatabase –FromDeletedDatabaseBackup –DeletionDate $DeletedDatabase.DeletionDate -ResourceGroupName $TargetResourceGroupName -ServerName $TargetServerName -TargetDatabaseName $NewDatabaseName –ResourceId $DeletedDatabase.ResourceID
+
+# Verify the status of restored database
+$RestoredDatabase.status
+```
+
+## Restore a deleted database using the Azure portal
+
+1. Sign in to the [Azure portal][Azure portal].
+2. Navigate to the SQL server your deleted data warehouse was hosted on.
+3. Select the **Deleted databases** icon in the table of contents.
+
+ ![Deleted Databases](./media/sql-data-warehouse-restore-deleted-dw/restoring-deleted-01.png)
+
+4. Select the deleted SQL Data Warehouse that you want to restore.
+
+ ![Select Deleted Databases](./media/sql-data-warehouse-restore-deleted-dw/restoring-deleted-11.png)
+
+5. Specify a new **Database name** and click **OK**
+
+ ![Specify Database Name](./media/sql-data-warehouse-restore-deleted-dw/restoring-deleted-21.png)
+
+## Next Steps
+- [Restore an existing data warehouse][Restore an existing data warehouse]
+- [Restore from a geo-backup data warehouse][Restore from a geo-backup data warehouse]
+
+<!--Image references-->
+
+<!--Article references-->
+[Azure SQL Database business continuity overview]: ../sql-database/sql-database-business-continuity.md
+[Request a DTU quota change]: ./sql-data-warehouse-get-started-create-support-ticket.md
+[Configure your database after recovery]: ../sql-database/sql-database-disaster-recovery.md#configure-your-database-after-recovery
+[Install Azure PowerShell]: https://docs.microsoft.com/powershell/azure/overview
+[Overview]: ./sql-data-warehouse-restore-database-overview.md
+[Portal]: ./sql-data-warehouse-restore-database-portal.md
+[PowerShell]: ./sql-data-warehouse-restore-database-powershell.md
+[REST]: ./sql-data-warehouse-restore-database-rest-api.md
+[Configure your database after recovery]: ../sql-database/sql-database-disaster-recovery.md#configure-your-database-after-recovery
+[support ticket]: https://docs.microsoft.com/azure/sql-data-warehouse/sql-data-warehouse-get-started-create-support-ticket
+[Move]:https://docs.microsoft.com/azure/azure-resource-manager/resource-group-move-resources#use-the-portal
+[Restore an existing data warehouse]:./sql-data-warehouse-restore-active-paused-dw.md
+[Restore a deleted data warehouse]:./sql-data-warehouse-restore-deleted-dw.md
+[Restore from a geo-backup data warehouse]:./sql-data-warehouse-restore-from-geo-backup.md
+
+<!--MSDN references-->
+[Restore-AzSqlDatabase]: https://docs.microsoft.com/powershell/module/az.sql/restore-azsqldatabase
+
+<!--Other Web references-->
+[Azure Portal]: https://portal.azure.com/

articles/sql-data-warehouse/sql-data-warehouse-restore-from-geo-backup.md

@@ -0,0 +1,112 @@
+---
+title: Restore an Azure SQL Data Warehouse from a geo-backup | Microsoft Docs
+description: How-to guide for geo-restoring an Azure SQL Data Warehouse.
+services: sql-data-warehouse
+author: anumjs
+manager: craigg
+ms.service: sql-data-warehouse
+ms.topic: conceptual
+ms.subservice: manage
+ms.date: 07/12/2019
+ms.author: anjangsh
+ms.reviewer: igorstan
+---
+
+# Geo-restore Azure SQL Data Warehouse
+
+In this article, you learn to restore your data warehouse from a geo-backup through Azure portal and PowerShell.
+
+## Before you begin
+
+[!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
+
+**Verify your DTU capacity.** Each SQL Data Warehouse is hosted by a SQL server (for example, myserver.database.windows.net) which has a default DTU quota. Verify that the SQL server has enough remaining DTU quota for the database being restored. To learn how to calculate DTU needed or to request more DTU, see [Request a DTU quota change][Request a DTU quota change].
+
+## Restore from an Azure geographical region through PowerShell
+
+To restore from a geo-backup, use the [Get-AzSqlDatabaseGeoBackup][Get-AzSqlDatabaseGeoBackup] and [Restore-AzSqlDatabase][Restore-AzSqlDatabase] cmdlet.
+
+> [!NOTE]
+> You can perform a geo-restore to Gen2! To do so, specify an Gen2 ServiceObjectiveName (e.g. DW1000**c**) as an optional parameter.
+>
+
+1. Before you begin, make sure to [install Azure PowerShell][Install Azure PowerShell].
+2. Open PowerShell.
+2. Connect to your Azure account and list all the subscriptions associated with your account.
+3. Select the subscription that contains the data warehouse to be restored.
+4. Get the data warehouse you want to recover.
+5. Create the recovery request for the data warehouse.
+6. Verify the status of the geo-restored data warehouse.
+7. To configure your data warehouse after the restore has completed, see [Configure your database after recovery][Configure your database after recovery].
+
+```Powershell
+$SubscriptionName="<YourSubscriptionName>"
+$ResourceGroupName="<YourResourceGroupName>"
+$ServerName="<YourServerNameWithoutURLSuffixSeeNote>" # Without database.windows.net
+$TargetResourceGroupName="<YourTargetResourceGroupName>" # Restore to a different logical server.
+$TargetServerName="<YourtargetServerNameWithoutURLSuffixSeeNote>" 
+$DatabaseName="<YourDatabaseName>"
+$NewDatabaseName="<YourDatabaseName>"
+$TargetServiceObjective="<YourTargetServiceObjective-DWXXXc>"
+
+Connect-AzAccount
+Get-AzSubscription
+Select-AzSubscription -SubscriptionName $SubscriptionName
+Get-AzureSqlDatabase -ServerName $ServerName
+
+# Get the data warehouse you want to recover
+$GeoBackup = Get-AzSqlDatabaseGeoBackup -ResourceGroupName $ResourceGroupName -ServerName $ServerName -DatabaseName $DatabaseName
+
+# Recover data warehouse
+$GeoRestoredDatabase = Restore-AzSqlDatabase –FromGeoBackup -ResourceGroupName $TargetResourceGroupName -ServerName $TargetServerName -TargetDatabaseName $NewDatabaseName –ResourceId $GeoBackup.ResourceID -ServiceObjectiveName $TargetServiceObjective
+
+# Verify that the geo-restored data warehouse is online
+$GeoRestoredDatabase.status
+```
+
+The recovered database will be TDE-enabled if the source database is TDE-enabled.
+
+## Restore from an Azure geographical region through Azure portal
+
+Follow the steps outlined below to restore an Azure SQL Data Warehouse from a geo-backup:
+
+1. Sign in to your [Azure portal][Azure portal] account.
+1. Click **+ Create a resource** and search for SQL Data Warehouse and click **Create**.
+
+ ![New DW](./media/sql-data-warehouse-restore-from-geo-backup/georestore-new.png)
+1. Fill out the information requested in the **Basics** tab and click **Next: Additional settings**.
+
+ ![Basics](./media/sql-data-warehouse-restore-from-geo-backup/georestore-dw-1.png)
+1. For **Use existing data** parameter, select **Backup** and select the appropriate backup from the scroll down options. Click **Review + Create**.
+
+ ![backup](./media/sql-data-warehouse-restore-from-geo-backup/georestore-select.png)
+2. Once the data warehouse has been restored, check that the **Status** is Online.
+
+## Next Steps
+- [Restore an existing data warehouse][Restore an existing data warehouse]
+- [Restore a deleted data warehouse][Restore a deleted data warehouse]
+
+<!--Image references-->
+
+<!--Article references-->
+[Install Azure PowerShell]: https://docs.microsoft.com/powershell/azure/overview
+[Azure SQL Database business continuity overview]: ../sql-database/sql-database-business-continuity.md
+[Request a DTU quota change]: ./sql-data-warehouse-get-started-create-support-ticket.md
+[Configure your database after recovery]: ../sql-database/sql-database-disaster-recovery.md#configure-your-database-after-recovery
+[How to install and configure Azure PowerShell]: /powershell/azureps-cmdlets-docs
+[Overview]: ./sql-data-warehouse-restore-database-overview.md
+[Portal]: ./sql-data-warehouse-restore-database-portal.md
+[PowerShell]: ./sql-data-warehouse-restore-database-powershell.md
+[REST]: ./sql-data-warehouse-restore-database-rest-api.md
+[Configure your database after recovery]: ../sql-database/sql-database-disaster-recovery.md#configure-your-database-after-recovery
+[Restore an existing data warehouse]:./sql-data-warehouse-restore-active-paused-dw.md
+[Restore a deleted data warehouse]:./sql-data-warehouse-restore-deleted-dw.md
+[Restore from a geo-backup data warehouse]:./sql-data-warehouse-restore-from-geo-backup.md
+
+
+<!--MSDN references-->
+[Restore-AzSqlDatabase]: https://docs.microsoft.com/powershell/module/az.sql/restore-azsqldatabase
+[Get-AzSqlDatabaseGeoBackup]: https://docs.microsoft.com/powershell/module/az.sql/get-azsqldatabasegeobackup
+
+<!--Other Web references-->
+[Azure Portal]: https://portal.azure.com/