Share via


Restore-AzSynapseSqlPool

還原 Synapse Analytics SQL 集區。

Syntax

Restore-AzSynapseSqlPool
       [-FromBackup]
       [-ResourceGroupName <String>]
       -WorkspaceName <String>
       -Name <String>
       -ResourceId <String>
       [-Tag <Hashtable>]
       [-StorageAccountType <String>]
       [-AsJob]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzSynapseSqlPool
       [-FromBackup]
       -WorkspaceObject <PSSynapseWorkspace>
       -Name <String>
       -ResourceId <String>
       [-Tag <Hashtable>]
       [-StorageAccountType <String>]
       [-AsJob]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzSynapseSqlPool
       [-FromRestorePoint]
       [-ResourceGroupName <String>]
       -WorkspaceName <String>
       -Name <String>
       -PerformanceLevel <String>
       -ResourceId <String>
       -RestorePoint <DateTime>
       [-Tag <Hashtable>]
       [-StorageAccountType <String>]
       [-AsJob]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzSynapseSqlPool
       [-FromRestorePoint]
       -WorkspaceObject <PSSynapseWorkspace>
       -Name <String>
       -PerformanceLevel <String>
       -ResourceId <String>
       -RestorePoint <DateTime>
       [-Tag <Hashtable>]
       [-StorageAccountType <String>]
       [-AsJob]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzSynapseSqlPool
       [-FromDroppedSqlPool]
       [-ResourceGroupName <String>]
       -WorkspaceName <String>
       -Name <String>
       -ResourceId <String>
       -DeletionDate <DateTime>
       [-Tag <Hashtable>]
       [-StorageAccountType <String>]
       [-AsJob]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzSynapseSqlPool
       [-FromDroppedSqlPool]
       -WorkspaceObject <PSSynapseWorkspace>
       -Name <String>
       -ResourceId <String>
       -DeletionDate <DateTime>
       [-Tag <Hashtable>]
       [-StorageAccountType <String>]
       [-AsJob]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Restore-AzSynapseSqlPool Cmdlet 會從異地備援備份、已刪除 SQL 集區備份或任何 SQL 集區的還原點還原 Azure Synapse Analytics SQL 集區。 還原的 SQL 集區會建立為新的 SQL 集區。

範例

範例 1

# Transform Synapse SQL pool resource ID to SQL database ID because 
# currently the command only accepts the SQL databse ID. For example: /subscriptions/<SubscriptionId>/resourceGroups/<ResourceGroupName>/providers/Microsoft.Sql/servers/<WorkspaceName>/databases/<DatabaseName>
$pool = Get-AzSynapseSqlPool -ResourceGroupName ContosoResourceGroup -WorkspaceName ContosoWorkspace -Name ContosoSqlPool
$databaseId = $pool.Id -replace "Microsoft.Synapse", "Microsoft.Sql" `
	-replace "workspaces", "servers" `
	-replace "sqlPools", "databases"
 
# Get the latest restore point
$restorePoint = $pool | Get-AzSynapseSqlPoolRestorePoint | Select-Object -Last 1

# Restore to same workspace with source SQL pool
$restoredPool = Restore-AzSynapseSqlPool -FromRestorePoint -RestorePoint $restorePoint.RestorePointCreationDate -TargetSqlPoolName ContosoRestoredSqlPool -ResourceGroupName $pool.ResourceGroupName -WorkspaceName $pool.WorkspaceName -ResourceId $databaseId -PerformanceLevel DW200c

此命令會利用任何現有 SQL 集區的還原點,從任何現有的 SQL 集區建立 Azure Synapse Analytics SQL 集區,以復原或複製先前的狀態。

範例 2

