删除具有活动租约的备份 Blob 文件

项目
07/08/2024

适用范围：SQL Server

在备份到 Microsoft Azure 存储或从中还原时，SQL Server 获得无限期租约以锁定对 blob 的独占访问。当成功完成备份或还原过程时，释放租约。如果备份或还原失败，备份过程将尝试清除所有无效的 blob。但是，如果由于持续很长时间的网络连接故障而导致备份失败，备份过程可能无法再次访问 blob 且 blob 可能保持孤立状态。这意味着在释放租约前，不能写入或删除 blob。本主题说明如何释放（中断）租约和删除 blob。

有关租约类型的详细信息，请阅读此文章。

如果备份操作失败，它可能生成无效的备份文件。备份 blob 文件可能还有活动租约，以防止其被删除或覆盖。若要删除或覆盖这类 blob，应首先释放（中断）租约。如果备份失败，我们建议你清除租约并删除 blob。还可以定期清除租约并删除作为存储管理任务的一部分的 blob。

如果还原失败，将不阻止后续还原，因此活动租约不会导致问题。仅当必须覆盖或删除 blob 时，才有必要中断租约。

管理孤立的 blob

以下步骤说明在备份或还原活动失败后如何进行清除。可以使用 PowerShell 脚本来执行所有这些步骤。以下部分包括一个 PowerShell 脚本示例：

标识具有租约的 blob：如果你有运行备份过程的脚本或进程，可能可以捕获脚本或进程内的失败并使用它清除 blob。还可以使用 LeaseStats 和 LeastState 属性来标识具有租约的 blob。一旦标识了 blob，我们建议查看列表，在删除 blob 前验证备份文件的有效性。
中断租约：获得授权的请求可以中断租约而不提供租约 ID。有关详细信息，请参阅此处。

提示

SQL Server 发出租约 ID 以在还原操作期间建立独占访问。还原租约 ID 是 BAC2BAC2BAC2BAC2BAC2BAC2BAC2BAC2。
删除 Blob：要删除具有活动租约的 blob，必须首先中断租约。

PowerShell 脚本示例

重要

如果您正在运行 PowerShell 2.0，可能遇到加载 Microsoft WindowsAzure.Storage.dll 程序集的问题。我们建议升级 Powershell 以解决该问题。还可使用以下解决方法，以使用以下语句创建或修改 powershell.exe.config 文件以在运行时加载 .NET 2.0 和 .NET 4.0 程序集：

<?xml version="1.0"?>
    <configuration>
        <startup useLegacyV2RuntimeActivationPolicy="true">
            <supportedRuntime version="v4.0.30319"/>
            <supportedRuntime version="v2.0.50727"/>
        </startup>
    </configuration>

以下示例脚本标识具有活动租约的 blob，然后中断它们。该示例还演示如何为释放租约 ID 进行筛选。

有关运行此脚本的提示

警告

如果在运行此脚本的同时执行备份到 Azure Blob 存储，则备份可能失败，因为此脚本将中断备份操作在此时尝试获取的租约。在维护时段或没有正在执行或预计要运行的备份时运行此脚本。

在运行此脚本之前，应为存储帐户、存储密钥、容器和 Azure 存储程序集路径和名称参数添加值。存储程序集的路径为 SQL Server 实例的安装目录。存储程序集的文件名为 Microsoft.WindowsAzure.Storage.dll。
如果没有具有已锁定租约的 blob，你应看到以下消息：There are no blobs with locked lease status
如果有具有已锁定租约的 blob，你应看到以下消息：Breaking Leases、The lease on <URL of the Blob> is a restore lease: You will see this message only if you have a blob with a restore lease that is still active. 和 The lease on <URL of the Blob> is not a restore lease Breaking lease on <URL of the Bob>.

$storageAccount = "<myStorageAccount>"
$storageKey = "<myStorageKey>"
$blobContainer = "<myBlobContainer>"
$storageAssemblyPathName = "<myStorageAssemblyPathName>"
  
# well known Restore Lease ID  
$restoreLeaseId = "BAC2BAC2BAC2BAC2BAC2BAC2BAC2BAC2"  
  
# load the storage assembly without locking the file for the duration of the PowerShell session  
$bytes = [System.IO.File]::ReadAllBytes($storageAssemblyPath)  
[System.Reflection.Assembly]::Load($bytes)  
  
$cred = New-Object 'Microsoft.WindowsAzure.Storage.Auth.StorageCredentials' $storageAccount, $storageKey  
$client = New-Object 'Microsoft.WindowsAzure.Storage.Blob.CloudBlobClient' "https://$storageAccount.blob.core.windows.net", $cred  
$container = $client.GetContainerReference($blobContainer)  
  
# list all the blobs  
$blobs = $container.ListBlobs($null,$true)
  
# filter blobs that are have Lease Status as "locked"
$lockedBlobs = @()  
foreach($blob in $blobs)  
{  
    $blobProperties = $blob.Properties
    if($blobProperties.LeaseStatus -eq "Locked")  
    {  
        $lockedBlobs += $blob  
    }  
}  

if($lockedBlobs.Count -gt 0)  
{  
    Write-Host "Breaking leases..."
    foreach($blob in $lockedBlobs )
    {  
        try  
        {  
            $blob.AcquireLease($null, $restoreLeaseId, $null, $null, $null)  
            Write-Host "The lease on $($blob.Uri) is a restore lease."  
        }  
        catch [Microsoft.WindowsAzure.Storage.StorageException]  
        {  
            if($_.Exception.RequestInformation.HttpStatusCode -eq 409)  
            {  
                Write-Host "The lease on $($blob.Uri) is not a restore lease."  
            }  
        }  
  
        Write-Host "Breaking lease on $($blob.Uri)."  
        $blob.BreakLease($(New-TimeSpan), $null, $null, $null) | Out-Null  
    }  
} else { Write-Host " There are no blobs with locked lease status." }

通过

删除具有活动租约的备份 Blob 文件

管理孤立的 blob

PowerShell 脚本示例

有关运行此脚本的提示

另请参阅

反馈

其他资源