Azure Data Explorer-fürt és -adatbázis létrehozása
Az Azure Data Explorer egy gyors, teljes mértékben felügyelt adatelemző szolgáltatás, amellyel valós idejű elemzést végezhet többek között alkalmazások, webhelyek és IoT-eszközök nagy mennyiségű adatfolyamain. Az Azure Data Explorer használatához először egy fürtöt hozunk létre, majd 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 (ARM) sablon használatával. Ha meg szeretné tudni, hogyan hozhat létre fürtöt és adatbázist a Azure Portal használatával, tekintse meg az Azure Data Explorer-fürt és -adatbázis létrehozása című rövid útmutatót.
A korábbi SDK-verziókon alapuló kódmintákért tekintse meg az archivált cikket.
Előfeltételek
Előfeltételek fürt- és adatbázis-létrehozási módszer szerint:
- Azure-előfizetés. Hozzon létre egy ingyenes Azure-fiókot.
- Visual Studio 2022 Community Edition. Kapcsolja be az Azure-fejlesztést a Visual Studio beállítása során.
- Telepítse a Microsoft.Azure.Management.Kusto NuGet-csomagot.
- Egy 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, az alkalmazásazonosítót és az ügyfél titkos kódját.
Azure Data Explorer-fürt létrehozása
Ez a szakasz végigvezeti egy Azure Data Explorer-fürt létrehozásának folyamatán. Válassza ki az előnyben részesített metódus megfelelő lapját a fürt létrehozásához.
Hozza létre a fürtöt 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 Ajánlott érték Mező leírása clusterName mykustocluster A fürt kívánt neve. skuName Standard_E8ads_v5 A fürthöz használni kívánt termékváltozat. tier Standard A termékváltozat szintje. capacity Szám A fürt példányainak száma. resourceGroupName testrg Az erőforráscsoport neve, ahol a fürt létrejön. Megjegyzés
A fürt létrehozása hosszú ideig futó 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 fürt sikeresen létrejött-e:
clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
Ellenőrizze a fürt sikeres létrehozását, és ellenőrizze, hogy az eredmény tartalmazza-e
provisioningState
a következőt:Succeeded
.
Azure Data Explorer-adatbázis létrehozása
Ebben a szakaszban egy adatbázist fog létrehozni az előző szakaszban létrehozott fürtben.
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);
Megjegyzés
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 Ajánlott érték Mező leírása clusterName mykustocluster Annak a fürtnek a neve, ahol az adatbázis létre lesz hozva. databaseName mykustodatabase Az adatbázis neve. resourceGroupName testrg Az erőforráscsoport neve, ahol a fürt létrejön. softDeletePeriod 3650:00:00:00 Az adatok lekérdezésre való rendelkezésre állásának időtartama. hotCachePeriod 3650:00:00:00 Az adatok gyorsítótárban való őrzésének időtartama. Futtassa a következő parancsot a létrehozott adatbázis megtekintéséhez:
databaseData = (await databases.GetAsync(databaseName)).Value.Data as KustoReadWriteDatabase;