Azure Data Explorer-fürt és -adatbázis létrehozása
Az Azure Data Explorer egy gyors, teljes körűen felügyelt adatelemzési szolgáltatás, amely valós idejű elemzést tesz lehetővé alkalmazásokból, webhelyekről, IoT-eszközökről és egyebekről nagy mennyiségű adatstreamelésről. Az Azure Data Explorer használatához először hozzon létre egy fürtöt, és hozzon létre egy vagy több adatbázist a fürtben. Ezután betöltheti (betöltheti) az adatokat egy adatbázisba, és lekérdezéseket futtathat rajta.
Ebből a cikkből megtudhatja, hogyan hozhat létre fürtöt és adatbázist C#, Python, Go, Azure CLI, PowerShell vagy Azure Resource Manager-sablon (ARM) használatával. Ha tudni szeretné, hogyan hozhat létre fürtöt és adatbázist az Azure Portal használatával, tekintse meg rövid útmutatót: Azure Data Explorer-fürt és adatbázis létrehozása.
A korábbi SDK-verziókon alapuló kódmintákért lásd az archivált cikket.
Előfeltételek
Előfeltételek klaszter- és adatbázis-létrehozási módszer szerint:
- Egy Azure-előfizetés. Hozzon létre egy ingyenes Azure-fiókot.
- Visual Studio 2022 Community Edition. Kapcsolja be a Azure-fejlesztést a Visual Studio telepítése során.
- Telepítse a Microsoft.Azure.Management.Kusto NuGet-csomag.
- Microsoft Entra-alkalmazás és szolgáltatásnév, amely hozzáfér az erőforrásokhoz. Mentse a címtár (bérlő) azonosítóját, alkalmazásazonosítótés titkos ügyfélkód.
Azure Data Explorer klaszter létrehozása
Ez a szakasz végigvezeti az Azure Data Explorer-fürt létrehozásának folyamatán. Válassza ki a preferált módszer megfelelő lapját a fürt létrehozásához.
Hozza létre a klasztert a következő kóddal:
var tenantId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Directory (tenant) ID var clientId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Application ID var clientSecret = "PlaceholderClientSecret"; //Client Secret var subscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; var credentials = new ClientSecretCredential(tenantId, clientId, clientSecret); var resourceManagementClient = new ArmClient(credentials, subscriptionId); var resourceGroupName = "testrg"; var subscription = await resourceManagementClient.GetDefaultSubscriptionAsync(); var resourceGroup = (await subscription.GetResourceGroupAsync(resourceGroupName)).Value; var clusters = resourceGroup.GetKustoClusters(); var clusterName = "mykustocluster"; var skuName = KustoSkuName.StandardE8adsV5; var skuTier = KustoSkuTier.Standard; var capacity = 5; var clusterData = new KustoClusterData( location: AzureLocation.CentralUS, sku: new KustoSku(skuName, skuTier) { Capacity = capacity } ); await clusters.CreateOrUpdateAsync(WaitUntil.Completed, clusterName, clusterData);
beállítás javasolt érték mező leírása clusterName mykustocluster A kívánt neve a fürtnek. skuName Standard_E8ads_v5 A fürthöz használt termékváltozat. szint Standard Az SKU-szint. kapacitás szám A klaszter példányainak száma. erőforráscsoportNév testrg Az erőforráscsoport neve, ahol a fürt létrehozva lesz. Jegyzet
A(z) fürt létrehozása hosszú időtartamú művelet, ezért erősen ajánlott a CreateOrUpdateAsync használata a CreateOrUpdate helyett.
Futtassa a következő parancsot annak ellenőrzéséhez, hogy a klaszter sikeresen létrejött-e.
clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
A fürt sikeres létrehozásának megerősítéséhez ellenőrizze, hogy az eredmény
provisioningState
tartalmaz-eSucceeded
.
Azure Data Explorer-adatbázis létrehozása
Ebben a szakaszban létrehoz egy adatbázist az előző szakaszban létrehozott fürtön belül.
Hozza létre az adatbázist a következő kóddal:
var cluster = (await clusters.GetAsync(clusterName)).Value; var databases = cluster.GetKustoDatabases(); var databaseName = "mykustodatabase"; var softDeletePeriod = TimeSpan.FromDays(3650); var hotCachePeriod = TimeSpan.FromDays(3650); var databaseData = new KustoReadWriteDatabase { Location = clusterData.Location, SoftDeletePeriod = softDeletePeriod, HotCachePeriod = hotCachePeriod }; await databases.CreateOrUpdateAsync(WaitUntil.Completed, databaseName, databaseData);
Jegyzet
Ha a C# 2.0.0-s vagy újabb verzióját használja, a ReadWriteDatabase helyett használja az Adatbázist.
beállítás javasolt érték mező leírása klaszterNeve mykustocluster Annak a fürtnek a neve, ahol az adatbázis létrejön. adatbázisNév mykustodatabase Az adatbázis neve. resourceGroupName testrg Az erőforráscsoport neve, amelyben a fürt létrejön. softDeletePeriod 3650:00:00:00 Az adatok lekérdezéshez való rendelkezésre állásának időtartama. hotCachePeriod 3650:00:00:00 Az adatok gyorsítótárban tartásának időtartama. Futtassa a következő parancsot a létrehozott adatbázis megtekintéséhez:
databaseData = (await databases.GetAsync(databaseName)).Value.Data as KustoReadWriteDatabase;