Snabbstart: Azure Blob Storage-klientbibliotek för C++

Kom igång med Azure Blob Storage-klientbiblioteket för C++. Azure Blob Storage är Microsofts objektlagringslösning för molnet. Följ de här stegen för att installera paketet och prova exempelkod för grundläggande uppgifter.

| API-referensdokumentation Exempel på källkod | för bibliotek | |

Förutsättningar

• Azure-prenumeration – skapa en kostnadsfritt
• Azure Storage-konto – skapa ett lagringskonto
• C++-kompilator
• Cmake
• vcpkg – C- och C++-pakethanterare

Konfigurera

Det här avsnittet beskriver hur du förbereder ett projekt för att arbeta med Azure Blob Storage-klientbiblioteket för C++. Det enklaste sättet att hämta Azure SDK för C++ är att använda vcpkg pakethanteraren.

Installera paketen

vcpkg install Använd kommandot för att installera Azure Blob Storage-biblioteket för C++ och nödvändiga beroenden:

vcpkg.exe install azure-storage-blobs-cpp

Azure Identity-biblioteket behövs för lösenordslösa anslutningar till Azure-tjänster:

vcpkg.exe install azure-identity-cpp

Mer information om projektkonfiguration och arbete med Azure SDK för C++finns i Azure SDK för C++-läsning.

Skapa projektet

I Visual Studio skapar du ett nytt C++-konsolprogram för Windows med namnet BlobQuickstart.

Objektmodell

Azure Blob Storage är optimerat för lagring av enorma mängder ostrukturerade data. Ostrukturerade data är data som inte följer en viss datamodell eller definition, till exempel text eller binära data. Blob Storage erbjuder tre typer av resurser:

• Lagringskontot
• En container på lagringskontot
• En blob i containern

Följande diagram visar relationen mellan de här resurserna.

Använd dessa C++-klasser för att interagera med dessa resurser:

• BlobServiceClient: Med BlobServiceClient klassen kan du ändra Azure Storage-resurser och blobcontainrar.
• BlobContainerClient: Med BlobContainerClient klassen kan du manipulera Azure Storage-containrar och deras blobar.
• BlobClient: Med BlobClient klassen kan du manipulera Azure Storage-blobar. Det är basklassen för alla specialiserade blobklasser.
• BlockBlobClient: Med BlockBlobClient klassen kan du manipulera Azure Storage-blockblobar.

Kodexempel

Dessa exempelkodfragment visar hur du utför följande uppgifter med Azure Blob Storage-klientbiblioteket för C++:

• Lägga till inkluderingsfiler
• Autentisera till Azure och auktorisera åtkomst till blobdata
• Skapa en container
• Ladda upp blobar till en container
• Visa en lista över blobarna i en container
• Ladda ned blobar
• Ta bort en container

Lägga till inkluderingsfiler

Från projektkatalogen:

1. Öppna blobquickstart.sln-lösningsfilen i Visual Studio
2. Öppna källfilen BlobQuickstart.cpp i Visual Studio
3. Ta bort all kod inuti main som har genererats automatiskt
4. Lägg till #include och using namespace instruktioner

#include <iostream>
#include <azure/core.hpp>
#include <azure/identity/default_azure_credential.hpp>
#include <azure/storage/blobs.hpp>

using namespace Azure::Identity;
using namespace Azure::Storage::Blobs;

Autentisera till Azure och auktorisera åtkomst till blobdata

Programbegäranden till Azure Blob Storage måste vara auktoriserade. Att använda klassen DefaultAzureCredential som tillhandahålls av Azure Identity-klientbiblioteket är den rekommenderade metoden för att implementera lösenordslösa anslutningar till Azure-tjänster i din kod, inklusive Blob Storage.

Du kan också auktorisera begäranden till Azure Blob Storage med hjälp av kontoåtkomstnyckeln. Den här metoden bör dock användas med försiktighet. Utvecklare måste vara noggranna för att aldrig exponera åtkomstnyckeln på en osäker plats. Alla som har åtkomstnyckeln kan auktorisera begäranden mot lagringskontot och har effektivt åtkomst till alla data. DefaultAzureCredential ger bättre hanterings- och säkerhetsfördelar jämfört med kontonyckeln för att tillåta lösenordslös autentisering. Båda alternativen visas i följande exempel.

az storage account show --resource-group '<your-resource-group-name>' --name '<your-storage-account-name>' --query id

az role assignment create --assignee "<user@domain>" \
    --role "Storage Blob Data Contributor" \
    --scope "<your-resource-id>"

Get-AzResource -ResourceGroupName "<yourResourceGroupname>" -Name "<yourStorageAccountName>"

New-AzRoleAssignment -SignInName <user@domain> `
    -RoleDefinitionName "Storage Blob Data Contributor" `
    -Scope <yourStorageAccountId>

az storage account show-connection-string --name "<your-storage-account-name>"

$saName = "yourStorageAccountName"
$rgName = "yourResourceGroupName"
$sa = Get-AzStorageAccount -StorageAccountName $saName -ResourceGroupName $rgName

$saKey = (Get-AzStorageAccountKey -ResourceGroupName $rgName -Name $saName)[0].Value

'DefaultEndpointsProtocol=https;AccountName=' + $saName + ';AccountKey=' + $saKey + ';EndpointSuffix=core.windows.net'

