Rychlý start: Klientská knihovna Azure Blob Storage pro C++

Začínáme s klientskou knihovnou azure Blob Storage pro C++. Azure Blob Storage je řešení úložiště objektů Od Microsoftu pro cloud. Pomocí těchto kroků nainstalujte balíček a vyzkoušejte si ukázkový kód pro základní úlohy.

| Ukázky zdrojového kódu | knihovny referenční dokumentace | k rozhraní API |

Předpoklady

• Předplatné Azure – vytvoření bezplatného předplatného
• Účet úložiště Azure – Vytvoření účtu úložiště
• Kompilátor C++
• CMake
• vcpkg – správce balíčků C a C++

Nastavení

Tato část vás provede přípravou projektu pro práci s klientskou knihovnou služby Azure Blob Storage pro C++. Nejjednodušší způsob, jak získat sadu Azure SDK pro C++, je použít vcpkg správce balíčků.

Instalace balíčků

vcpkg install Pomocí příkazu nainstalujte knihovnu Azure Blob Storage pro C++ a potřebné závislosti:

vcpkg.exe install azure-storage-blobs-cpp

Knihovna identit Azure je potřebná pro připojení bez hesla ke službám Azure:

vcpkg.exe install azure-identity-cpp

Další informace o nastavení projektu a práci se sadou Azure SDK pro C++ najdete v souboru Readme sady Azure SDK pro jazyk C++.

Vytvoření projektu

V sadě Visual Studio vytvořte novou konzolovou aplikaci C++ pro Windows s názvem BlobQuickstart.

Objektový model

Azure Blob Storage je optimalizovaná pro ukládání obrovských objemů nestrukturovaných dat. Nestrukturovaná data jsou data, která neodpovídají žádnému konkrétnímu datovému modelu nebo definici, jako jsou textová nebo binární data. Blob Storage nabízí tři typy prostředků:

• Účet úložiště
• Kontejner v účtu úložiště
• Objekt blob v kontejneru

Na následujícím diagramu jsou vztahy těchto prostředků.

K interakci s těmito prostředky použijte tyto třídy jazyka C++:

• BlobServiceClient: Třída BlobServiceClient umožňuje manipulovat s prostředky azure Storage a kontejnery objektů blob.
• BlobContainerClient: Třída BlobContainerClient umožňuje manipulovat s kontejnery Azure Storage a jejich objekty blob.
• BlobClient: Třída BlobClient umožňuje manipulovat s objekty blob služby Azure Storage. Je to základní třída pro všechny specializované třídy objektů blob.
• BlockBlobClient: Třída BlockBlobClient umožňuje manipulovat s objekty blob bloku služby Azure Storage.

Příklady kódu

Tyto ukázkové fragmenty kódu ukazují, jak provádět následující úlohy s klientskou knihovnou služby Azure Blob Storage pro C++:

• Přidání souborů zahrnutí
• Ověřování v Azure a autorizace přístupu k datům objektů blob
• Vytvoření kontejneru
• Nahrání objektů blob do kontejneru
• Výpis objektů blob v kontejneru
• Stažení objektů blob
• Odstranění kontejneru

Přidání souborů zahrnutí

Z adresáře projektu:

1. Otevření souboru řešení BlobQuickstart.sln v sadě Visual Studio
2. V sadě Visual Studio otevřete zdrojový soubor BlobQuickstart.cpp .
3. Odeberte veškerý kód uvnitř main , který byl automaticky vygenerován.
4. Přidání #include a using namespace příkazy

#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;

Ověřování v Azure a autorizace přístupu k datům objektů blob

Žádosti aplikací do služby Azure Blob Storage musí být autorizované. DefaultAzureCredential Použití třídy poskytované klientskou knihovnou azure Identity je doporučeným přístupem k implementaci bez hesel připojení ke službám Azure v kódu, včetně blob Storage.

Žádosti o službu Azure Blob Storage můžete také autorizovat pomocí přístupového klíče účtu. Tento přístup by však měl být používán s opatrností. Vývojáři musí být usilovní, aby nikdy nezpřístupnil přístupový klíč v nezabezpečeném umístění. Každý, kdo má přístupový klíč, může autorizovat požadavky na účet úložiště a efektivně má přístup ke všem datům. DefaultAzureCredential nabízí vylepšené výhody správy a zabezpečení oproti klíči účtu, které umožňují ověřování bez hesla. Obě možnosti jsou demonstrována v následujícím příkladu.

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);

Vytvoření kontejneru

Rozhodněte se o názvu nového kontejneru. Pak vytvořte instanci BlobContainerClient kontejneru a vytvořte ji.

Přidejte tento kód na konec 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();

Nahrání objektů blob do kontejneru

Následující fragment kódu:

1. Deklaruje řetězec obsahující "Hello Azure!".
2. Získá odkaz na BlockBlobClient objekt volání GetBlockBlobClient v kontejneru oddílu Vytvořit kontejner .
3. Nahraje řetězec do objektu blob voláním funkce UploadFrom . Tato funkce vytvoří objekt blob, pokud ještě neexistuje, nebo ho aktualizuje, pokud ano.

Přidejte tento kód na konec 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));

Seznam objektů blob v kontejneru

Vypište objekty blob v kontejneru voláním funkce ListBlobs . Do kontejneru byl přidán pouze jeden objekt blob, takže operace vrátí pouze tento objekt blob.

Přidejte tento kód na konec main():

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

Stáhnout objekty blob

Získejte vlastnosti nahraného objektu blob. Potom deklarujte a změňte velikost nového std::vector<uint8_t> objektu pomocí vlastností nahraného objektu blob. Stáhněte dříve vytvořený objekt blob do nového std::vector<uint8_t> objektu voláním funkce DownloadTo v základní třídě BlobClient . Nakonec zobrazte stažená data objektů blob.

Přidejte tento kód na konec 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;

Odstranění objektu blob

Následující kód odstraní objekt blob z kontejneru Azure Blob Storage voláním funkce BlobClient.Delete .

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

Odstranění kontejneru

Následující kód vyčistí prostředky, které aplikace vytvořila odstraněním celého kontejneru pomocí BlobContainerClient.Odstranit.

Přidejte tento kód na konec main():

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

Spuštění kódu

Tato aplikace vytvoří kontejner a nahraje textový soubor do služby Azure Blob Storage. Příklad pak vypíše objekty blob v kontejneru, stáhne soubor a zobrazí obsah souboru. Aplikace nakonec odstraní objekt blob a kontejner.

Výstup aplikace je podobný následujícímu příkladu:

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

Další kroky

V tomto rychlém startu jste zjistili, jak pomocí jazyka C++ nahrát, stáhnout a vypsat objekty blob. Dozvěděli jste se také, jak vytvořit a odstranit kontejner Azure Blob Storage.

Pokud chcete zobrazit ukázku služby C++ Blob Storage, pokračujte následujícími postupy: