Ismerkedés az Azure Stack Hub tárolófejlesztési eszközeivel

A Microsoft Azure Stack Hub olyan tárolási szolgáltatásokat biztosít, amelyek blob-, tábla- és üzenetsor-tárolókat tartalmaznak.

Ez a cikk útmutatóként szolgál az Azure Stack Hub tárolófejlesztési eszközeinek használatának megkezdéséhez. Részletesebb információkat és mintakódot a megfelelő Azure Storage-oktatóanyagokban talál.

Megjegyzés

Az Azure Stack Hub storage és az Azure Storage között különbségek vannak, beleértve az egyes platformokra vonatkozó konkrét követelményeket is. Az Azure Stack Hubra például adott ügyfélkódtárakra és végponti utótagokra vonatkozó követelmények vonatkoznak. További információ: Azure Stack Hub Storage: Különbségek és szempontok.

Azure-ügyfélkódtárak

A tárolóügyfél-kódtárak esetében vegye figyelembe a REST API-val kompatibilis verziót. Meg kell adnia az Azure Stack Hub végpontját is a kódban.

2301-frissítés és újabb

Ügyfélkódtár	Az Azure Stack Hub által támogatott verzió	Hivatkozás	Végpont specifikációja
.NET	Gyakori: 12.9.0 Blob: 12.10.0 Üzenetsor: 12.8.0	NuGet-csomag: Közös: https://www.nuget.org/packages/Azure.Storage.common/12.9.0 Blob: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0 Várólista: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0 GitHub-kiadás: Közös: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Common_12.9.0/sdk/storage/Azure.Storage.Common Blob: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs_12.10.0/sdk/storage/Azure.Storage.Blobs Várólista: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues	app.config fájl
Java	Gyakori: 12.12.0 Blob: 12.14.3 Üzenetsor: 12.11.3	Maven-csomag: Közös: https://mvnrepository.com/artifact/com.azure/azure-storage-common/12.12.0 Blob: https://mvnrepository.com/artifact/com.azure/azure-storage-blob/12.14.3 Várólista: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.11.3 GitHub-kiadás: Közös: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-common_12.12.0/sdk/storage/azure-storage-common Blob: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-blob_12.14.3/sdk/storage/azure-storage-blob Várólista: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.11.3/sdk/storage/azure-storage-queue	Kapcsolati sztring beállítása
Node.js	2.8.3	NPM-hivatkozás: https://www.npmjs.com/package/azure-storage (Futtatás: npm install azure-storage@2.8.3) GitHub-kiadás: https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3	Szolgáltatáspéldány deklarációja
C++	Blob: 12.2.0 Üzenetsor: 12.0.0	GitHub-kiadás: Blob: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-blobs_12.2.0 Várólista: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-queues_12.0.0	Kapcsolati sztring beállítása
PHP	1.2.0	GitHub-kiadás: Közös: https://github.com/Azure/azure-storage-php/releases/tag/v1.2.0-common Blob: https://github.com/Azure/azure-storage-php/releases/tag/v1.2.0-blob Várólista: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue Táblázat: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table Telepítés a Composer használatával (További információért tekintse meg az alábbi részleteket.)	Kapcsolati sztring beállítása
Python	Blob: 12.9.0 Üzenetsor: 12.1.6	GitHub-kiadás: Blob: https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.9.0/sdk/storage/azure-storage-blob Várólista: https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-queue_12.1.6/sdk/storage/azure-storage-queue	Szolgáltatáspéldány deklarációja
Ruby	1.0.1	RubyGems csomag: Közös: https://rubygems.org/gems/azure-storage-common/versions/1.0.1 Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1 Várólista: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1 Táblázat: https://rubygems.org/gems/azure-storage-table/versions/1.0.1 GitHub-kiadás: Közös: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-common Blob: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-blob Várólista: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue Táblázat: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table	Kapcsolati sztring beállítása

Megjegyzés

A .NET és a Java ügyfélkódtár régi verziójában nagy súlyosságú biztonsági rés van, a Jackson-csomag sebezhető verziójától való függőségek miatt. Javasoljuk, hogy a biztonsági probléma elkerülése érdekében használja a .NET és a Java ügyfélkódtár legújabb támogatott verzióját.

PHP-ügyfél telepítése a Composer használatával – aktuális

A Composer használatával történő telepítéshez: (példaként vegyük a blobot).

1. Hozzon létre egy composer.json nevű fájlt a projekt gyökerében a következő kóddal:

   {
     "require": {
     "Microsoft/azure-storage-blob":"1.2.0"
     }
   }
   

2. Töltse le a composer.phar fájlt a projektgyökérre.

3. Adja ki a következő parancsot: php composer.phar install.

API-verzió megadása

Az új . NET-ügyfélkódtár (Gyakori: 12.9.0/Blob: v12.10.0 / Queue: v12.8.0) és Java-ügyfélkódtár (gyakori: v12.12) használata .0 / Blob: v12.13.0 / Queue: v12.10.0), explicit módon meg kell adnia a serviceVersion értéket az egyes ügyfélosztályokban (beleértve a BlobServiceClient, a BlobContainerClient, BlobClient, QueueServiceClient és QueueClient), mert az ügyfélosztály alapértelmezett verzióját jelenleg nem támogatja az Azure Stack Hub.