setx AZURE_STORAGE_CONNECTION_STRING "<yourconnectionstring>"

export AZURE_STORAGE_CONNECTION_STRING="<yourconnectionstring>"

    // Retrieve the connection string for use with the application. The storage
    // connection string is stored in an environment variable on the machine
    // running the application called AZURE_STORAGE_CONNECTION_STRING.
    // Note that _MSC_VER is set when using MSVC compiler.
    static const char* AZURE_STORAGE_CONNECTION_STRING = "AZURE_STORAGE_CONNECTION_STRING";

#if !defined(_MSC_VER)
    const char* connectionString = std::getenv(AZURE_STORAGE_CONNECTION_STRING);
#else
	// Use getenv_s for MSVC
	size_t requiredSize;
	getenv_s(&requiredSize, NULL, NULL, AZURE_STORAGE_CONNECTION_STRING);
	if (requiredSize == 0) {
		throw std::runtime_error("missing connection string from env.");
	}
	std::vector<char> value(requiredSize);
	getenv_s(&requiredSize, value.data(), value.size(), AZURE_STORAGE_CONNECTION_STRING);
	std::string connectionStringStr = std::string(value.begin(), value.end());
	const char* connectionString = connectionStringStr.c_str();
#endif

	auto blobServiceClient = BlobServiceClient::CreateFromConnectionString(connectionString);

Skapa en container

Bestäm ett namn på den nya containern. Skapa sedan en instans av BlobContainerClient och skapa containern.

Lägg till den här koden i slutet av main():

std::string containerName = "myblobcontainer";
auto containerClient = blobServiceClient.GetBlobContainerClient("myblobcontainer");

// Create the container if it does not exist
std::cout << "Creating container: " << containerName << std::endl;
containerClient.CreateIfNotExists();

Ladda upp blobar till en container

Följande kodfragment:

1. Deklarerar en sträng som innehåller "Hello Azure!"
2. Hämtar en referens till ett BlockBlobClient-objekt genom att anropa GetBlockBlobClient på containern från avsnittet Skapa en container .
3. Laddar upp strängen till bloben genom att anropa funktionen UploadFrom . Den här funktionen skapar bloben om den inte redan finns eller uppdaterar den om den gör det.

Lägg till den här koden i slutet av main():

std::string blobName = "blob.txt";
uint8_t blobContent[] = "Hello Azure!";
// Create the block blob client
BlockBlobClient blobClient = containerClient.GetBlockBlobClient(blobName);

// Upload the blob
std::cout << "Uploading blob: " << blobName << std::endl;
blobClient.UploadFrom(blobContent, sizeof(blobContent));

Visa blobar i en container

Lista blobarna i containern genom att anropa funktionen ListBlobs . Endast en blob har lagts till i containern, så åtgärden returnerar just den bloben.

Lägg till den här koden i slutet av main():

std::cout << "Listing blobs..." << std::endl;
auto listBlobsResponse = containerClient.ListBlobs();
for (auto blobItem : listBlobsResponse.Blobs)
{
    std::cout << "Blob name: " << blobItem.Name << std::endl;
}

Ladda ned blobbar

Hämta egenskaperna för den uppladdade bloben. Deklarera och ändra sedan storlek på ett nytt std::vector<uint8_t> objekt med hjälp av egenskaperna för den uppladdade bloben. Ladda ned den tidigare skapade bloben till det nya std::vector<uint8_t> objektet genom att anropa funktionen DownloadTo i basklassen BlobClient . Visa slutligen nedladdade blobdata.

Lägg till den här koden i slutet av main():

auto properties = blobClient.GetProperties().Value;
std::vector<uint8_t> downloadedBlob(properties.BlobSize);

blobClient.DownloadTo(downloadedBlob.data(), downloadedBlob.size());
std::cout << "Downloaded blob contents: " << std::string(downloadedBlob.begin(), downloadedBlob.end()) << std::endl;

Ta bort en blob

Följande kod tar bort bloben från Azure Blob Storage-containern genom att anropa funktionen BlobClient.Delete .

std::cout << "Deleting blob: " << blobName << std::endl;
blobClient.Delete();

Ta bort en container

Följande kod rensar de resurser som appen skapade genom att ta bort hela containern med hjälp av BlobContainerClient.Ta bort.

Lägg till den här koden i slutet av main():

std::cout << "Deleting container: " << containerName << std::endl;
containerClient.Delete();

Kör koden

Den här appen skapar en container och laddar upp en textfil till Azure Blob Storage. Exemplet visar sedan blobarna i containern, laddar ned filen och visar filinnehållet. Slutligen tar appen bort bloben och containern.

Utdata från appen liknar följande exempel:

Azure Blob Storage - C++ quickstart sample
Creating container: myblobcontainer
Uploading blob: blob.txt
Listing blobs...
Blob name: blob.txt
Downloaded blob contents: Hello Azure!
Deleting blob: blob.txt
Deleting container: myblobcontainer

Nästa steg

I den här snabbstarten har du lärt dig hur du laddar upp, laddar ned och listar blobar med C++. Du har också lärt dig hur du skapar och tar bort en Azure Blob Storage-container.

Om du vill se ett C++ Blob Storage-exempel fortsätter du till: