Aracılığıyla paylaş


Azure Blob Depolama ve Go ile çalışmaya başlama

Bu makalede Go için Azure Blob Depolama istemci modülünü kullanarak Azure Blob Depolama nasıl bağlanabileceğiniz gösterilmektedir. Bağlandıktan sonra kodunuz Blob Depolama hizmetinin kapsayıcıları, blobları ve özellikleri üzerinde çalışabilir.

API başvuru belgeleri | Kitaplık kaynak kodu | Paketi (pkg.go.dev)

Önkoşullar

Projenizi ayarlama

Bu bölümde Go için Azure Blob Depolama istemci modülüyle çalışmak üzere bir proje hazırlama işleminde size yol gösterir.

GOPATH'inizden aşağıdaki komutu kullanarak azblob modülünü yükleyin:

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

Microsoft Entra Id ile kimlik doğrulaması yapmak için (önerilen), aşağıdaki komutu kullanarak modülü yükleyin azidentity :

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

Ardından kod dosyanızı açın ve gerekli içeri aktarma yollarını ekleyin. Bu örnekte, .go dosyamıza aşağıdakileri ekleyeceğiz:

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

Blob istemci modülü bilgileri:

  • azblob: Hizmet, kapsayıcılar ve bloblar üzerinde çalışmak için kullanabileceğiniz yöntemleri içerir.

Erişimi yetkilendirme ve Blob Depolama'ya bağlanma

Bir uygulamayı Blob Depolama'ya bağlamak için azblob kullanarak bir istemci nesnesi oluşturun. NewClient. Bu nesne, depolama hesabı düzeyinde veri kaynaklarıyla etkileşim kurmak için başlangıç noktanızdır. Depolama hesabında ve kapsayıcılarında çalışmak için bunu kullanabilirsiniz.

en iyi yöntemler de dahil olmak üzere istemci nesneleri oluşturma ve yönetme hakkında daha fazla bilgi edinmek için bkz . Veri kaynaklarıyla etkileşim kuran istemci nesneleri oluşturma ve yönetme.

Microsoft Entra yetkilendirme belirteci (önerilen), hesap erişim anahtarı veya paylaşılan erişim imzası (SAS) kullanarak bir istemci nesnesini yetkilendikleyebilirsiniz.

Microsoft Entra Id ile yetkilendirmek için bir güvenlik sorumlusu kullanmanız gerekir. Aşağıdaki makaleler farklı kimlik doğrulama senaryoları hakkında rehberlik sağlar:

DefaultAzureCredential kullanarak erişimi yetkilendirme

Erişimi yetkilendirmenin ve Blob Depolama'ya bağlanmanın kolay ve güvenli bir yolu, DefaultAzureCredential örneği oluşturarak bir OAuth belirteci almaktır. Ardından bu kimlik bilgilerini kullanarak azblob kullanarak istemci nesnesi oluşturabilirsiniz. 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
}

Uygulamanızı derleme

Azure Blob Depolama'daki veri kaynaklarıyla çalışacak uygulamalar oluştururken kodunuz öncelikli olarak üç kaynak türüyle etkileşim kurar: depolama hesapları, kapsayıcılar ve bloblar. Bu kaynak türleri, birbirleriyle ilişkileri ve uygulamaların kaynaklarla nasıl etkileşim kurduğu hakkında daha fazla bilgi edinmek için bkz . Uygulamaların Blob Depolama veri kaynaklarıyla nasıl etkileşim kuracaklarını anlama.

Aşağıdaki kılavuzlarda Go için Azure Blob Depolama istemci modülünü kullanarak veri kaynaklarıyla çalışma ve belirli eylemleri gerçekleştirme adımları gösterilmektedir:

Kılavuz Açıklama
Kapsayıcı oluşturma Kapsayıcılar oluşturun.
Kapsayıcıları silme ve geri yükleme Kapsayıcıları silin ve geçici silme etkinleştirildiyse silinen kapsayıcıları geri yükleyin.
Kapsayıcıları listeleme Bir hesaptaki kapsayıcıları ve listeyi özelleştirmek için kullanılabilecek çeşitli seçenekleri listeleyin.
Özellikleri ve meta verileri (kapsayıcılar) yönetme Kapsayıcı özelliklerini ve meta verilerini yönetme.
Blobları karşıya yükleme Dizeleri, akışları, dosya yollarını ve diğer yöntemleri kullanarak blobları karşıya yüklemeyi öğrenin.
Blobları indirme Dizeleri, akışları ve dosya yollarını kullanarak blobları indirin.
Blobları listeleme Blobları farklı şekillerde listeleyin.
Blobları silme ve geri yükleme Blobları silin ve geçici silme etkinleştirildiyse silinen blobları geri yükleyin.
Etiketleri kullanarak blobları bulma Etiketleri ayarlayıp alın ve blobları bulmak için etiketleri kullanın.
Özellikleri ve meta verileri (bloblar) yönetme Kapsayıcı özelliklerini ve meta verilerini yönetme.

Not

Bu kılavuzdaki kod örnekleri, Azure Blob Depolama ve Go ile çalışmaya başlamanıza yardımcı olmak için tasarlanmıştır. Hata işlemeyi ve Context değerleri uygulamanızın gereksinimlerini karşılayacak şekilde değiştirmeniz gerekir.