Začínáme se službou Azure Blob Storage a Go
V tomto článku se dozvíte, jak se připojit ke službě Azure Blob Storage pomocí klientského modulu Azure Blob Storage pro Go. Po připojení se pomocí příruček pro vývojáře dozvíte, jak váš kód funguje s kontejnery, objekty blob a funkcemi služby Blob Storage.
Pokud chcete začít s úplným příkladem, podívejte se na rychlý start: Klientská knihovna Azure Blob Storage pro Go.
Referenční dokumentace k | rozhraní API – Balíček zdrojového kódu | knihovny (pkg.go.dev)
Požadavky
- Předplatné Azure – vytvoření bezplatného předplatného
- Účet úložiště Azure – Vytvoření účtu úložiště
- Go 1.18+
Nastavení projektu
Tato část vás provede přípravou projektu pro práci s modulem klienta Azure Blob Storage pro Go.
Z GOPATH nainstalujte modul azblob pomocí následujícího příkazu:
go get github.com/Azure/azure-sdk-for-go/sdk/storage/azblob
Pokud se chcete ověřit pomocí Microsoft Entra ID (doporučeno), nainstalujte azidentity
modul pomocí následujícího příkazu:
go get github.com/Azure/azure-sdk-for-go/sdk/azidentity
Pak otevřete soubor kódu a přidejte potřebné cesty k importu. V tomto příkladu přidáme do souboru .go následující:
import (
"github.com/Azure/azure-sdk-for-go/sdk/storage/azblob"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
)
Informace o modulu klienta objektů blob:
- azblob: Obsahuje metody, které můžete použít k provozu se službou, kontejnery a objekty blob.
Autorizace přístupu a připojení ke službě Blob Storage
Pokud chcete připojit aplikaci ke službě Blob Storage, vytvořte objekt klienta pomocí příkazu azblob. NewClient. Tento objekt je vaším výchozím bodem pro interakci s datovými prostředky na úrovni účtu úložiště. Můžete ho použít k provozu s účtem úložiště a jeho kontejnery.
Další informace o vytváření a správě klientských objektů, včetně osvědčených postupů, najdete v tématu Vytváření a správa klientských objektů, které pracují s datovými prostředky.
Klientský objekt můžete autorizovat pomocí autorizačního tokenu Microsoft Entra (doporučeno), přístupového klíče účtu nebo sdíleného přístupového podpisu (SAS).
Pokud chcete autorizovat s ID Microsoft Entra, musíte použít instanční objekt zabezpečení. Následující články obsahují pokyny k různým scénářům ověřování:
- Ověřování ve vývojových prostředích
- Ověřování v aplikacích hostovaných v Azure
- Ověřování pomocí instančního objektu
Autorizace přístupu pomocí DefaultAzureCredential
Snadným a bezpečným způsobem autorizace přístupu a připojení ke službě Blob Storage je získání tokenu OAuth vytvořením instance DefaultAzureCredential . Tyto přihlašovací údaje pak můžete použít k vytvoření objektu klienta pomocí příkazu azblob. 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
}
Sestavte aplikaci
Při vytváření aplikací pro práci s datovými prostředky ve službě Azure Blob Storage váš kód primárně komunikuje se třemi typy prostředků: účty úložiště, kontejnery a objekty blob. Další informace otěchtoch materiálech najdete v tématu Vysvětlení způsobu interakce aplikací s datovými prostředky blob Storage.
Následující příručky ukazují, jak získat přístup k datům a provádět konkrétní akce pomocí klientského modulu Azure Blob Storage pro Go:
Průvodce | Popis |
---|---|
Konfigurace zásad opakování | Implementujte zásady opakování pro klientské operace. |
Kopírování objektů blob | Zkopírujte objekt blob z jednoho umístění do druhého. |
Vytvoření kontejneru | Vytvořte kontejnery. |
Odstranění a obnovení objektů blob | Odstraňte objekty blob a pokud je povolené obnovitelné odstranění, obnovte odstraněné objekty blob. |
Odstranění a obnovení kontejnerů | Odstraňte kontejnery a pokud je povolené obnovitelné odstranění, obnovte odstraněné kontejnery. |
Stažení objektů blob | Stáhněte objekty blob pomocí řetězců, datových proudů a cest k souborům. |
Vyhledání objektů blob pomocí značek | Nastavte a načtěte značky a použijte značky k vyhledání objektů blob. |
Výpis objektů blob | Výpis objektů blob různými způsoby |
Výpis kontejnerů | Vypište kontejnery v účtu a různé možnosti, které můžete přizpůsobit výpis. |
Správa vlastností a metadat (objektů blob) | Správa vlastností a metadat kontejneru |
Správa vlastností a metadat (kontejnerů) | Správa vlastností a metadat kontejneru |
Nahrání objektů blob | Naučte se nahrávat objekty blob pomocí řetězců, datových proudů, cest k souborům a dalších metod. |
Poznámka:
Ukázky kódu v této příručce vám pomůžou začít se službou Azure Blob Storage a Go. Měli byste upravit zpracování chyb a Context
hodnoty tak, aby vyhovovaly potřebám vaší aplikace.