Példák

.NET

BlobClientOptions options = new BlobClientOptions(BlobClientOptions.ServiceVersion.V2019_07_07);
BlobServiceClient client = new BlobServiceClient("<connection_string>", options);

Java

BlobServiceVersion version = BlobServiceVersion.V2019_07_07; 
BlobServiceClient blobServiceClient = new BlobServiceClientBuilder()
    .endpoint("<your_endpoint>")
    .sasToken("<your_SAS_token>")
    .serviceVersion(version)
    .buildClient();

Végpont deklarációja

Az Azure Stack Hub-végpont két részből áll: egy régió neve és az Azure Stack Hub-tartomány. Az Azure Stack Development Kitben az alapértelmezett végpont a local.azurestack.external. Ha nem biztos a végponttal kapcsolatban, forduljon a felhő rendszergazdájához.

Példák

.NET

Az Azure Stack Hub esetében a végpont utótagja a app.config fájlban van megadva:

<add key="StorageConnectionString"
value="DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=mykey;
EndpointSuffix=local.azurestack.external;" />

Java

Az Azure Stack Hub esetében a végpont utótagja a kapcsolati karakterlánc beállításában van megadva:

public static final String storageConnectionString =
    "DefaultEndpointsProtocol=http;" +
    "AccountName=your_storage_account;" +
    "AccountKey=your_storage_account_key;" +
    "EndpointSuffix=local.azurestack.external";

Node.js

Az Azure Stack Hub esetében a végpont utótagja a deklarációs példányban van megadva:

var blobSvc = azure.createBlobService('myaccount', 'mykey',
'myaccount.blob.local.azurestack.external');

C++

Az Azure Stack Hub esetében a végpont utótagja a kapcsolati karakterlánc beállításában van megadva:

const utility::string_t storage_connection_string(U("DefaultEndpointsProtocol=https;
AccountName=your_storage_account;
AccountKey=your_storage_account_key;
EndpointSuffix=local.azurestack.external"));

PHP

Az Azure Stack Hub esetében a végpont utótagja a kapcsolati karakterlánc beállításában van megadva:

$connectionString = 'BlobEndpoint=https://<storage account name>.blob.local.azurestack.external/;
QueueEndpoint=https:// <storage account name>.queue.local.azurestack.external/;
TableEndpoint=https:// <storage account name>.table.local.azurestack.external/;
AccountName=<storage account name>;AccountKey=<storage account key>'

Python

Az Azure Stack Hub esetében a végpont utótagja a deklarációs példányban van megadva:

block_blob_service = BlockBlobService(account_name='myaccount',
account_key='mykey',
endpoint_suffix='local.azurestack.external')

Ruby

Az Azure Stack Hub esetében a végpont utótagja a kapcsolati karakterlánc beállításában van megadva:

set
AZURE_STORAGE_CONNECTION_STRING=DefaultEndpointsProtocol=https;
AccountName=myaccount;
AccountKey=mykey;
EndpointSuffix=local.azurestack.external

Blob Storage

A következő Azure Blob Storage-oktatóanyagok az Azure Stack Hubra vonatkoznak. Jegyezze fel az Azure Stack Hubra vonatkozó konkrét végpont-utótag-követelményt, amelyet az előző Példák szakaszban ismertet .

• Get started with Azure Blob Storage using .NET (Az Azure Blob Storage használatának első lépései a .NET-keretrendszerrel)
• How to use Blob storage from Java (A Blob Storage használata Javával)
• How to use Blob storage from Node.js (A Blob Storage használata Node.js-sel)
• Blob Storage használata C++ nyelven
• How to use Blob storage from PHP (A Blob Storage használata PHP-val)
• Az Azure Blob Storage használata Pythonból
• How to use Blob storage from Ruby (A Blob Storage használata Rubyval)

Queue Storage

A következő Azure Queue Storage-oktatóanyagok az Azure Stack Hubra vonatkoznak. Jegyezze fel az Azure Stack Hubra vonatkozó konkrét végpont-utótag-követelményt, amelyet az előző Példák szakaszban ismertet .

• Az Azure Queue Storage használatának első lépései a .NET használatával
• How to use Queue Storage from Java (A Queue Storage használata Javával)
• A Queue Storage használata Node.js-sel
• Queue Storage használata C++ nyelven
• How to use Queue storage from PHP (A Queue Storage használata PHP-val)
• How to use Queue storage from Python (A Queue Storage használata Pythonnal)
• How to use Queue storage from Ruby (A Queue Storage használata Rubyval)

Table Storage

Az alábbi Azure Table Storage-oktatóanyagok az Azure Stack Hubra vonatkoznak. Jegyezze fel az Azure Stack Hubra vonatkozó konkrét végpont-utótag-követelményt, amelyet az előző Példák szakaszban ismertet .

• Az Azure Table Storage használatának első lépései a .NET-keretrendszerrel
• How to use Table storage from Java (A Table Storage használata Javával)
• Az Azure Table Storage használata Node.js-sel
• A Table Storage használata A C++-ból
• How to use Table storage from PHP (A Table Storage használata PHP-val)
• A Table Storage használata Pythonban
• How to use Table storage from Ruby (A Table Storage használata Rubyval)

Következő lépések

• A Microsoft Azure Storage bemutatása