Поделиться через

Создание и перечисление версий BLOB-объектов в .NET

  • Статья

Версионирование BLOB-объектов автоматически создает предыдущую версию BLOB всякий раз, когда он изменяется или удаляется. Если управление версиями BLOB-объектов включено, можно восстановить более раннюю версию BLOB-объекта, чтобы восстановить ошибочно измененные или удаленные данные.

Для оптимальной защиты данных корпорация Майкрософт рекомендует включить как управление версиями BLOB-объектов, так и обратимое удаление BLOB-объектов для учетной записи хранения. Дополнительные сведения см. в разделе «Версионирование BLOB-объектов» и «Обратимое удаление для BLOB-объектов».

Изменение объекта Blob для инициирования новой версии

В следующем примере кода показано, как активировать создание новой версии с клиентской библиотекой службы хранилища Azure для .NET версии 12.5.1 или более поздней. Перед выполнением этого примера убедитесь, что вы включили управление версиями для учетной записи хранения.

В этом примере создается блочный BLOB, а затем обновляются его метаданные. Обновление метаданных BLOB вызывает создание новой версии. В примере извлекается исходная версия и текущая версия, и показано, что только текущая версия содержит метаданные.

public static async Task UpdateVersionedBlobMetadata(BlobContainerClient blobContainerClient, 
                                                     string blobName)
{
    try
    {
        // Create the container.
        await blobContainerClient.CreateIfNotExistsAsync();

        // Upload a block blob.
        BlockBlobClient blockBlobClient = blobContainerClient.GetBlockBlobClient(blobName);

        string blobContents = string.Format("Block blob created at {0}.", DateTime.Now);
        byte[] byteArray = Encoding.ASCII.GetBytes(blobContents);

        string initalVersionId;
        using (MemoryStream stream = new MemoryStream(byteArray))
        {
            Response<BlobContentInfo> uploadResponse = 
                await blockBlobClient.UploadAsync(stream, null, default);

            // Get the version ID for the current version.
            initalVersionId = uploadResponse.Value.VersionId;
        }

        // Update the blob's metadata to trigger the creation of a new version.
        Dictionary<string, string> metadata = new Dictionary<string, string>
        {
            { "key", "value" },
            { "key1", "value1" }
        };

        Response<BlobInfo> metadataResponse = 
            await blockBlobClient.SetMetadataAsync(metadata);

        // Get the version ID for the new current version.
        string newVersionId = metadataResponse.Value.VersionId;

        // Request metadata on the previous version.
        BlockBlobClient initalVersionBlob = blockBlobClient.WithVersion(initalVersionId);
        Response<BlobProperties> propertiesResponse = await initalVersionBlob.GetPropertiesAsync();
        PrintMetadata(propertiesResponse);

        // Request metadata on the current version.
        BlockBlobClient newVersionBlob = blockBlobClient.WithVersion(newVersionId);
        Response<BlobProperties> newPropertiesResponse = await newVersionBlob.GetPropertiesAsync();
        PrintMetadata(newPropertiesResponse);
    }
    catch (RequestFailedException e)
    {
        Console.WriteLine(e.Message);
        Console.ReadLine();
        throw;
    }
}

static void PrintMetadata(Response<BlobProperties> propertiesResponse)
{
    if (propertiesResponse.Value.Metadata.Count > 0)
    {
        Console.WriteLine("Metadata values for version {0}:", propertiesResponse.Value.VersionId);
        foreach (var item in propertiesResponse.Value.Metadata)
        {
            Console.WriteLine("Key:{0}  Value:{1}", item.Key, item.Value);
        }
    }
    else
    {
        Console.WriteLine("Version {0} has no metadata.", propertiesResponse.Value.VersionId);
    }
}

Вывод списка версий BLOB-объектов

Чтобы получить список версий BLOB-объектов, укажите параметр BlobStates с полем "Версия ". Версии перечислены от самых старых до самых новых.

В следующем примере кода показано, как получить список версий BLOB-объектов.

private static void ListBlobVersions(BlobContainerClient blobContainerClient, 
                                           string blobName)
{
    try
    {
        // Call the listing operation, specifying that blob versions are returned.
        // Use the blob name as the prefix. 
        var blobVersions = blobContainerClient.GetBlobs
            (BlobTraits.None, BlobStates.Version, prefix: blobName)
            .OrderByDescending(version => version.VersionId).Where(blob => blob.Name == blobName);

        // Construct the URI for each blob version.
        foreach (var version in blobVersions)
        {
            BlobUriBuilder blobUriBuilder = new BlobUriBuilder(blobContainerClient.Uri)
            {
                BlobName = version.Name,
                VersionId = version.VersionId
            };

            if ((bool)version.IsLatestVersion.GetValueOrDefault())
            {
                Console.WriteLine("Current version: {0}", blobUriBuilder);
            }
            else
            {
                Console.WriteLine("Previous version: {0}", blobUriBuilder);
            }
        }
    }
    catch (RequestFailedException e)
    {
        Console.WriteLine(e.Message);
        Console.ReadLine();
        throw;
    }
}

Скопируйте предыдущую версию BLOB поверх базовой версии BLOB

Вы можете выполнить операцию копирования, чтобы продвигать версию по сравнению с базовым блобом, если базовый блоб находится на онлайн уровне (горячий или холодный). Версия остается, но ее место назначения перезаписывается копией, из которой можно считывать и в которую можно записывать.

В следующем примере кода показано, как скопировать версию блоба над базовым блобом.

public static async Task<BlockBlobClient> CopyVersionOverBaseBlobAsync(
    BlockBlobClient client,
    string versionTimestamp)
{
    // Instantiate BlobClient with identical URI and add version timestamp
    BlockBlobClient versionClient = client.WithVersion(versionTimestamp);

    // Restore the specified version by copying it over the base blob
    await client.SyncUploadFromUriAsync(versionClient.Uri);

    // Return the client object after the copy operation
    return client;
}

Ресурсы

Дополнительные сведения об управлении версиями BLOB-объектов с помощью клиентской библиотеки хранилища BLOB-объектов Azure для .NET см. в следующих ресурсах.

Ресурсы клиентской библиотеки

См. также