Freigeben über


Azure.Storage.Blobs.Specialized Namespace

Klassen

AppendBlobClient

Mit AppendBlobClient können Sie Azure Storage-Anfügeblobs bearbeiten.

Ein Anfügeblob besteht aus Blöcken und ist für Anfügevorgänge optimiert. Wenn Sie ein Anfügeblob ändern, werden Blöcke nur am Ende des Blobs über den Azure.Storage.Blobs.Specialized.AppendBlobClient.AppendBlockAsync(System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.AppendBlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) -Vorgang hinzugefügt. Das Aktualisieren oder Löschen vorhandener Blöcke wird nicht unterstützt. Im Gegensatz zu einem Blockblob macht ein Anfügeblob seine Block-IDs nicht verfügbar.

Jeder Block in einem Anfügeblob kann eine andere Größe aufweisen. Ab x-ms-version 2022-11-02 beträgt die maximale Anfügegröße 100 MB. Bei früheren Versionen beträgt die maximale Anfügegröße 4 MB. Anfügeblobs können bis zu 50.000 Blöcke enthalten.

BlobBaseClient

Mit dem BlobBaseClient können Sie Azure Storage-Blobs bearbeiten

BlobBatch

Ein BlobBatch ermöglicht das Batchen mehrerer Azure Storage-Vorgänge in einer einzelnen Anforderung über SubmitBatch(BlobBatch, Boolean, CancellationToken).

Weitere Informationen finden Sie unter Blobbatch.

BlobBatchClient

BlobBatchClient Mit können Sie mehrere Azure Storage-Vorgänge in einer einzelnen Anforderung batchen.

BlobLeaseClient

BlobLeaseClient Mit können Sie Azure Storage-Leases für Container und Blobs bearbeiten.

BlockBlobClient

Mit BlockBlobClient können Sie Azure Storage-Blockblobs bearbeiten.

Mit Block-BLOBs können Sie große BLOBs effizient hochladen. Block-BLOBs bestehen aus Blöcken, von denen jeder durch eine Block-ID identifiziert wird. Sie erstellen oder ändern ein Block-BLOB, indem Sie bestimmte Blöcke schreiben und anhand der Block-IDs einen Commit ausführen. Jeder Block kann eine andere Größe aufweisen, bis zu einem Maximum von 4.000 MB (100 MB für Anforderungen mit REST-Versionen vor dem 12.12.2019 und 4 MB für Anforderungen mit REST-Versionen vor 2016-05-31), und ein Blockblob kann bis zu 50.000 Blöcke enthalten. Die maximale Größe eines Blockblobs beträgt daher ca. 190,73 TiB (4.000 MB x 50.000 Blöcke). Wenn Sie ein Blockblob schreiben, das nicht mehr als 5.000 MB groß ist, können Sie es vollständig mit einem einzelnen Schreibvorgang hochladen. Siehe UploadAsync(Stream, BlobUploadOptions, CancellationToken).

Wenn Sie einen Block in ein BLOB in Ihrem Speicherkonto hochladen, wird er dem angegebenen Block-BLOB zugeordnet. Der Block wird aber erst dann Teil des BLOB, wenn Sie für eine Liste von Blöcken, die die ID des neuen Blocks enthält, einen Commit ausführen. Neue Blöcke verbleiben ohne Commit, bis explizit ein Commit ausgeführt wird oder die Blöcke verworfen werden. Durch das Schreiben eines Blocks wird die Uhrzeit der letzten Änderung eines vorhandenen BLOB nicht aktualisiert.

Block-BLOBs stellen Funktionen bereit, die Ihnen bei der Verwaltung großer Dateien im Netzwerk helfen. Mit einem Block-BLOB können Sie mehrere Blöcke parallel hochladen, um die Uploadzeit zu verkürzen. Jeder Block kann einen MD5-Hash enthalten, um die Übertragung zu überprüfen, sodass Sie den Uploadfortschritt nachverfolgen und Blöcke nach Bedarf erneut senden können. Sie können Blöcke in beliebiger Reihenfolge hochladen und deren Reihenfolge im letzten Blocklisten-Verpflichtungsschritt bestimmen. Sie können auch einen neuen Block hochladen, um einen vorhandenen Block mit derselben Block-ID zu ersetzen, wenn für den Block noch kein Commit ausgeführt wurde. Sie haben eine Woche Zeit, den Commit für Blöcke in einem BLOB auszuführen, bevor die Blöcke verworfen werden. Zudem werden alle Blöcke ohne Commit auch dann verworfen, wenn ein Commit ausgeführt wird und die Blöcke nicht in der Blockliste des Commitvorgangs enthalten sind.

