C kullanarak Azure Veri Gezgini kümesi ve veritabanı oluşturma #

Azure Veri Gezgini uygulamalar, web siteleri, IoT cihazları ve daha fazlasından akışı yapılan büyük miktarda veri üzerinde gerçek zamanlı analiz yapmaya yönelik hızlı ve tam olarak yönetilen bir veri analizi hizmetidir. Azure Veri Gezgini'ni kullanmak için öncelikle bir küme ve bu kümenin içinde bir veya daha fazla veritabanı oluşturmanız gerekir. Ardından veritabanına veri alarak (yükleyerek) sorgu çalıştırabilirsiniz. Bu makalede, C# kullanarak bir küme ve veritabanı oluşturacaksınız.

Önkoşullar

C# NuGet'i yükleme

Kimlik Doğrulaması

Bu makaledeki örnekleri çalıştırmak için kaynaklara erişebilen bir Azure AD Uygulaması ve hizmet sorumlusu gerekir. Ücretsiz bir Azure AD Uygulaması oluşturmak ve abonelik kapsamında rol ataması eklemek için Azure AD uygulaması oluşturma'ya bakın. Ayrıca , Application IDve Client Secretöğesinin nasıl alınıp alınamaya da devam ederDirectory (tenant) ID.

Azure Veri Gezgini kümesini oluşturma

  1. Aşağıdaki kodu kullanarak kümenizi oluşturun:

    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 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_E8ads_v5";
    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);
    
    Ayar Önerilen değer Alan açıklaması
    clusterName mykustocluster Kümenizin istenen adı.
    skuName Standard_E8ads_v5 Kümeniz için kullanılacak SKU.
    tier Standart SKU katmanı.
    capacity Numarası Kümenin örnek sayısı.
    resourceGroupName testrg Kümenin oluşturulacağı kaynak grubu adı.

    Not

    Küme oluşturma işlemi uzun süre çalışan bir işlem olduğundan CreateOrUpdate yerine CreateOrUpdateAsync kullanılması kesinlikle önerilir.

  2. Kümenizin başarıyla oluşturulup oluşturulmadığını denetlemek için aşağıdaki komutu çalıştırın:

    kustoManagementClient.Clusters.Get(resourceGroupName, clusterName);
    

Sonuç değeriyle birlikte Succeeded içeriyorsaProvisioningState, küme başarıyla oluşturulmuştur.

Azure Veri Gezgini kümesinde veritabanı oluşturma

  1. Aşağıdaki kodu kullanarak veritabanınızı oluşturun:

    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);
    

    Not

    C# sürüm 2.0.0 veya üzerini kullanıyorsanız ReadWriteDatabase yerine Veritabanı'nı kullanın.

    Ayar Önerilen değer Alan açıklaması
    clusterName mykustocluster Veritabanının oluşturulacağı kümenizin adı.
    Databasename mykustodatabase Veritabanınızın adı.
    resourceGroupName testrg Kümenin oluşturulacağı kaynak grubu adı.
    softDeletePeriod 3650:00:00:00 Verilerin sorgulanabilir durumda tutulacağı süre.
    hotCachePeriod 3650:00:00:00 Verilerin önbellekte tutulacağı süre.
  2. Oluşturduğunuz veritabanını görmek için aşağıdaki komutu çalıştırın:

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

Artık bir kümeniz ve veritabanınız var.

Kaynakları temizleme

  • Diğer makalelerimizi izlemeyi planlıyorsanız, oluşturduğunuz kaynakları koruyun.

  • Kaynakları temizlemek için kümeyi silin. Bir kümeyi sildiğinizde, içindeki tüm veritabanları da silinir. Kümenizi silmek için aşağıdaki komutu kullanın:

    kustoManagementClient.Clusters.Delete(resourceGroupName, clusterName);
    

Sonraki adımlar