# Transform Synapse SQL pool resource ID to SQL database ID because
# currently the command only accepts the SQL databse ID. For example: /subscriptions/<SubscriptionId>/resourceGroups/<ResourceGroupName>/providers/Microsoft.Sql/servers/<WorkspaceName>/recoverabledatabases/<DatabaseName>
$pool = Get-AzSynapseSqlPoolGeoBackup -ResourceGroupName ContosoResourceGroup -WorkspaceName ContosoWorkspace -Name ContosoSqlPool
$databaseId = $pool.Id -replace "Microsoft.Synapse", "Microsoft.Sql" `
    -replace "workspaces", "servers"

# Restore to same workspace with source SQL pool
$restoredPool = Restore-AzSynapseSqlPool -FromBackup -TargetSqlPoolName ContosoRestoredSqlPool -ResourceGroupName $pool.ResourceGroupName -WorkspaceName $pool.WorkspaceName -ResourceId $databaseId

此命令會建立從 SQL 集區備份還原的 Azure Synapse Analytics SQL 集區。

範例 3

# Transform Synapse dropped SQL pool resource ID to SQL pool resource ID
$pool = Get-AzSynapseDroppedSqlPool -ResourceGroupName ContosoResourceGroup -WorkspaceName ContosoWorkspace -Name ContosoSqlPool
$poolId = $pool.Id.Split(",")[0]
$poolId = $poolId -replace "restorableDroppedSqlPools", "sqlPools"

# Restore to same workspace with source SQL pool
$restoredPool = Restore-AzSynapseSqlPool -FromDroppedSqlPool -DeletionDate $pool.DeletionDate -TargetSqlPoolName ContosoRestoredSqlPool -ResourceGroupName $pool.ResourceGroupName -WorkspaceName $pool.WorkspaceName -ResourceId $poolId

此命令會建立 Azure Synapse Analytics SQL 集區,以從已刪除的 SQL 集區備份還原。

範例 4

# Transform Synapse SQL pool resource ID to SQL database ID because 
# currently the command only accepts the SQL databse ID. For example: /subscriptions/<SubscriptionId>/resourceGroups/<ResourceGroupName>/providers/Microsoft.Sql/servers/<WorkspaceName>/databases/<DatabaseName>
$pool = Get-AzSynapseSqlPool -ResourceGroupName ContosoResourceGroup -WorkspaceName ContosoWorkspace -Name ContosoSqlPool
$databaseId = $pool.Id -replace "Microsoft.Synapse", "Microsoft.Sql" `
	-replace "workspaces", "servers" `
	-replace "sqlPools", "databases"

# Get the latest restore point
$restorePoint = $pool | Get-AzSynapseSqlPoolRestorePoint | Select-Object -Last 1

# Restore to same workspace with source SQL pool
$restoredPool = Restore-AzSynapseSqlPool -FromRestorePoint -RestorePoint $restorePoint.RestorePointCreationDate -TargetSqlPoolName ContosoRestoredSqlPool -ResourceGroupName $pool.ResourceGroupName -WorkspaceName $pool.WorkspaceName -ResourceId $databaseId -PerformanceLevel DW200c -Tag @{"tagName" = "tagValue"} -StorageAccountType LRS

此命令會利用任何現有 SQL 集區的還原點來復原或複製先前狀態,以建立具有指定標籤和記憶體帳戶類型的 Azure Synapse Analytics SQL 集區。

參數

-AsJob

在背景執行 Cmdlet

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

執行 Cmdlet 之前先提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeletionDate

要擷取備份的 Azure Synaspe SQL 資料庫 刪除日期,其毫秒精確度為 (例如 2016-02-23T00:21:22.847Z)

Type:DateTime
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-FromBackup

指出從這個訂用帳戶中任何 SQL 集區的最新備份還原。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-FromDroppedSqlPool

表示利用這個訂用帳戶中任何 SQL 集區的還原點,從先前的狀態復原或複製。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-FromRestorePoint

表示利用這個訂用帳戶中任何 SQL 集區的還原點,從先前的狀態復原或複製。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Synapse SQL 集區的名稱。

Type:String
Aliases:TargetSqlPoolName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PerformanceLevel

要指派給 SQL 集區的 SQL 服務層級和效能等級。 例如,DW2000c。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

資源組名。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceId

要還原之資料庫的資源標識碼。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RestorePoint

要還原的快照集時間。

Type:DateTime
Aliases:PointInTime
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-StorageAccountType

用來儲存 sql 集區備份的記憶體帳戶類型。 可能的值包括:『GRS』、『LRS』。

Type:String
Accepted values:GRS, LRS
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

與資源相關聯之標籤的字串、字串字典。

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkspaceName

Synapse 工作區的名稱。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WorkspaceObject

工作區輸入物件,通常是透過管線傳遞。

Type:PSSynapseWorkspace
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

輸入

PSSynapseWorkspace

輸出

PSSynapseSqlPool