Sie können ein vorhandenes Block-BLOB ändern, indem Sie Blöcke einfügen oder ersetzen oder vorhandene Blöcke löschen. Nachdem Sie den oder die Blöcke hochgeladen haben, die sich geändert haben, bestätigen Sie die neue Version des BLOB, indem Sie in einem einzelnen Commitvorgang einen Commit für die neuen und für alle vorhandenen Blöcke ausführen, die erhalten bleiben sollen. Um denselben Bytebereich an zwei verschiedenen Speicherorten des committeten Blobs einzufügen, können Sie denselben Block an zwei Stellen innerhalb desselben Commitvorgangs committen. Wenn bei jedem Commitvorgang kein Block gefunden wird, schlägt der gesamte Verpflichtungsvorgang mit einem Fehler fehl, und das Blob wird nicht geändert. Jeder Commit für einen Block überschreibt die vorhandenen Eigenschaften und Metadaten des BLOB und verwirft alle Blöcke, für die kein Commit ausgeführt wurde.

Block-IDs sind Zeichenfolgen derselben Länge innerhalb eines BLOB. Block-Clientcode verwendet üblicherweise die Base-64-Codierung, um eine normalisierte Version der Zeichenfolgen mit gleicher Länge zu erstellen. Bei Verwendung der Base-64-Codierung darf die Ausgangszeichenfolge nicht länger sein als 64 Bytes. In unterschiedlichen BLOBs können dieselben Block-IDs verwendet werden. Ein Blob kann bis zu 100.000 Blöcke ohne Commit mit einer maximalen Gesamtgröße von ca. 381,46 TiB (4.000 MB x 100.000 Blöcke) enthalten.

Wenn Sie einen Block für ein BLOB schreiben, das noch nicht vorhanden ist, wird ein neues Block-BLOB mit der Größe 0 Bytes erstellt. Dieses BLOB wird in BLOB-Listen aufgeführt, die BLOBs ohne Commit enthalten. Wenn Sie für dieses BLOB keinen Block-Commit ausführen, werden das BLOB und alle ggf. vorhandenen Blöcke ohne Commit eine Woche nach dem letzten erfolgreichen Hochladen eines Blocks verworfen. Alle nicht committeten Blöcke werden auch verworfen, wenn ein neues Blob mit demselben Namen mithilfe eines einzelnen Schritts (anstelle des zweistufigen Blockupload-then-commit-Prozesses) erstellt wird.

PageBlobClient

Mit PageBlobClient können Sie Azure Storage-Seitenblobs bearbeiten.

Seitenblobs stellen eine Sammlung von 512-Byte-Seiten dar, die für zufällige Lese- und Schreibvorgänge optimiert sind. Um ein Seiten-BLOB zu erstellen, initialisieren Sie zunächst das Seiten-BLOB und geben hierbei die maximale Größe an, die für das Seiten-BLOB verfügbar sein soll. Um den Inhalt eines Seiten-BLOB zu erweitern oder zu aktualisieren, schreiben Sie unter Angabe eines Offsets und eines Bereichs, die an den Seitengrenzen von jeweils 512 Bytes ausgerichtet sind, eine oder mehrere Seiten in das BLOB. Ein Schreibvorgang für ein Seiten-BLOB kann nur eine Seite, mehrere Seiten oder bis zu 4 MB des Seiten-BLOB überschreiben. Schreibvorgänge für ein Seiten-BLOB erfolgen direkt im BLOB und erfordern keinen zusätzlichen Commitvorgang. Die maximale Größe für ein Seitenblob beträgt 8 TB.

SpecializedBlobClientOptions

Stellt erweiterte Clientkonfigurationsoptionen zum Herstellen einer Verbindung mit Azure Blob Storage bereit.

SpecializedBlobExtensions

Fügen Sie einfach zu ermittelnde Methoden hinzu, um BlobContainerClient Instanzen zu erstellen AppendBlobClient .