Megosztás a következőn keresztül:


Az Azure Blob Storage és a Go használatának első lépései

Ez a cikk bemutatja, hogyan csatlakozhat az Azure Blob Storage-hoz a Go Azure Blob Storage ügyfélmoduljának használatával. A csatlakozás után a fejlesztői útmutatók segítségével megtudhatja, hogyan működhet a kód a Blob Storage szolgáltatás tárolóin, blobokon és funkcióin.

Ha egy teljes példával szeretne kezdeni, tekintse meg a Go-hoz készült Azure Blob Storage ügyfélkódtár rövid útmutatóját.

API-referenciadokumentáció Kódtár forráskódcsomagja | (pkg.go.dev) |

Előfeltételek

A projekt beállítása

Ez a szakasz végigvezeti egy projekt előkészítésén a Go-hoz készült Azure Blob Storage-ügyfélmodullal való együttműködéshez.

A GOPATH-ból telepítse az azblob modult a következő paranccsal:

go get github.com/Azure/azure-sdk-for-go/sdk/storage/azblob

A Microsoft Entra-azonosítóval való hitelesítéshez (ajánlott) telepítse a azidentity modult a következő paranccsal:

go get github.com/Azure/azure-sdk-for-go/sdk/azidentity

Ezután nyissa meg a kódfájlt, és adja hozzá a szükséges importálási útvonalakat. Ebben a példában a következőket adjuk hozzá a .go fájlhoz:

import (
    "github.com/Azure/azure-sdk-for-go/sdk/storage/azblob"
    "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
)

A Blob-ügyfélmodul adatai:

  • azblob: A szolgáltatáson, tárolókon és blobokon való működéshez használható módszereket tartalmazza.

Hozzáférés engedélyezése és csatlakozás a Blob Storage-hoz

Ha egy alkalmazást a Blob Storage-hoz szeretne csatlakoztatni, hozzon létre egy ügyfélobjektumot az azblob használatával . NewClient. Ez az objektum a kiindulási pont az adaterőforrások tárfiók szintjén való használatához. Használhatja a tárfiókon és annak tárolóin való működéshez.

Ha többet szeretne megtudni az ügyfélobjektumok létrehozásáról és kezeléséről, beleértve az ajánlott eljárásokat, olvassa el az adaterőforrásokat kezelő ügyfélobjektumok létrehozását és kezelését ismertető témakört.

Az ügyfélobjektumokat a Microsoft Entra engedélyezési jogkivonat (ajánlott), a fiókhozzáférési kulcs vagy a közös hozzáférésű jogosultságkód (SAS) használatával engedélyezheti.

A Microsoft Entra-azonosítóval való engedélyezéshez biztonsági tagot kell használnia. A következő cikkek útmutatást nyújtanak a különböző hitelesítési forgatókönyvekhez:

Hozzáférés engedélyezése a DefaultAzureCredential használatával

A Blob Storage-hoz való hozzáférés és csatlakozás engedélyezésének egyszerű és biztonságos módja egy OAuth-jogkivonat beszerzése DefaultAzureCredential-példány létrehozásával. Ezután a hitelesítő adatok használatával létrehozhatja az ügyfélobjektumot az azblob használatával . NewClient.

func getServiceClientTokenCredential(accountURL string) *azblob.Client {
    // Create a new service client with token credential
    credential, err := azidentity.NewDefaultAzureCredential(nil)
    handleError(err)

    client, err := azblob.NewClient(accountURL, credential, nil)
    handleError(err)

    return client
}

Az alkalmazás fordítása

Amikor az Azure Blob Storage-ban adaterőforrásokkal való együttműködésre hoz létre alkalmazásokat, a kód elsősorban három erőforrástípussal dolgozik: tárfiókokkal, tárolókkal és blobokkal. Ha többet szeretne megtudni ezekről az erőforrástípusokról, az egymáshoz való viszonyukról és az alkalmazások erőforrásokkal való interakciójáról, olvassa el a Blob Storage-adaterőforrásokkal való interakciót ismertető témakört.

Az alábbi útmutatók bemutatják, hogyan férhet hozzá az adatokhoz, és hogyan hajthat végre konkrét műveleteket a Go-hoz készült Azure Blob Storage-ügyfélmodul használatával:

Útmutató Leírás
Újrapróbálkozési szabályzat konfigurálása Újrapróbálkozási szabályzatok implementálása az ügyfélműveletekhez.
Blobok másolása Blob másolása egyik helyről a másikra.
Tároló létrehozása Tárolók létrehozása.
Blobok törlése és visszaállítása Blobok törlése, és ha engedélyezve van a helyreállítható törlés, állítsa vissza a törölt blobokat.
Tárolók törlése és visszaállítása Tárolók törlése, és ha engedélyezve van a helyreállítható törlés, állítsa vissza a törölt tárolókat.
Blobok letöltése Töltse le a blobokat sztringek, streamek és fájlelérési utak használatával.
Blobok keresése címkékkel Címkék beállítása és lekérése, valamint címkék használata a blobok kereséséhez.
Blobok listázása Blobok listázása különböző módokon.
Tárolók listázása Egy fiók tárolóinak listázása és a lista testreszabásához elérhető különféle lehetőségek.
Tulajdonságok és metaadatok (blobok) kezelése Tárolótulajdonságok és metaadatok kezelése.
Tulajdonságok és metaadatok (tárolók) kezelése Tárolótulajdonságok és metaadatok kezelése.
Blobok feltöltése Megtudhatja, hogyan tölthet fel blobokat sztringek, streamek, fájlelérési utak és egyéb módszerek használatával.

Feljegyzés

Az útmutatóban szereplő kódminták az Azure Blob Storage és a Go használatának megkezdéséhez nyújtanak segítséget. Az alkalmazás igényeinek megfelelően módosítania kell a hibakezelést és Context az értékeket.