Een cluster Azure Data Explorer database maken met C #

  • Artikel
  • 3 minuten om te lezen

Azure Data Explorer is een snelle, volledig beheerde service voor gegevensanalyses waarmee grote hoeveelheden gegevens van toepassingen, websites, IoT-apparaten en dergelijke in real-time kunnen worden geanalyseerd. Als u Azure Data Explorer wilt gebruiken, maakt u eerst een cluster. Daarna maakt u een of meer databases in het cluster. De volgende stap is het opnemen (laden) van gegevens in een database, zodat u er query's op kunt uitvoeren. In dit artikel maakt u een cluster en een database met behulp van C#.

Vereisten

C# NuGet installeren

Verificatie

Voor het uitvoeren van de voorbeelden in dit artikel hebben we een Azure AD-toepassing en service-principal nodig die toegang hebben tot resources. Controleer een Azure AD-toepassing maken om een gratis Azure AD-toepassing te maken en roltoewijzing toe te voegen aan het abonnementsbereik. U ziet ook hoe u Directory (tenant) ID de , en kunt Application IDClient Secret krijgen.

Het Azure Data Explorer-cluster maken

  1. Maak uw cluster met behulp van de volgende code:

    var tenantId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";//Directory (tenant) ID
var clientId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";//Application ID
var clientSecret = "xxxxxxxxxxxxxx";//Client Secret
var subscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
var authenticationContext = new AuthenticationContext($"https://login.windows.net/{tenantId}");
var credential = new ClientCredential(clientId, clientSecret);
var result = await authenticationContext.AcquireTokenAsync(resource: "https://management.core.windows.net/", clientCredential: credential);

var credentials = new TokenCredentials(result.AccessToken, result.AccessTokenType);

var kustoManagementClient = new KustoManagementClient(credentials)
{
    SubscriptionId = subscriptionId
};

var resourceGroupName = "testrg";
var clusterName = "mykustocluster";
var location = "Central US";
var skuName = "Standard_D13_v2";
var tier = "Standard";
var capacity = 5;
var sku = new AzureSku(skuName, tier, capacity);
var cluster = new Cluster(location, sku);
await kustoManagementClient.Clusters.CreateOrUpdateAsync(resourceGroupName, clusterName, cluster);
    Instelling Voorgestelde waarde Beschrijving van veld
    clusterName mycluster De gewenste naam van uw cluster.
    skuName Standard_D13_v2 De SKU die wordt gebruikt voor uw cluster.
    laag Standard De SKU-laag.
    capacity getal Het aantal exemplaren van het cluster.
    resourceGroupName testrg Naam van de resourcegroep waar het cluster wordt gemaakt.

    Notitie

    Het maken van een cluster is een langdurige bewerking, dus het is raadzaam om CreateOrUpdateAsync te gebruiken in plaats van CreateOrUpdate.

  2. Voer de volgende opdracht uit om te controleren of het cluster is gemaakt:

    kustoManagementClient.Clusters.Get(resourceGroupName, clusterName);

Als het resultaat ProvisioningState met waarde Succeeded bevat, is het maken van het cluster geslaagd.

De database in het Azure Data Explorer-cluster maken

  1. Maak uw database met behulp van de volgende code:

    var hotCachePeriod = new TimeSpan(3650, 0, 0, 0);
var softDeletePeriod = new TimeSpan(3650, 0, 0, 0);
var databaseName = "mykustodatabase";
var database = new ReadWriteDatabase(location: location, softDeletePeriod: softDeletePeriod, hotCachePeriod: hotCachePeriod);

await kustoManagementClient.Databases.CreateOrUpdateAsync(resourceGroupName, clusterName, databaseName, database);

    Notitie

    Als u C# versie 2.0.0 of lager gebruikt, gebruikt u Database in plaats van ReadWriteDatabase.

    Instelling Voorgestelde waarde Beschrijving van veld
    clusterName mycluster De naam van het cluster waar de database wordt gemaakt.
    Databasenaam myplanedatabase De naam van uw database.
    resourceGroupName testrg Naam van de resourcegroep waar het cluster wordt gemaakt.
    softDeletePeriod 3650:00:00:00 Hoe lang gegevens worden opgeslagen om query's erop te kunnen uitvoeren.
    hotCachePeriod 3650:00:00:00 Hoe lang gegevens worden opgeslagen in de cache.

  2. Voer de volgende opdracht uit om de database te bekijken die u hebt gemaakt:

    kustoManagementClient.Databases.Get(resourceGroupName, clusterName, databaseName) as ReadWriteDatabase;

U hebt nu een cluster en een database.

Resources opschonen

  • Als u van plan bent onze andere artikelen te volgen, bewaar dan de resources die u hebt gemaakt.

  • Als u resources wilt opschonen, moet u het cluster verwijderen. Wanneer u een cluster verwijdert, worden alle databases hierin ook verwijderd. Gebruik de volgende opdracht om uw cluster te verwijderen:

    kustoManagementClient.Clusters.Delete(resourceGroupName, clusterName);

Volgende stappen