Introdução ao Armazenamento de Blobs do Azure e ao Go

Artigo
08/28/2024

Este artigo mostra como se conectar ao Armazenamento de Blobs do Azure usando o módulo de clientes do Armazenamento de Blob do Azure para Go. Após se conectar, seu código pode operar em contêineres, blobs e recursos do serviço de Armazenamento de Blobs.

Documentação de referência da API | Código-fonte da biblioteca | Pacote (pkg.go.dev)

Pré-requisitos

Assinatura do Azure - criar uma gratuitamente
Conta de armazenamento do Azure – criar uma conta de armazenamento
Go 1.18 ou posterior

Configurar o seu projeto

Esta seção orienta você na preparação de um projeto para trabalhar com o módulo de cliente do Armazenamento de Blobs do Azure para Go.

No seu GOPATH, instale o módulo azblob usando o seguinte comando:

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

Para autenticar com o Microsoft Entra ID (recomendado), instale o módulo azidentity usando o comando a seguir:

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

Em seguida, abra o arquivo de código e adicione os caminhos de importação necessários. Neste exemplo, adicionamos o seguinte ao nosso arquivo .go:

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

Informações do módulo do cliente blob:

azblob: contém todos os métodos que você pode usar para operar no serviço, contêineres e blobs.

Autorizar o acesso e se conectar ao Armazenamento de Blobs

Para conectar um aplicativo ao Armazenamento de Blobs, crie um objeto cliente usando azblob.NewClient. Esse objeto é seu ponto de partida para interagir com os recursos de dados no nível da conta de armazenamento. Você pode usá-lo para operar na conta de armazenamento e nos respectivos contêineres.

Para saber mais sobre como criar e gerenciar objetos clientes, inclusive as melhores práticas, confira Criar e gerenciar objetos de cliente que interagem com recursos de dados.

Você pode autorizar um objeto cliente usando um token de autorização do Microsoft Entra (recomendado), uma chave de acesso de conta ou uma assinatura de acesso compartilhado (SAS).

Para autorizar com a ID do Microsoft Entra, você precisará usar uma entidade de segurança. Os artigos a seguir fornecem diretrizes sobre diferentes cenários de autenticação:

Autorizar o acesso usando DefaultAzureCredential

Uma maneira fácil e segura de autorizar o acesso e se conectar ao Armazenamento de Blobs é obter um token OAuth criando uma instância de DefaultAzureCredential. Em seguida, você pode usar essa credencial para criar o objeto cliente 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
}

Para usar um token SAS (assinatura de acesso compartilhado), acrescente o token à cadeia de caracteres de URL da conta e crie o objeto cliente 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
}

Observação

Para os cenários em que as assinaturas de acesso compartilhado (SAS) são utilizadas, a Microsoft recomenda o uso de uma SAS de delegação de usuário. Uma SAS de delegação de usuário é protegida por credenciais do Microsoft Entra em vez da chave da conta. Para saber mais, confira Conceder acesso limitado a dados com assinaturas de acesso compartilhado (SAS).

Para usar uma chave compartilhada de conta de armazenamento, forneça a chave como uma cadeia de caracteres e inicialize um objeto cliente 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
}

Você também pode criar um objeto cliente usando uma cadeia de conexão.

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

    return client
}

Para obter informações sobre como obter chaves de conta e diretrizes de melhores práticas para gerenciar e proteger corretamente suas chaves, consulte Gerenciar chaves de acesso da conta de armazenamento.

Importante

A chave de acesso da conta deve ser usada com cautela. Se a chave de acesso da conta for perdida ou colocada acidentalmente em um local inseguro, o serviço poderá ficar vulnerável. Qualquer pessoa que tenha a chave de acesso pode autorizar solicitações na conta de armazenamento e efetivamente tem acesso a todos os dados. DefaultAzureCredential fornece recursos e benefícios de segurança avançados e é a abordagem recomendada para gerenciar a autorização para os serviços do Azure.

Compilar o aplicativo

À medida que você cria aplicativos para trabalhar com recursos de dados no Armazenamento de Blobs do Azure, seu código interage principalmente com três tipos de recursos: contas de armazenamento, contêineres e blobs. Para saber mais sobre esses tipos de recursos, como eles se relacionam entre si e como os aplicativos interagem com os recursos, confira Entender como os aplicativos interagem com os recursos de dados do Armazenamento de Blobs.

Os seguintes guias mostram como acessar dados e realizar ações específicas usando o módulo do cliente do Armazenamento de Blobs do Azure para Go:

Guia	Descrição
Configurar uma política de repetição	Implementar políticas de repetição para operações do cliente.
Copiar blobs	Copie um blob de uma localização para outra.
Criar um contêiner	Crie contêineres.
Excluir e restaurar blobs	Exclua os blobs, e, se a exclusão reversível estiver habilitada, restaure os blobs excluídos.
Excluir e restaurar contêineres	Exclua contêineres e, se a exclusão reversível estiver habilitada, restaure os contêineres excluídos.
Baixar blobs	Baixe blobs usando cadeias de caracteres, fluxos e caminhos de arquivo.
Encontrar blobs usando marcas	Defina e recupere marcas e use as marcas para localizar blobs.
Listar blobs	Liste blobs de maneiras diferentes.
Listar contêineres	Liste os contêineres em uma conta e as diversas opções disponíveis para personalizar uma listagem.
Gerenciar propriedades e metadados (blobs)	Gerenciar propriedades do contêiner e metadados.
Gerenciar propriedades e metadados (contêineres)	Gerenciar propriedades do contêiner e metadados.
Carregar blobs	Saiba como carregar blobs usando cadeias de caracteres, fluxos, caminhos de arquivo e outros métodos.

Observação

Os exemplos de código neste guia destinam-se a ajudá-lo a começar a usar o Armazenamento de Blobs do Azure e o Go. Você deve modificar o tratamento de erros e valores Context para atender às necessidades do aplicativo.

Compartilhar via