Delen via

Meer informatie over hoe apps communiceren met Blob Storage-gegevensbronnen

Wanneer u toepassingen bouwt om te werken met gegevensresources in Azure Blob Storage, communiceert uw code voornamelijk met drie resourcetypen: opslagaccounts, containers en blobs. In dit artikel worden deze resourcetypen uitgelegd en wordt uitgelegd hoe deze zich verhouden tot elkaar. Het laat ook zien hoe toepassingscode gebruikmaakt van de Azure Blob Storage-clientbibliotheken om met deze verschillende resources te communiceren.

Blob Storage-resourcetypen

Met de Azure Blob Storage-clientbibliotheken kunt u communiceren met drie typen resources in de opslagservice:

In het volgende diagram ziet u de relatie tussen deze resources:

Diagram met de relatie tussen een opslagaccount, containers en blobs

Opslagrekeningen

Een opslagaccount biedt een unieke naamruimte in Azure voor uw gegevens. Elk object dat u in Azure Storage opslaat, heeft een adres dat uw unieke accountnaam bevat. De combinatie van de accountnaam en het Blob Storage-eindpunt vormt het basisadres voor de objecten in uw opslagaccount.

Als uw opslagaccount bijvoorbeeld de naam sampleaccount heeft, is het standaardeindpunt voor Blob Storage:

https://sampleaccount.blob.core.windows.net

Zie het overzicht van het Azure-opslagaccount voor meer informatie over typen opslagaccounts.

Verpakkingen

Een container kan een of meer blobs bevatten, net zoals een map een of meer bestanden kan bevatten in een bestandssysteem. Een opslagaccount kan een onbeperkt aantal containers bevatten en een container kan een onbeperkt aantal blobs bevatten.

De URI voor een container is vergelijkbaar met:

https://sampleaccount.blob.core.windows.net/sample-container

Zie Containers, Blobs en metagegevens een naam geven en hiernaar verwijzen voor meer informatie over het benoemen van containers.

Blobsen

Azure Storage ondersteunt drie typen blobs:

  • Block blobs slaan tekst en binaire gegevens op. Blok-blobs bestaan uit blokken gegevens die afzonderlijk kunnen worden beheerd. Blok-blobs kunnen maximaal 190,7 TiB opslaan.
  • Append-blobs bestaan uit blokken, vergelijkbaar met blok-blobs, maar zijn geoptimaliseerd voor toevoeg-bewerkingen. Toevoeg-blobs zijn ideaal voor scenario's zoals het registreren van logboekgegevens van virtuele machines.
  • Met pagina-blobs worden bestanden met willekeurige toegang tot maximaal 8 TiB opgeslagen. Zie Overzicht van Azure-pagina-blobs voor meer informatie over pagina-blobs

Voor meer informatie over de verschillende typen blobs, zie Informatie over blok-blobs, toevoeg-blobs en pagina-blobs.

De URI voor een blob is vergelijkbaar met:

https://sampleaccount.blob.core.windows.net/sample-container/sample-blob

Zie Naamgeving en verwijzingen naar containers, blobs en metagegevens voor meer informatie over het benoemen van blobs.

Werken met gegevensbronnen met behulp van de Azure SDK

De Azure SDK's bevatten bibliotheken die zijn gebaseerd op de Azure REST API, zodat u kunt communiceren met REST API-bewerkingen via bekende programmeertaalparadigma's. De SDK's zijn ontworpen om interacties tussen uw toepassing en Azure-resources te vereenvoudigen.

In zeldzame scenario's kunnen toepassingen die een upgrade hebben uitgevoerd naar de nieuwste bètaversie of algemeen beschikbare versie van de SDK, een InvalidHeaderValue foutbericht ontvangen. Dit probleem kan optreden bij het gebruik van een van de Opslagbibliotheken. Het foutbericht ziet er ongeveer als volgt uit:

HTTP/1.1 400 The value for one of the HTTP headers is not in the correct format.
Content-Length: 328
Content-Type: application/xml
Server: Microsoft-HTTPAPI/2.0
x-ms-request-id: <REMOVED>
Date: Fri, 19 May 2023 17:10:33 GMT
 
<?xml version="1.0" encoding="utf-8"?>
<Error>
<Code>InvalidHeaderValue</Code>
<Message>
The value for one of the HTTP headers is not in the correct format.
RequestId:<REMOVED>
Time:2023-05-19T17:10:34.2972651Z
</Message>
<HeaderName>x-ms-version</HeaderName><HeaderValue>yyyy-mm-dd</HeaderValue>
</Error>

Als u een upgrade hebt uitgevoerd naar de nieuwste bètaversie of algemeen beschikbare versie van de SDK en deze fout ondervindt, is het raadzaam om een downgrade uit te stellen naar de vorige algemeen beschikbare versie van de SDK om te zien of het probleem is opgelost.

U kunt sdk-specifieke details weergeven op de volgende locaties:

Als het probleem zich blijft voordoen of als de aanbeveling niet haalbaar is, een ondersteuningsticket openen om meer opties te verkennen.

In de Azure Blob Storage-clientbibliotheken wordt elk resourcetype vertegenwoordigd door een of meer gekoppelde klassen. Deze klassen bieden bewerkingen voor het werken met een Azure Storage-resource.

De volgende tabel bevat de basisklassen, samen met een korte beschrijving:

Klasse Beschrijving
BlobServiceClient Vertegenwoordigt het opslagaccount en biedt bewerkingen voor het ophalen en configureren van accounteigenschappen en voor het werken met blobcontainers in het opslagaccount.
BlobContainerClient Vertegenwoordigt een specifieke blobcontainer en biedt bewerkingen om met de container en de blobs binnen te werken.
BlobClient Vertegenwoordigt een specifieke blob en biedt algemene bewerkingen om te werken met de blob, inclusief bewerkingen voor het uploaden, downloaden, verwijderen en maken van momentopnamen.
AppendBlobClient Vertegenwoordigt een toevoeg-blob en biedt bewerkingen die specifiek zijn voor toevoeg-blobs, zoals het toevoegen van logboekgegevens.
BlockBlobClient Vertegenwoordigt een blok-blob en biedt bewerkingen die specifiek zijn voor blok-blobs, zoals fasering en vervolgens het doorvoeren van gegevensblokken.

De volgende pakketten bevatten de klassen die worden gebruikt voor het werken met Blob Storage-gegevensbronnen:

  • Azure.Storage.Blobs: bevat de primaire klassen (clientobjecten) die u kunt gebruiken om te werken op de service, containers en blobs.
  • Azure.Storage.Blobs.Specialized: bevat klassen die u kunt gebruiken om bewerkingen uit te voeren die specifiek zijn voor een blobtype, zoals blok-blobs.
  • Azure.Storage.Blobs.Models: Alle andere hulpprogrammaklassen, structuren en opsommingstypen.

Volgende stappen

Het werken met Azure-resources met behulp van de SDK begint met het maken van een clientexemplaren. Zie Clientobjecten maken en beheren die interactie hebben met gegevensbronnen voor meer informatie over het maken en beheren van clientobjecten.