Introducción a Azure Blob Storage y Go

En este artículo se muestra cómo conectarse a Azure Blob Storage mediante el módulo cliente de Azure Blob Storage para Go. Una vez que se haya conectado, use las guías para desarrolladores a fin de obtener información sobre cómo el código puede realizar operaciones con contenedores, blobs y características del servicio Blob Storage.

Si quiere empezar con un ejemplo completo, vea Inicio rápido: Biblioteca cliente de Azure Blob Storage para Go.

Documentación de referencia de la API | Código fuente de la biblioteca | Paquete (pkg.go.dev)

Prerrequisitos

• Una suscripción a Azure: cree una cuenta gratuita
• Una cuenta de Azure Storage: cree una cuenta de almacenamiento
• Go 1.18+

Configuración del proyecto

En esta sección se explica cómo preparar un proyecto para que funcione con el módulo de cliente de Azure Blob Storage para Go.

Desde GOPATH, instale el módulo azblob mediante el siguiente comando:

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

Para autenticarse con Microsoft Entra ID (recomendado), instale el módulo azidentity mediante el siguiente comando:

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

A continuación, abra el archivo de código y agregue las rutas de importación necesarias. En este ejemplo, agregamos lo siguiente al archivo .go:

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

Información del módulo de cliente de blobs:

• azblob: contiene los métodos que puede usar para operar en el servicio, los contenedores y los blobs.

Autorización del acceso y conexión a Blob Storage

Para conectar una aplicación a Blob Storage, cree un objeto de cliente mediante azblob.NewClient. Este objeto es el punto inicial para interactuar con los recursos de datos en el nivel de cuenta de almacenamiento. Puede usarlo para operar en la cuenta de almacenamiento y sus contenedores.

Para obtener más información sobre cómo crear y administrar objetos de cliente, incluidos los procedimientos recomendados, consulte Crear y administrar objetos de cliente que interactúan con los recursos de datos.

Puede autorizar un objeto de cliente mediante un token de autorización de Microsoft Entra (recomendado), una clave de acceso de cuenta o una firma de acceso compartido (SAS).

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
}

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
}

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
}

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

    return client
}

Compilación de la aplicación

A medida que compila aplicaciones para trabajar con recursos de datos en Azure Blob Storage, el código interactúa principalmente con tres tipos de recursos: cuentas de almacenamiento, contenedores y blobs. Para más información sobre estos tipos de recursos, cómo se relacionan entre sí y cómo interactúan las aplicaciones con los recursos, consulte Descripción de cómo interactúan las aplicaciones con los recursos de datos de Blob Storage.

En las guías siguientes se muestra cómo acceder a los datos y realizar acciones específicas mediante el módulo cliente de Azure Blob Storage para Go: