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

Este artigo mostra como se conectar ao Armazenamento de Blobs do Azure usando a biblioteca de clientes do Armazenamento de Blobs do Azure para Python. Depois de conectado, use os guias do desenvolvedor para saber como o seu código pode operar em contêineres, blobs e recursos do serviço de Armazenamento de Blobs.

Se você estiver procurando começar com um exemplo completo, confira Início rápido: biblioteca de clientes do Armazenamento de Blobs do Azure para Python.

Referência de API | Pacote (PyPi) | Código-fonte da biblioteca | Amostras | Enviar comentários

Pré-requisitos

• Assinatura do Azure - criar uma gratuitamente
• Conta de armazenamento do Azure – criar uma conta de armazenamento
• Python 3.8+

Configurar o seu projeto

Esta seção orienta você na preparação de um projeto para trabalhar com a biblioteca de clientes do Armazenamento de Blobs do Azure para Python.

No diretório do projeto, instale pacotes para as bibliotecas de cliente do Armazenamento de Blobs do Azure e do Azure Identity usando o comando pip install. O pacote azure-identity é necessário para conexões sem senha com os serviços do Azure.

pip install azure-storage-blob azure-identity

Em seguida, abra o arquivo de código e adicione as instruções de importação necessárias. Neste exemplo, adicionamos o seguinte ao nosso arquivo .py:

from azure.identity import DefaultAzureCredential
from azure.storage.blob import BlobServiceClient, BlobClient, ContainerClient

Informações da biblioteca de clientes do blob:

• azure.storage.blob: contém as classes primárias (objetos cliente) que você pode usar para operar no serviço, contêineres e blobs.

Programação assíncrona

A biblioteca de clientes do Armazenamento de Blobs do Azure para Python dá suporte a APIs síncronas e assíncronas. As APIs assíncronas são baseadas na biblioteca assíncrona do Python.

Siga estas etapas para usar as APIs assíncronas no seu projeto:

• Instale um transporte assíncrono, como aiohttp. Você pode instalar aiohttp juntamente com azure-storage-blob usando um comando de instalação de dependência opcional. Neste exemplo, usamos o seguinte comando pip install:

  pip install azure-storage-blob[aio]
  

• Abra o arquivo de código e adicione as instruções de importação necessárias. Neste exemplo, adicionamos o seguinte ao nosso arquivo .py:

  import asyncio
  
  from azure.identity.aio import DefaultAzureCredential
  from azure.storage.blob.aio import BlobServiceClient, BlobClient, ContainerClient
  

  A instrução import asyncio só será necessária se você estiver usando a biblioteca no seu código. Ela é adicionada aqui para maior clareza, pois os exemplos nos artigos do guia do desenvolvedor usam a biblioteca asyncio.

• Crie um objeto cliente usando async with para começar a trabalhar com recursos de dados. Somente o cliente de nível superior precisa usar async with, pois os outros clientes criados a partir dele compartilham o mesmo pool de conexões. Neste exemplo, criamos um objeto BlobServiceClient usando async with e, em seguida, criamos um objeto ContainerClient:

  async with BlobServiceClient(account_url, credential=credential) as blob_service_client:
      container_client = blob_service_client.get_container_client(container="sample-container")
  

  Para saber mais, confira os exemplos assíncronos em Autorizar acesso e conectar-se ao Armazenamento de Blobs.

Informações da biblioteca de clientes assíncronos do blob:

• azure.storage.blob.aio: contém as classes primárias que você pode usar para operar no serviço, contêineres e blobs de forma assíncrona.

Autorizar o acesso e se conectar ao Armazenamento de Blobs

Para conectar um aplicativo ao Armazenamento de Blobs, crie uma instância da classe BlobServiceClient. 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. Você também pode usar o cliente de serviço para criar clientes de contêiner ou clientes de blob, dependendo do recurso com o qual você precisa trabalhar.

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.

Autorize um objeto BlobServiceClient usando um token de autorização do Microsoft Entra, uma chave de acesso de conta ou uma SAS (assinatura de acesso compartilhado). Para otimizar a segurança, a Microsoft recomenda o uso do Microsoft Entra ID com identidades gerenciadas para autorizar solicitações contra dados de blob. Para obter mais informações, consulte Autorizar o acesso a blobs usando o Microsoft Entra ID.

def get_blob_service_client_token_credential(self):
    # TODO: Replace <storage-account-name> with your actual storage account name
    account_url = "https://<storage-account-name>.blob.core.windows.net"
    credential = DefaultAzureCredential()

    # Create the BlobServiceClient object
    blob_service_client = BlobServiceClient(account_url, credential=credential)

    return blob_service_client

# TODO: Replace <storage-account-name> with your actual storage account name
account_url = "https://<storage-account-name>.blob.core.windows.net"
credential = DefaultAzureCredential()

async with BlobServiceClient(account_url, credential=credential) as blob_service_client:
    # Work with data resources in the storage account

def get_blob_service_client_sas(self, sas_token: str):
    # TODO: Replace <storage-account-name> with your actual storage account name
    account_url = "https://<storage-account-name>.blob.core.windows.net"
    # The SAS token string can be assigned to credential here or appended to the account URL
    credential = sas_token

    # Create the BlobServiceClient object
    blob_service_client = BlobServiceClient(account_url, credential=credential)

    return blob_service_client

# TODO: Replace <storage-account-name> with your actual storage account name
account_url = "https://<storage-account-name>.blob.core.windows.net"

# Replace <sas_token_str> with your actual SAS token
sas_token: str = "<sas_token_str>"

async with BlobServiceClient(account_url, credential=sas_token) as blob_service_client:
    # Work with data resources in the storage account

def get_blob_service_client_account_key(self):
    # TODO: Replace <storage-account-name> with your actual storage account name
    account_url = "https://<storage-account-name>.blob.core.windows.net"
    shared_access_key = os.getenv("AZURE_STORAGE_ACCESS_KEY")
    credential = shared_access_key

    # Create the BlobServiceClient object
    blob_service_client = BlobServiceClient(account_url, credential=credential)

    return blob_service_client

def get_blob_service_client_connection_string(self):
    # TODO: Replace <storage-account-name> with your actual storage account name
    account_url = "https://<storage-account-name>.blob.core.windows.net"
    connection_string = os.getenv("AZURE_STORAGE_CONNECTION_STRING")

    # Create the BlobServiceClient object
    blob_service_client = BlobServiceClient.from_connection_string(connection_string)

    return blob_service_client

# TODO: Replace <storage-account-name> with your actual storage account name
account_url = "https://<storage-account-name>.blob.core.windows.net"

shared_access_key = os.getenv("AZURE_STORAGE_ACCESS_KEY")

async with BlobServiceClient(account_url, credential=shared_access_key) as blob_service_client:
    # Work with data resources in the storage account

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 executar ações específicas usando a biblioteca de clientes do Armazenamento do Azure para Python: