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şturursunuz.

Önkoşullar

C# NuGet 'yi yükler

Kimlik Doğrulaması

Bu makaledeki örnekleri çalıştırmak için, kaynaklara erişebilen bir Azure AD uygulaması ve hizmet sorumlusu olması gerekir. Azure AD uygulaması oluşturma ' yı denetleyerek ücretsiz BIR Azure AD uygulaması oluşturun ve abonelik kapsamında rol ataması ekleyin. Ayrıca,, ve Client Secret ' nin nasıl alınacağını Application IDDirectory (tenant) ID gösterir.

Azure Veri Gezgini kümesi 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_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);
    
    Ayar Önerilen değer Alan açıklaması
    clusterName mykustocluster Kümenizin istenen adı.
    skuName Standard_D13_v2 Kümeniz için kullanılacak SKU.
    tier Standart SKU katmanı.
    capacity sayısından Küme örneklerinin sayısı.
    resourceGroupName testrg Kümenin oluşturulacağı kaynak grubu adı.

    Not

    Küme oluşturma uzun süren bir işlemdir, bu yüzden CreateOrUpdate yerine CreateOrUpdateAsync kullanılması önemle önerilir.

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

    kustoManagementClient.Clusters.Get(resourceGroupName, clusterName);
    

Sonuç değeri ile Succeeded içeriyorsa ProvisioningState , küme başarıyla oluşturuldu.

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 aşağıdaki sürümü kullanıyorsanız, ReadWriteDatabase yerine Database kullanın.

    Ayar Önerilen değer Alan açıklaması
    clusterName mykustocluster Veritabanının oluşturulacağı Kümenizin adı.
    Dosyasında mykustodatabase Veritabanınızın adı.
    resourceGroupName testrg Kümenin oluşturulacağı kaynak grubu adı.
    softDeletePeriod 3650:00:00:00 Verilerin sorgu için kullanılabilir kalacağı zaman miktarı.
    hotCachePeriod 3650:00:00:00 Verilerin önbellekte tutulacağı zaman miktarı.
  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ı saklayın.

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

    kustoManagementClient.Clusters.Delete(resourceGroupName, clusterName);
    

Sonraki adımlar