Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Amikor az Azure Blob Storage-ban adaterőforrásokat tartalmazó alkalmazásokat hoz létre, a kód elsősorban három erőforrástípussal dolgozik: tárfiókokkal, tárolókkal és blobokkal. Ez a cikk ismerteti ezeket az erőforrástípusokat, és bemutatja, hogyan kapcsolódnak egymáshoz. Azt is bemutatja, hogy az alkalmazáskód hogyan használja az Azure Blob Storage-ügyfélkódtárakat a különböző erőforrások kezeléséhez.
Blob Storage-erőforrástípusok
Az Azure Blob Storage-ügyfélkódtárak három típusú erőforrás használatát teszik lehetővé a tárolási szolgáltatásban:
Az alábbi ábra az erőforrások közötti kapcsolatot mutatja be:
Storage fiókok
A tárfiókok egyedi névteret biztosítanak az Azure-ban az adatokhoz. Az Azure Storage-ban tárolt összes objektum rendelkezik egy olyan címmel, amely tartalmazza az Ön egyedi fióknevét. A fióknév és a Blob Storage-végpont kombinációja képezi a tárfiók objektumainak alapcímét.
Ha például a tárfiók neve sampleaccount, akkor a Blob Storage alapértelmezett végpontja a következő:
https://sampleaccount.blob.core.windows.net
A tárfiókok típusaival kapcsolatos további információkért tekintse meg az Azure Storage-fiók áttekintését.
Tárolók
A tárolók blobokat rendszereznek, hasonlóan a fájlrendszer könyvtáraihoz. A tárfiókok korlátlan számú tárolót tartalmazhatnak, a tárolók pedig korlátlan számú blobot tárolhatnak.
A tároló URI-ja a következőhöz hasonló:
https://sampleaccount.blob.core.windows.net/sample-container
A tárolók elnevezéséről további információt a Tárolók, blobok és metaadatok elnevezése és hivatkozása című témakörben talál.
Blobok
Az Azure Storage három blobot támogat:
- Blokkblobok szöveg- és bináris adatok tárolására. A blokkblobok olyan adatblokkokból állnak, amelyek egyenként kezelhetők. A blokkblobok legfeljebb 190,7 TiB-ot tárolhatnak.
- Hozzáfűző blobok blokkokból, hasonlóan a blokkblobokhoz, állnak, de a hozzáfűzési műveletekhez vannak optimalizálva. A hozzáfűző blobok ideálisak olyan helyzetekhez, mint például a virtuális gépekről származó adatok naplózása.
- A lapblobok legfeljebb 8 TiB méretű véletlenszerű hozzáférési fájlokat tárolnak. További információ a lapblobokról: Az Azure-beli lapblobok áttekintése
A különböző blobtípusokról további információt a A blokkblobok, a hozzáfűző blobok és a lapblobokcímű témakörben talál.
A blob URI-ja a következőhöz hasonló:
https://sampleaccount.blob.core.windows.net/sample-container/sample-blob
További információ a blobok elnevezéséről: Tárolók, blobok és metaadatok elnevezése és hivatkozása.
Adaterőforrások használata az Azure SDK használatával
Az Azure SDK-k olyan kódtárakat tartalmaznak, amelyek az Azure REST API-ra épülnek, lehetővé téve a REST API-műveletek használatát ismerős programozási nyelvi paradigmákon keresztül. Az SDK-k célja az alkalmazás és az Azure-erőforrások közötti interakció egyszerűsítése.
Ritka esetekben az SDK legújabb bétaverziójára vagy általánosan elérhető verziójára frissített alkalmazások InvalidHeaderValue hibaüzenetet kaphatnak. Ez a probléma bármelyik Storage-kódtár használatakor jelentkezhet. A hibaüzenet az alábbi példához hasonlóan néz ki:
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>
Ha frissített a legújabb bétaverzióra vagy az SDK általánosan elérhető verziójára, és ezt a hibát tapasztalja, javasoljuk, hogy lépjen vissza az SDK korábbi általánosan elérhető verziójára, és ellenőrizze, hogy a probléma megoldódott-e.
Az SDK-specifikus részleteket a következő helyeken tekintheti meg:
Ha a probléma továbbra is fennáll, vagy ha a javaslat nem megvalósítható, nyisson meg egy támogatási jegyet a további lehetőségek megismeréséhez.
Az Azure Blob Storage-ügyfélkódtárakban minden erőforrástípust egy vagy több társított osztály jelöl. Ezek az osztályok műveleteket biztosítanak az Azure Storage-erőforrásokkal való munkához.
Az alábbi táblázat felsorolja az alaposztályokat, valamint egy rövid leírást:
| Osztály | Leírás |
|---|---|
| BlobServiceClient | A tárfiókot jelöli, és műveleteket biztosít a fióktulajdonságok lekéréséhez és konfigurálásához, valamint a tárfiók blobtárolóinak használatához. |
| BlobContainerClient | Egy adott blobtárolót jelöl, és műveleteket biztosít a tárolóval és a benne lévő blobokkal való munkához. |
| BlobClient | Egy adott blobot jelöl, és általános műveleteket biztosít a blob használatához, beleértve a feltöltési, letöltési, törlési és pillanatkép-létrehozási műveleteket is. |
| AppendBlobClient | Hozzáfűző blobot jelöl, és a hozzáfűző blobokhoz kapcsolódó műveleteket biztosít, például a naplóadatok hozzáfűzését. |
| BlockBlobClient | Blokkblobokat jelöl, és a blokkblobokra jellemző műveleteket biztosít, például az adatblokkok előkészítését és véglegesítését. |
A következő csomagok tartalmazzák a Blob Storage-adaterőforrások használatához használt osztályokat:
- Azure.Storage.Blobs: A szolgáltatáson, tárolókon és blobokon való működéshez használható elsődleges osztályokat (ügyfélobjektumokat) tartalmazza.
- Azure.Storage.Blobs.Specializált: Olyan osztályokat tartalmaz, amelyekkel egy blobtípusra, például blokkblobokra jellemző műveleteket hajthat végre.
- Azure.Storage.Blobs.Models: Minden más segédprogramosztály, struktúra és enumerálási típus.
Következő lépések
Az Azure-erőforrások SDK-val való használata egy ügyfélpéldány létrehozásával kezdődik. Az ügyfélobjektumok létrehozásával és kezelésével kapcsolatos további információkért tekintse meg az adaterőforrásokat kezelő ügyfélobjektumok létrehozását és kezelését ismertető témakört.