Merge pull request #50362 from kevinvngo/patch-45

Consolidate restore articles

Author: TrishaMc

articles/sql-data-warehouse/TOC.yml

@@ -213,12 +213,8 @@
     items:
     - name: Monitor your workload
       href: sql-data-warehouse-manage-monitor.md
-    - name: Restore - Portal
-      href: sql-data-warehouse-restore-database-portal.md
-    - name: Restore - PowerShell
-      href: sql-data-warehouse-restore-database-powershell.md
-    - name: Restore - REST API
-      href: sql-data-warehouse-restore-database-rest-api.md
+    - name: Restore your data warehouse
+      href: sql-data-warehouse-restore.md
     - name: Upgrade to Gen2
       href: upgrade-to-latest-generation.md
     - name: Automate performance levels

articles/sql-data-warehouse/media/sql-data-warehouse-restore-database-portal/creating_restore_point_0.png

@@ -0,0 +1,270 @@
+---
+title: Restore an Azure SQL Data Warehouse | Microsoft Docs
+description: How to guide for restoring an Azure SQL Data Warehouse.
+services: sql-data-warehouse
+author: kevinvngo
+manager: craigg-msft
+ms.service: sql-data-warehouse
+ms.topic: conceptual
+ms.component: manage
+ms.date: 08/29/2018
+ms.author: kevin
+ms.reviewer: igorstan
+---
+
+
+# Restoring Azure SQL Data Warehouse 
+In this article you will learn how to do the following:
+
+- Create a restore point
+- Restore from an automatic restore point or user-defined restore point
+- Restore from a deleted database
+- Restore from a geo-backup
+- Create a copy of your data warehouse from a user-defined restore point
+
+## Before you begin
+**Verify your DTU capacity.** Each SQL Data Warehouse is hosted by a SQL server (e.g. myserver.database.windows.net) which has a default DTU quota.  Before you can restore a SQL data warehouse, verify that the your 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 through PowerShell
+
+## Install PowerShell
+In order to use Azure PowerShell with SQL Data Warehouse, you will need to install Azure PowerShell version 1.0 or greater.  You can check your version by running **Get-Module -ListAvailable -Name AzureRM**.  The latest version can be installed from  [Microsoft Web Platform Installer][Microsoft Web Platform Installer].  For more information on installing the latest version, see [How to install and configure Azure PowerShell][How to install and configure Azure PowerShell].
+
+## Restore an active or paused database
+To restore a database from a restore point use the [Restore-AzureRmSqlDatabase][Restore-AzureRmSqlDatabase] PowerShell cmdlet.
+
+1. Open Windows 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 database.
+
+5. Pick the desired restore point using the RestorePointCreationDate.
+
+   > [!NOTE]
+   > When restoring, you can specify a different ServiceObjectiveName (DWU) or a different server residing in a different region.
+
+6. Restore the database to the desired restore point.
+
+7. Verify that the restored database is online.
+
+```Powershell
+
+$SubscriptionName="<YourSubscriptionName>"
+$ResourceGroupName="<YourResourceGroupName>"
+$ServerName="<YourServerNameWithoutURLSuffixSeeNote>"  # Without database.windows.net
+$DatabaseName="<YourDatabaseName>"
+$NewDatabaseName="<YourDatabaseName>"
+
+Connect-AzureRmAccount
+Get-AzureRmSubscription
+Select-AzureRmSubscription -SubscriptionName $SubscriptionName
+
+# List the last 10 database restore points
+((Get-AzureRMSqlDatabaseRestorePoints -ResourceGroupName $ResourceGroupName -ServerName $ServerName -DatabaseName ($DatabaseName)).RestorePointCreationDate)[-10 .. -1]
+
+# Or list all restore points
+Get-AzureRmSqlDatabaseRestorePoints -ResourceGroupName $ResourceGroupName -ServerName $ServerName -DatabaseName $DatabaseName
+
+# Get the specific database to restore
+$Database = Get-AzureRmSqlDatabase -ResourceGroupName $ResourceGroupName -ServerName $ServerName -DatabaseName $DatabaseName
+
+# Pick desired restore point using RestorePointCreationDate
+$PointInTime="<RestorePointCreationDate>"  
+
+# Restore database from a restore point
+$RestoredDatabase = Restore-AzureRmSqlDatabase –FromPointInTimeBackup –PointInTime $PointInTime -ResourceGroupName $Database.ResourceGroupName -ServerName $Database.ServerName -TargetDatabaseName $NewDatabaseName –ResourceId $Database.ResourceID
+
+# Verify the status of restored database
+$RestoredDatabase.status
+
+```
+
+> [!NOTE]
+> After the restore has completed, you can configure your recovered database by following [Configure your database after recovery][Configure your database after recovery].
+>
+
+## Copy your data warehouse with user-defined restore points
+To restore a database from a user-defined restore point use the [Restore-AzureRmSqlDatabase][Restore-AzureRmSqlDatabase] PowerShell cmdlet.
+
+1. Open Windows 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. Create a restore point for an immediate copy of your database
+5. Rename your database to a temporary name.
+5. Retrieve the most recent restore point by the specified RestorePointLabel.
+6. Get the resource id of the database to initiate the restore
+6. Restore the database to the desired restore point.
+7. Verify that the restored database is online.
+
+```Powershell
+
+$SubscriptionName="<YourSubscriptionName>"
+$ResourceGroupName="<YourResourceGroupName>"
+$ServerName="<YourServerNameWithoutURLSuffixSeeNote>"  # Without database.windows.net
+$DatabaseName="<YourDatabaseName>"
+$TempDatabaseName = "<YourTemporaryDatabaseName>"
+$Label = "<YourRestorePointLabel"
+
+Connect-AzureRmAccount
+Get-AzureRmSubscription
+Select-AzureRmSubscription -SubscriptionName $SubscriptionName
+
+# Create a restore point of the original database
+New-AzureRmSqlDatabaseRestorePoint -ResourceGroupName $ResourceGroupName -ServerName $ServerName -DatabaseName $DatabaseName -RestorePointLabel $Label
+
+# Rename the database to a temporary name
+Set-AzureRmSqlDatabase -ResourceGroupName $ResourceGroupName -ServerName $ServerName -DatabaseName $DatabaseName -NewName $TempDatabaseName
+
+# Get the most recent restore point with the specified label
+$LabelledRestorePoint = Get-AzureRmSqlDatabaseRestorePoints -ResourceGroupName $ResourceGroupName -ServerName $ServerName -DatabaseName $TempDatabaseName | where {$_.RestorePointLabel -eq $Label} | sort {$_.RestorePointCreationDate} | select -Last 1
+
+# Get the resource id of the database
+$ResourceId = (Get-AzureRmSqlDatabase -ResourceGroupName $ResourceGroupName -ServerName $ServerName -DatabaseName $TempDatabaseName).ResourceId
+
+# Restore the database to its original name from the labelled restore point from the temporary database
+$RestoredDatabase = Restore-AzureRmSqlDatabase -FromPointInTimeBackup -ResourceGroupName $ResourceGroupName -ServerName $ServerName -ResourceId $ResourceId -PointInTime $LabelledRestorePoint.RestorePointCreationDate -TargetDatabaseName $DatabaseName
+
+# Verify the status of restored database
+$RestoredDatabase.status
+
+# The original temporary database can be deleted at this point
+
+```
+
+## Restore a deleted database
+To restore a deleted database, use the [Restore-AzureRmSqlDatabase][Restore-AzureRmSqlDatabase] cmdlet.
+
+1. Open Windows PowerShell.
+2. Connect to your Azure account and list all the subscriptions associated with your account.
+3. Select the subscription that contains the deleted database to be restored.
+4. Get the specific deleted database.
+5. Restore the deleted database.
+6. Verify that the restored database is online.
+
+```Powershell
+$SubscriptionName="<YourSubscriptionName>"
+$ResourceGroupName="<YourResourceGroupName>"
+$ServerName="<YourServerNameWithoutURLSuffixSeeNote>"  # Without database.windows.net
+$DatabaseName="<YourDatabaseName>"
+$NewDatabaseName="<YourDatabaseName>"
+
+Connect-AzureRmAccount
+Get-AzureRmSubscription
+Select-AzureRmSubscription -SubscriptionName $SubscriptionName
+
+# Get the deleted database to restore
+$DeletedDatabase = Get-AzureRmSqlDeletedDatabaseBackup -ResourceGroupName $ResourceGroupName -ServerName $ServerName -DatabaseName $DatabaseName
+
+# Restore deleted database
+$RestoredDatabase = Restore-AzureRmSqlDatabase –FromDeletedDatabaseBackup –DeletionDate $DeletedDatabase.DeletionDate -ResourceGroupName $DeletedDatabase.ResourceGroupName -ServerName $DeletedDatabase.ServerName -TargetDatabaseName $NewDatabaseName –ResourceId $DeletedDatabase.ResourceID
+
+# Verify the status of restored database
+$RestoredDatabase.status
+```
+
+> [!NOTE]
+> After the restore has completed, you can configure your recovered database by following [Configure your database after recovery][Configure your database after recovery].
+>
+
+## Restore from an Azure geographical region
+To recover a database, use the [Restore-AzureRmSqlDatabase][Restore-AzureRmSqlDatabase] 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. Open Windows 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. Get the database you want to recover.
+5. Create the recovery request for the database.
+6. Verify the status of the geo-restored database.
+
+```Powershell
+Connect-AzureRmAccount
+Get-AzureRmSubscription
+Select-AzureRmSubscription -SubscriptionName "<Subscription_name>"
+
+# Get the database you want to recover
+$GeoBackup = Get-AzureRmSqlDatabaseGeoBackup -ResourceGroupName "<YourResourceGroupName>" -ServerName "<YourServerName>" -DatabaseName "<YourDatabaseName>"
+
+# Recover database
+$GeoRestoredDatabase = Restore-AzureRmSqlDatabase –FromGeoBackup -ResourceGroupName "<YourResourceGroupName>" -ServerName "<YourTargetServer>" -TargetDatabaseName "<NewDatabaseName>" –ResourceId $GeoBackup.ResourceID -ServiceObjectiveName "<YourTargetServiceLevel>"
+
+# Verify that the geo-restored database is online
+$GeoRestoredDatabase.status
+```
+
+> [!NOTE]
+> To configure your database after the restore has completed, see [Configure your database after recovery][Configure your database after recovery].
+>
+
+The recovered database will be TDE-enabled if the source database is TDE-enabled.
+
+# Restore through the Azure Portal
+
+## Create a user-defined restore point
+1. Sign in to the [Azure portal][Azure portal].
+
+2. Navigate to the SQL data warehouse that you want to create a restore point for.
+
+3. At the top of the Overview blade, select **+New Restore Point**.
+
+    ![New Restore Point](./media/sql-data-warehouse-restore-database-portal/creating_restore_point_0.png)
+    
+4. Specify a name for your restore point.
+
+    ![Name of Restore Point](./media/sql-data-warehouse-restore-database-portal/creating_restore_point_1.png)
+
+## Restore an active or paused database
+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-database-portal/restoring_0.png)
+    
+4. Select either **Automatic Restore Points** or **User-Defined Restore Points**.
+
+    ![Automatic Restore Points](./media/sql-data-warehouse-restore-database-portal/restoring_1.png)
+    
+5. For User-Defined Restore Points, **select a Restore point** or **Create a new user-defined restore point**.
+
+    ![User-defined Restore Points](./media/sql-data-warehouse-restore-database-portal/restoring_2_udrp.png)
+
+## Restore a deleted database
+1. Sign in to the [Azure portal][Azure portal].
+2. Navigate to the SQL server your deleted database was hosted on.
+3. Select the Deleted databases icon in the table of contents.
+
+    ![Deleted Databases](./media/sql-data-warehouse-restore-database-portal/restoring_deleted_0.png)
+    
+4. Select the deleted database that you want to restore.
+
+    ![Select Deleted Databases](./media/sql-data-warehouse-restore-database-portal/restoring_deleted_1.png)
+    
+5. Specify a new database name.
+
+    ![Specify Database Name](./media/sql-data-warehouse-restore-database-portal/restoring_deleted_2.png)
+
+<!--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
+
+<!--MSDN references-->
+[Restore-AzureRmSqlDatabase]: https://docs.microsoft.com/powershell/module/azurerm.sql/restore-azurermsqldatabase
+
+<!--Other Web references-->
+[Azure Portal]: https://portal.azure.com/
+[Microsoft Web Platform Installer]: https://aka.ms/webpi-azps