Aan de slag met Azure Blob Storage en Python

• .NET
• Java
• JavaScript
• TypeScript
• Python

In dit artikel leest u hoe u verbinding maakt met Azure Blob Storage met behulp van de Azure Blob Storage-clientbibliotheek voor Python. Zodra de code is verbonden, kan uw code worden uitgevoerd op containers, blobs en functies van de Blob Storage-service.

Broncodevoorbeelden van API-referentiepakket | (PyPi) | -bibliotheek | geven feedback |

Vereisten

• Azure-abonnement: u kunt een gratis abonnement nemen
• Azure Storage-account: maak een opslagaccount
• Python 3.8+

Uw project instellen

In deze sectie wordt uitgelegd hoe u een project voorbereidt voor gebruik met de Azure Blob Storage-clientbibliotheek voor Python.

Installeer vanuit uw projectmap pakketten voor de Azure Blob Storage- en Azure Identity-clientbibliotheken met behulp van de pip install opdracht. Het azure-identity-pakket is nodig voor verbindingen zonder wachtwoord met Azure-services.

pip install azure-storage-blob azure-identity

Open vervolgens het codebestand en voeg de benodigde importinstructies toe. In dit voorbeeld voegen we het volgende toe aan het bestand .py :

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

Informatie over de Blob-clientbibliotheek:

• azure.storage.blob: bevat de primaire klassen (clientobjecten) die u kunt gebruiken om te werken op de service, containers en blobs.

Asynchroon programmeren

De Azure Blob Storage-clientbibliotheek voor Python ondersteunt zowel synchrone als asynchrone API's. De asynchrone API's zijn gebaseerd op de asynchrone bibliotheek van Python.

Volg deze stappen om de asynchrone API's in uw project te gebruiken:

• Installeer een asynchroon transport, zoals aiohttp. U kunt aiohttp deze installeren met azure-storage-blob behulp van een optionele installatieopdracht voor afhankelijkheden. In dit voorbeeld gebruiken we de volgende pip install opdracht:

  pip install azure-storage-blob[aio]
  

• Open het codebestand en voeg de benodigde importinstructies toe. In dit voorbeeld voegen we het volgende toe aan het bestand .py :

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

  De import asyncio instructie is alleen vereist als u de bibliotheek in uw code gebruikt. Het wordt hier ter duidelijkheid toegevoegd, omdat de voorbeelden in de artikelen over ontwikkelaarshandleidingen gebruikmaken van de asyncio bibliotheek.

• Maak een clientobject met behulp van async with het werken met gegevensbronnen. Alleen de client op het hoogste niveau moet worden gebruikt async with, omdat andere clients die ermee zijn gemaakt, dezelfde verbindingsgroep delen. In dit voorbeeld maken we een BlobServiceClient object met behulp van async withen maken we vervolgens een ContainerClient object:

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

  Zie de asynchrone voorbeelden in Toegang autoriseren en verbinding maken met Blob Storage voor meer informatie.

Informatie over blob asynchrone clientbibliotheek:

• azure.storage.blob.aio: bevat de primaire klassen die u kunt gebruiken om asynchroon te werken op de service, containers en blobs.

Toegang autoriseren en verbinding maken met Blob Storage

Als u een toepassing wilt verbinden met Blob Storage, maakt u een exemplaar van de BlobServiceClient-klasse . Dit object is het startpunt om te communiceren met gegevensbronnen op het niveau van het opslagaccount. U kunt het gebruiken om te werken op het opslagaccount en de bijbehorende containers. U kunt de serviceclient ook gebruiken om containerclients of blob-clients te maken, afhankelijk van de resource waarmee u moet werken.

Zie Clientobjecten maken en beheren die interactie hebben met gegevensbronnen voor meer informatie over het maken en beheren van clientobjecten, inclusief aanbevolen procedures.

U kunt een BlobServiceClient object autoriseren met behulp van een Microsoft Entra-autorisatietoken, een toegangssleutel voor een account of een SAS (Shared Access Signature).

Microsoft Entra ID

Als u wilt autoriseren met Microsoft Entra-id, moet u een beveiligingsprincipaal gebruiken. Welk type beveiligingsprincipaal u nodig hebt, is afhankelijk van waar uw toepassing wordt uitgevoerd. Gebruik de volgende tabel als richtlijn:

Waar de toepassing wordt uitgevoerd	Beveiligingsprincipal	Begeleiding
Lokale machine (ontwikkelen en testen)	Service-principal	Zie Toegang autoriseren met behulp van service-principals voor ontwikkelaars voor meer informatie over het registreren van de app, het instellen van een Microsoft Entra-groep, het toewijzen van rollen en het configureren van omgevingsvariabelen
Lokale machine (ontwikkelen en testen)	Gebruikersidentiteit	Zie Toegang autoriseren met behulp van referenties voor ontwikkelaars voor meer informatie over het instellen van een Microsoft Entra-groep, het toewijzen van rollen en aanmelden bij Azure
Gehost in Azure	Beheerde identiteit	Zie Toegang autoriseren vanuit door Azure gehoste apps met behulp van een beheerde identiteit voor meer informatie over het inschakelen van beheerde identiteiten en het toewijzen van rollen
Gehost buiten Azure (bijvoorbeeld on-premises apps)	Service-principal	Zie Toegang vanuit on-premises apps autoriseren met behulp van een service-principal voor toepassingen voor meer informatie over het registreren van de app, het toewijzen van rollen en het configureren van omgevingsvariabelen

