Создание кластера и базы данных Azure Data Explorer
Azure Data Explorer — это быстрая и полностью управляемая служба для аналитики большого объема потоковых данных в реальном времени, поступающих из приложений, а также с веб-сайтов, устройств Интернета вещей и т. д. Чтобы использовать обозреватель данных Azure, сначала нужно создать кластер и одну или несколько баз данных в этом кластере. Затем можно принимать (загружать) данные в базу данных и выполнять к ней запросы.
Из этой статьи вы узнаете, как создать кластер и базу данных с помощью C#, Python, Go, Azure CLI, PowerShell или шаблона Azure Resource Manager (ARM). Сведения о создании кластера и базы данных с помощью портал Azure см. в статье Краткое руководство. Создание кластера и базы данных azure Data Explorer.
Примеры кода, основанные на предыдущих версиях пакета SDK, см. в архивной статье.
Предварительные требования
Предварительные требования по методу создания кластера и базы данных:
- Подписка Azure. Создайте бесплатную учетную запись Azure.
- Visual Studio 2022 Community Edition. Включите разработку в Azure во время установки Visual Studio.
- Установите пакет NuGet Microsoft.Azure.Management.Kusto.
- Microsoft Entra приложение и субъект-служба, которые могут получать доступ к ресурсам. Сохраните идентификатор каталога (клиента),идентификатор приложения и секрет клиента.
Создание кластера Azure Data Explorer
В этом разделе описывается процесс создания кластера Azure Data Explorer. Выберите соответствующую вкладку для предпочитаемого метода создания кластера.
Создайте кластер, используя приведенный ниже код:
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, который будет использоваться для кластера. Уровень Standard Edition Уровень SKU. Емкость number Количество экземпляров кластера. имя_группы_ресурсов testrg Имя группы ресурсов, в которой будет создан кластер. Примечание
Создание кластера — это длительная операция, поэтому настоятельно рекомендуется использовать CreateOrUpdateAsync вместо CreateOrUpdate.
Чтобы проверить, успешно ли создан кластер, можно выполнить следующую команду:
clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
Подтвердите успешное создание кластера, убедившись, что результат содержит
provisioningState
значениеSucceeded
.
Создание базы данных Data Explorer Azure
В этом разделе вы создадите базу данных в кластере, созданном в предыдущем разделе.
Создайте базу данных, используя приведенный ниже код:
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 Имя базы данных. имя_группы_ресурсов testrg Имя группы ресурсов, в которой будет создан кластер. softDeletePeriod 3650:00:00:00 Время, на протяжении которого данные будут храниться таким образом, чтобы они были доступны для запроса. hotCachePeriod 3650:00:00:00 Время, на протяжении которого данные будут храниться в кэше. Выполните следующую команду, чтобы просмотреть созданную базу данных:
databaseData = (await databases.GetAsync(databaseName)).Value.Data as KustoReadWriteDatabase;
Следующий шаг
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по