Introduzione ad Archiviazione BLOB di Azure e Go

Articolo
08/05/2024

Questo articolo illustra come connettersi ad Archiviazione BLOB di Azure usando il modulo client di Archiviazione BLOB di Azure per Go. Dopo la connessione, il codice può operare su contenitori, BLOB e funzionalità del servizio di archiviazione BLOB.

Documentazione di riferimento sull'API | Codice sorgente della libreria | Pacchetto (pkg.go.dev)

Prerequisiti

Sottoscrizione di Azure: creare un account gratuito
Account di archiviazione di Azure: creare un account di archiviazione
Go 1.18+

Impostare il progetto

Questa sezione illustra come preparare un progetto da usare con il modulo client di Archiviazione BLOB di Azure per Go.

Da GOPATH installare il modulo azblob usando il comando seguente:

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

Per eseguire l'autenticazione con Microsoft Entra ID (scelta consigliata), installare il modulo azidentity usando il comando seguente:

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

Aprire quindi il file di codice e aggiungere i percorsi di importazione necessari. In questo esempio si aggiunge il codice seguente al file .go:

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

Informazioni sul modulo client BLOB:

azblob: contiene i metodi che è possibile usare per operare sul servizio, sui contenitori e sui BLOB.

Autorizzare l'accesso e connettersi ad Archiviazione BLOB

Per connettere un'app all'archiviazione BLOB, creare un oggetto client usando azblob. NewClient. Questo oggetto è il punto di partenza per interagire con le risorse dati a livello di account di archiviazione. È possibile usarlo per operare sull'account di archiviazione e sui relativi contenitori.

Per altre informazioni sulla creazione e la gestione di oggetti client, incluse le procedure consigliate, vedere Creare e gestire oggetti client che interagiscono con le risorse dati.

È possibile autorizzare un oggetto client usando un token di autorizzazione di Microsoft Entra (scelta consigliata), una chiave di accesso all'account o una firma di accesso condiviso.

Per autorizzare con Microsoft Entra ID è necessario usare un'entità di sicurezza. Gli articoli seguenti forniscono indicazioni su diversi scenari di autenticazione:

Autorizzare l'accesso con DefaultAzureCredential

Un modo semplice e sicuro per autorizzare l'accesso e connettersi ad Archiviazione BLOB consiste nell'ottenere un token OAuth creando un'istanza di DefaultAzureCredential. È quindi possibile usare tale credenziale per creare l'oggetto client usando 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
}

Per usare un token di firma di accesso condiviso (SAS), aggiungere il token alla stringa dell'URL dell'account e creare l'oggetto client usando azblob. NewClientWithNoCredential.

func getServiceClientSAS(accountURL string, sasToken string) *azblob.Client {
    // Create a new service client with an existing SAS token

    // Append the SAS to the account URL with a "?" delimiter
    accountURLWithSAS := fmt.Sprintf("%s?%s", accountURL, sasToken)

    client, err := azblob.NewClientWithNoCredential(accountURLWithSAS, nil)
    handleError(err)

    return client
}

Nota

Per gli scenari in cui vengono utilizzate le firme di accesso condiviso (SAS), Microsoft consiglia di usare una firma di accesso condiviso di delega utente. Una firma di accesso condiviso della delega utente è protetta con le credenziali di Microsoft Entra, anziché dalla chiave dell'account. Per altre informazioni, vedere Concedere accesso limitato ai dati con firme di accesso condiviso.

Per usare una chiave condivisa dell'account di archiviazione, specificare la chiave come stringa e inizializzare un oggetto client usando azblob. NewClientWithSharedKeyCredential.

func getServiceClientSharedKey(accountName string, accountKey string) *azblob.Client {
    // Create a new service client with shared key credential
    credential, err := azblob.NewSharedKeyCredential(accountName, accountKey)
    handleError(err)

    accountURL := fmt.Sprintf("https://%s.blob.core.windows.net", accountName)

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

    return client
}

È anche possibile creare un oggetto client usando una stringa di connessione.

func getServiceClientConnectionString(connectionString string) *azblob.Client {
    // Create a new service client with connection string
    client, err := azblob.NewClientFromConnectionString(connectionString, nil)
    handleError(err)

    return client
}

Per informazioni su come ottenere le chiavi dell'account e per ottenere linee guida sulle procedure consigliate per gestire e proteggere correttamente le chiavi, vedere Gestire le chiavi di accesso dell'account di archiviazione.

Importante

La chiave di accesso dell'account deve essere usata con cautela. Se la chiave di accesso dell'account va persa o viene accidentalmente inserita in una posizione non sicura, il servizio può diventare vulnerabile. Chiunque abbia la chiave di accesso può autorizzare richieste all'account di archiviazione e di fatto ha accesso a tutti i dati. DefaultAzureCredential offre vantaggi e funzionalità avanzate per la sicurezza ed è l'approccio consigliato per la gestione dell'autorizzazione per i servizi di Azure.

Compilare l'app

Quando si creano app per lavorare con le risorse dati in Archiviazione BLOB di Azure, il codice interagisce principalmente con tre tipi di risorse: account di archiviazione, contenitori e BLOB. Per altre informazioni su questi tipi di risorse, sul modo in cui sono correlate e sul modo in cui le app interagiscono con le risorse, vedere Informazioni sull'interazione delle app con le risorse dati di Archiviazione BLOB.

Le guide seguenti illustrano come accedere ai dati ed eseguire azioni specifiche usando il modulo client Archiviazione BLOB di Azure per Go:

Guida	Descrizione
Configurare un criterio di ripetizione dei tentativi	Implementare criteri di ripetizione dei tentativi per le operazioni client.
Copiare BLOB	Copiare un BLOB da una posizione a un'altra.
Creare un contenitore	Creare contenitori.
Eliminare e ripristinare BLOB	Eliminare BLOB e, se l'eliminazione temporanea è abilitata, ripristinare i BLOB eliminati.
Eliminare e ripristinare contenitori	Eliminare contenitori e, se l'eliminazione temporanea è abilitata, ripristinare i contenitori eliminati.
Scaricare BLOB	Scaricare i BLOB usando stringhe, flussi e percorsi di file.
Trovare BLOB usando tag	Impostare e recuperare tag e usare tag per trovare i BLOB.
Elencare i BLOB	Elencare i BLOB in modi diversi.
Elencare i contenitori	Elencare i contenitori in un account e le varie opzioni disponibili per personalizzare un elenco.
Gestire proprietà e metadati (BLOB)	Gestire le proprietà e i metadati del contenitore.
Gestire proprietà e metadati (contenitori)	Gestire le proprietà e i metadati del contenitore.
Caricare i BLOB	Informazioni su come caricare BLOB usando stringhe, flussi, percorsi di file e altri metodi.

Nota

Gli esempi di codice in questa guida sono utili per iniziare a usare Archiviazione BLOB di Azure e Go. È consigliabile modificare la gestione degli errori e i valori Context per soddisfare le esigenze dell'applicazione.

Condividi tramite