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

  • Makale
  • Okumak için 2 dakika

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

Önkoşullar

C# NuGet

Kimlik Doğrulaması

Bu makaledeki örnekleri çalıştırmamız için kaynaklara erişen bir Azure AD Uygulaması ve hizmet sorumlusuna ihtiyacımız vardır. Ücretsiz bir Azure AD Uygulaması oluşturmak ve abonelik kapsamında rol ataması eklemek için Azure AD uygulaması oluşturma'ya göz atabilirsiniz. Ayrıca , ve 'nin nasıl Directory (tenant) ID elde Application ID etmek için gerekenleri de Client Secret gösterir.

Azure Veri Gezgini 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 = "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);
    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 Numarası Kümenin örnek sayısı.
    resourceGroupName testrg Kümenin oluşturulacak kaynak grubu adı.

    Not

    Küme oluşturma uzun süre çalışan bir işlemdir, bu nedenle CreateOrUpdate yerine CreateOrUpdateAsync kullanılması kesinlikle önerilir.

  2. Kümenizin başarıyla oluşturulıp oluşturulmadı olmadığını kontrol etmek için aşağıdaki komutu çalıştırın:

    kustoManagementClient.Clusters.Get(resourceGroupName, clusterName);

Sonuç ProvisioningState değeriyle birlikte Succeeded içeriyorsa küme başarıyla oluşturulmuş olur.

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 altında kullanıyorsanız ReadWriteDatabase yerine Veritabanı'ı kullanın.

    Ayar Önerilen değer Alan açıklaması
    clusterName mykustocluster Veritabanının oluşturulacak kümenizin adı.
    Databasename mykustodatabase Veritabanınız adı.
    resourceGroupName testrg Kümenin oluşturulacak kaynak grubu adı.
    softDeletePeriod 3650:00:00:00 Verilerin sorgu için kullanılabilir tutulacak süre.
    hotCachePeriod 3650:00:00:00 Verilerin önbellekte tutulacak 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ümeye ve veritabanına sahipsiniz.

Kaynakları temizleme

  • Diğer makalelerimizi takip etmek için oluşturduğunuz kaynakları kullanın.

  • Kaynakları temizlemek için kümeyi silin. Bir kümeyi silebilirsiniz. Bu küme, kümenin içinde yer alan 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