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
- Azure-előfizetés – hozzon létre egyet ingyenesen
- Azure Storage-fiók – tárfiók létrehozása
- Go 1.18+
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:
- Hitelesítés fejlesztési környezetekben
- Hitelesítés az Azure által üzemeltetett alkalmazásokban
- Hitelesítés szolgáltatásnévvel
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.