Toegang autoriseren met DefaultAzureCredential

Een eenvoudige en veilige manier om toegang te verlenen en verbinding te maken met Blob Storage is door een OAuth-token te verkrijgen door een DefaultAzureCredential-exemplaar te maken. Vervolgens kunt u die referentie gebruiken om een BlobServiceClient-object te maken.

In het volgende voorbeeld wordt een BlobServiceClient object gemaakt met behulp van DefaultAzureCredential:

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

Als uw project asynchrone API's gebruikt, instantieert u BlobServiceClient het volgende:async with

# 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

SAS-token

Als u een SAS-token (Shared Access Signature) wilt gebruiken, geeft u het token op als een tekenreeks en initialiseert u een BlobServiceClient-object . Als uw account-URL het SAS-token bevat, laat u de referentieparameter weg.

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

Als uw project asynchrone API's gebruikt, instantieert u BlobServiceClient het volgende:async with

# 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

Zie de volgende artikelen voor meer informatie over het genereren en beheren van SAS-tokens:

• Beperkte toegang verlenen tot Azure Storage-resources door middel van een SAS
• Een account-SAS maken met Python
• Een service-SAS maken voor een container met Python
• Een service-SAS maken voor een blob met Python
• Een SAS voor gebruikersdelegatie maken voor een container met Python
• Een SAS voor gebruikersdelegatie maken voor een blob met Python

Accountsleutel

Als u een gedeelde sleutel voor een opslagaccount wilt gebruiken, geeft u de sleutel op als een tekenreeks en initialiseert u een BlobServiceClient-object .

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

U kunt ook een BlobServiceClient object maken met behulp van een verbindingsreeks.

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

Als uw project asynchrone API's gebruikt, instantieert u BlobServiceClient het volgende:async with

# 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

Zie Toegangssleutels voor opslagaccounts beheren voor informatie over het verkrijgen van accountsleutels en aanbevolen procedures voor het correct beheren en beveiligen van uw sleutels.

Belangrijk

De toegangssleutel voor het account moet voorzichtig worden gebruikt. Als uw accounttoegangssleutel verloren gaat of per ongeluk op een onveilige locatie is geplaatst, kan uw service kwetsbaar worden. Iedereen met de toegangssleutel kan aanvragen voor het opslagaccount autoriseren en heeft effectief toegang tot alle gegevens. DefaultAzureCredential biedt verbeterde beveiligingsfuncties en voordelen en is de aanbevolen benadering voor het beheren van autorisatie voor Azure-services.

Uw toepassing bouwen

Wanneer u toepassingen bouwt om te werken met gegevensresources in Azure Blob Storage, communiceert uw code voornamelijk met drie resourcetypen: opslagaccounts, containers en blobs. Voor meer informatie over deze resourcetypen, hoe deze zich verhouden tot elkaar en hoe apps communiceren met resources, raadpleegt u Begrijpen hoe apps communiceren met Blob Storage-gegevensresources.

De volgende handleidingen laten zien hoe u met gegevensbronnen kunt werken en specifieke acties kunt uitvoeren met behulp van de Azure Storage-clientbibliotheek voor Python:

Guide	Beschrijving
Een container maken	Containers maken.
Containers verwijderen en herstellen	Verwijder containers en als voorlopig verwijderen is ingeschakeld, herstelt u verwijderde containers.
Containers weergeven	Lijst met containers in een account en de verschillende opties die beschikbaar zijn om een vermelding aan te passen.
Eigenschappen en metagegevens beheren (containers)	Eigenschappen en metagegevens voor containers ophalen en instellen.
Containerleases maken en beheren	Een vergrendeling voor een container tot stand brengen en beheren.
Blob-leases maken en beheren	Een vergrendeling op een blob tot stand brengen en beheren.
Blobs uploaden	Meer informatie over het uploaden van blobs met behulp van tekenreeksen, streams, bestandspaden en andere methoden.
Blobs downloaden	Download blobs met behulp van tekenreeksen, streams en bestandspaden.
Blobs kopiëren	Kopieer een blob van de ene locatie naar de andere.
Blobs vermelden	Geef blobs op verschillende manieren weer.
Verwijderen en herstellen	Verwijder blobs en als voorlopig verwijderen is ingeschakeld, herstelt u verwijderde blobs.
Blobs zoeken met behulp van tags	Stel tags in en haal ze op en gebruik tags om blobs te zoeken.
Eigenschappen en metagegevens beheren (blobs)	Eigenschappen en metagegevens voor blobs ophalen en instellen.
De toegangslaag van een blob instellen of wijzigen	Stel de toegangslaag voor een blok-blob in of wijzig deze.