Краткое руководство. Создание концентратора событий с помощью Azure PowerShellQuickstart: Create an event hub using Azure PowerShell

Центры событий Azure — это платформа потоковой передачи больших данных и служба приема событий, принимающая и обрабатывающая миллионы событий в секунду.Azure Event Hubs is a Big Data streaming platform and event ingestion service, capable of receiving and processing millions of events per second. Центры событий могут обрабатывать и сохранять события, данные и телеметрию, созданные распределенным программным обеспечением и устройствами.Event Hubs can process and store events, data, or telemetry produced by distributed software and devices. Данные, отправляемые в концентратор событий, можно преобразовывать и сохранять с помощью любого поставщика аналитики в реальном времени, а также с помощью адаптеров пакетной обработки или хранения.Data sent to an event hub can be transformed and stored using any real-time analytics provider or batching/storage adapters. Подробный обзор Центров событий см. в статьях Что такое Центры событий Azure? и Обзор функций Центров событий.For detailed overview of Event Hubs, see Event Hubs overview and Event Hubs features.

В этом кратком руководстве вы создадите концентратор событий с помощью Azure PowerShell.In this quickstart, you create an event hub using Azure PowerShell.

Предварительные требованияPrerequisites

Примечание

Эта статья была изменена и теперь содержит сведения о новом модуле Az для Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Вы по-прежнему можете использовать модуль AzureRM, исправления ошибок для которого будут продолжать выпускаться как минимум до декабря 2020 г.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Дополнительные сведения о совместимости модуля Az с AzureRM см. в статье Introducing the new Azure PowerShell Az module (Знакомство с новым модулем Az для Azure PowerShell).To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Инструкции по установке модуля Az см. в статье об установке Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

В рамках этого руководства вам потребуются:To complete this tutorial, make sure you have:

Использование Azure Cloud ShellUse Azure Cloud Shell

В Azure есть Azure Cloud Shell, интерактивная оболочка среды, с которой можно работать в браузере.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Для работы со службами Azure можно использовать Bash или PowerShell с Cloud Shell.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. Для запуска кода из этой статьи можно использовать предварительно установленные команды Cloud Shell. Ничего дополнительного в локальной среде устанавливать не нужно.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Начало работы с Azure Cloud ShellTo start Azure Cloud Shell:

ПараметрOption Пример и ссылкаExample/Link
Нажмите кнопку Попробовать в правом верхнем углу блока с кодом.Select Try It in the upper-right corner of a code block. При нажатии кнопки Попробовать код не копируется в Cloud Shell автоматически.Selecting Try It doesn't automatically copy the code to Cloud Shell. Открытие Azure Cloud Shell с помощью кнопки "Попробовать"
Перейдите по адресу https://shell.azure.com или нажмите кнопку Запуск Cloud Shell, чтобы открыть Cloud Shell в браузере.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. Запуск Cloud Shell в новом окнеLaunch Cloud Shell in a new window
На портале Azure в правом верхнем углу в строке меню нажмите кнопку Cloud Shell.Select the Cloud Shell button on the top-right menu bar in the Azure portal. Кнопка "Cloud Shell" на портале Azure

Чтобы выполнить код из этой статьи в Azure Cloud Shell, выполните следующие действия:To run the code in this article in Azure Cloud Shell:

  1. Запустите Cloud Shell.Start Cloud Shell.

  2. В блоке кода нажмите кнопку Копировать, чтобы скопировать код.Select the Copy button on a code block to copy the code.

  3. Вставьте код в окно сеанса Cloud Shell, нажав клавиши CTRL+SHIFT+V в Windows и Linux или CMD+SHIFT+V в macOS.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Нажмите клавишу ВВОД, чтобы выполнить код.Select Enter to run the code.

Если вы используете PowerShell локально, то для работы с этим кратким руководством необходимо запускать последнюю версию PowerShell.If you're using PowerShell locally, you must run the latest version of PowerShell to complete this quickstart. Если вам нужно выполнить установку или обновление, см. руководство по установке и настройке Azure PowerShell.If you need to install or upgrade, see Install and Configure Azure PowerShell.

Создание группы ресурсовCreate a resource group

Группа ресурсов — это логическая коллекция ресурсов Azure, она необходима для создания концентратора событий.A resource group is a logical collection of Azure resources, and you need a resource group to create an event hub.

В следующем примере создается группа ресурсов в регионе "Восточная часть США".The following example creates a resource group in the East US region. Замените значение myResourceGroup именем вашей группы ресурсов:Replace myResourceGroup with the name of the resource group you want to use:

New-AzResourceGroup –Name myResourceGroup –Location eastus

Создание пространства имен в Центрах событийCreate an Event Hubs namespace

После создания группы ресурсов создайте пространство имен Центров событий в этой группе ресурсов.Once your resource group is made, create an Event Hubs namespace within that resource group. Пространство имен Центров событий предоставляет уникальное полное доменное имя, в котором можно создать концентратор событий.An Event Hubs namespace provides a unique fully-qualified domain name in which you can create your event hub. Замените значение namespace_name уникальным именем вашего пространства имен:Replace namespace_name with a unique name for your namespace:

New-AzEventHubNamespace -ResourceGroupName myResourceGroup -NamespaceName namespace_name -Location eastus

Создание концентратора событийCreate an event hub

Теперь, когда у вас есть пространство имен Центров событий, создайте концентратор событий в этом пространстве имен:Now that you have an Event Hubs namespace, create an event hub within that namespace:
Допустимый период для MessageRetentionInDays — от 1 до 7 дней.Allowed period for MessageRetentionInDays is between 1 and 7 days.

New-AzEventHub -ResourceGroupName myResourceGroup -NamespaceName namespace_name -EventHubName eventhub_name -MessageRetentionInDays 3

Поздравляем!Congratulations! Вы создали пространство имен Центров событий и концентратор событий в этом пространстве имен с помощью Azure PowerShell.You have used Azure PowerShell to create an Event Hubs namespace, and an event hub within that namespace.

Дополнительная информацияNext steps

В этой статье вы создали пространство имен Центров событий и использовали примеры приложений для отправки событий в созданный концентратор и получения событий из него.In this article, you created the Event Hubs namespace, and used sample applications to send and receive events from your event hub. Пошаговые инструкции по отправке событий в концентратор и получении событий из него см. в следующих руководствах по отправке и получению событий:For step-by-step instructions to send events to (or) receive events from an event hub, see the Send and receive events tutorials: