Vytvoření clusteru a databáze Azure Data Exploreru
Azure Data Explorer je rychlá, plně spravovaná služba analýzy dat pro analýzy velkých objemů dat v reálném čase, která se streamují z aplikací, webů, zařízení IoT a dalších. Pokud chcete použít Azure Data Explorer, musíte nejdříve vytvořit cluster a v něm vytvořit jednu nebo více databází. Pak můžete ingestovat (načíst) data do databáze a spouštět na ni dotazy.
V tomto článku se dozvíte, jak vytvořit cluster a databázi pomocí C#, Pythonu, Go, Azure CLI, PowerShellu nebo šablony Azure Resource Manager (ARM). Informace o vytvoření clusteru a databáze pomocí Azure Portal najdete v tématu Rychlý start: Vytvoření clusteru a databáze Azure Data Explorer.
Ukázky kódu založené na předchozích verzích sady SDK najdete v archivovaného článku.
Požadavky
Požadavky metodou vytváření clusteru a databáze:
- Předplatné Azure. Vytvořte si bezplatný účet Azure.
- Visual Studio 2022 Community Edition. Během instalace sady Visual Studio zapněte vývoj pro Azure .
- Nainstalujte balíček NuGet Microsoft.Azure.Management.Kusto.
- Microsoft Entra aplikaci a instanční objekt, které mají přístup k prostředkům. Uložte ID adresáře (tenanta),ID aplikace a tajný klíč klienta.
Vytvoření clusteru Azure Data Explorer
Tato část vás provede procesem vytvoření clusteru Azure Data Explorer. Zvolte příslušnou kartu pro preferovanou metodu vytvoření clusteru.
Vytvořte cluster pomocí následujícího kódu:
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);
Nastavení Navrhovaná hodnota Popis pole clusterName mykustocluster Požadovaný název clusteru. skuName Standard_E8ads_v5 Skladová položka, která se použije pro váš cluster. tier Standard Úroveň skladové položky. capacity Číslo Počet instancí clusteru. resourceGroupName testrg Název skupiny prostředků, ve které se cluster vytvoří. Poznámka
Vytvoření clusteru je dlouhotrvající operace, proto se důrazně doporučuje místo CreateOrUpdateAsync použít CreateOrUpdateAsync.
Spuštěním následujícího příkazu zkontrolujte, jestli se cluster úspěšně vytvořil:
clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
Ověřte úspěšné vytvoření clusteru tím, že ověříte, že výsledek obsahuje
provisioningState
hodnotuSucceeded
.
Vytvoření databáze Azure Data Explorer
V této části vytvoříte databázi v clusteru vytvořeném v předchozí části.
Vytvořte databázi pomocí následujícího kódu:
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);
Poznámka
Pokud používáte C# verze 2.0.0 nebo nižší, použijte databázi místo ReadWriteDatabase.
Nastavení Navrhovaná hodnota Popis pole clusterName mykustocluster Název vašeho clusteru, ve kterém se databáze vytvoří. databaseName databáze mykustodatabase Název databáze. resourceGroupName testrg Název skupiny prostředků, ve které se cluster vytvoří. softDeletePeriod 3650:00:00:00 Doba, po kterou budou data k dispozici pro dotazování. hotCachePeriod 3650:00:00:00 Doba, po kterou se budou data uchovávat v mezipaměti. Spuštěním následujícího příkazu zobrazte databázi, kterou jste vytvořili:
databaseData = (await databases.GetAsync(databaseName)).Value.Data as KustoReadWriteDatabase;
Další krok
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro