Создайте кластер и базу данных Azure Data Explorer.

Azure Data Explorer — это быстрая полностью управляемая служба для аналитики большого объема потоковых данных в реальном времени, поступающих из приложений, а также с веб-сайтов, устройств Интернета вещей и т. д. Чтобы использовать обозреватель данных Azure, сначала нужно создать кластер и одну или несколько баз данных в этом кластере. Затем вы можете получать (загружать) данные в базу данных и выполнять запросы к нему.

В этой статье вы узнаете, как создать кластер и базу данных с помощью C#, Python, Go, Azure CLI, PowerShell или шаблона Azure Resource Manager (ARM). Сведения о создании кластера и базы данных с помощью портал Azure см. в кратком руководстве по созданию кластера и базы данных Azure Data Explorer.

Примеры кода на основе предыдущих версий пакета SDK см. в архивной статье.

Необходимые компоненты

Предварительные требования по методу создания кластера и базы данных:

Создание кластера Azure Data Explorer

В этом разделе описан процесс создания кластера Azure Data Explorer. Выберите соответствующую вкладку для предпочтительного метода, чтобы создать кластер.

  1. Создайте кластер, используя приведенный ниже код:

    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);
    
    Параметр Рекомендуемое значение Описание поля
    clusterName mykustocluster Необходимое имя кластера.
    skuName Standard_E8ads_v5 Номер SKU, который будет использоваться для кластера.
    tier Стандартные Уровень SKU.
    Емкость number Количество экземпляров кластера.
    resourceGroupName testrg Имя группы ресурсов, в которой будет создан кластер.

    Примечание.

    Создание кластера — это длительная операция, поэтому настоятельно рекомендуется использовать CreateOrUpdateAsync вместо CreateOrUpdate.

  2. Чтобы проверить, успешно ли создан кластер, можно выполнить следующую команду:

    clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
    
  3. Подтвердите успешное создание кластера, убедившись, что результат содержится provisioningState как Succeeded.

Создание базы данных Azure Data Explorer

В этом разделе описано, как создать базу данных в кластере, созданном в предыдущем разделе.

  1. Создайте базу данных, используя приведенный ниже код:

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

    Примечание.

    Если вы используете C# версии 2.0.0 или ниже, используйте базу данных вместо ReadWriteDatabase.

    Параметр Рекомендуемое значение Описание поля
    clusterName mykustocluster Имя кластера, в котором необходимо создать базу данных.
    databaseName mykustodatabase Имя базы данных.
    resourceGroupName testrg Имя группы ресурсов, в которой будет создан кластер.
    softDeletePeriod 3650:00:00:00 Время, на протяжении которого данные будут храниться таким образом, чтобы они были доступны для запроса.
    hotCachePeriod 3650:00:00:00 Время, на протяжении которого данные будут храниться в кэше.
  2. Выполните следующую команду, чтобы просмотреть созданную базу данных:

    databaseData = (await databases.GetAsync(databaseName)).Value.Data as KustoReadWriteDatabase;
    

Следующий шаг