مشاركة عبر

التشغيل السريع - إنشاء مهمة Azure Stream Analytics باستخدام Bicep

  • مقالة

في هذا التشغيل السريع، يمكنك استخدام Bicep لإنشاء مهمة Azure Stream Analytics. بمجرد إنشاء الوظيفة، يمكنك التحقق من صحة النشر.

Bicep هي لغة المجال المخصصة (DSL) التي تستخدم بناء الجملة التعريفي لتوزيع موارد Azure. توفر بناء جملة مختصر، وسلامة موثوقة من النوع، ودعمًا لإعادة استخدام التعليمة البرمجية. تقدم Bicep أفضل تجربة تأليف لحلول البنية الأساسية باعتبارها تعليمة برمجية في Azure.

المتطلبات الأساسية

لإكمال هذه المقالة، تحتاج إلى اشتراك Azure. أنشئ حسابًا مجانًا.

مراجعة ملف Bicep

ملف Bicep المستخدم في هذا التشغيل السريع مأخوذ من قوالب التشغيل السريع لـ Azure.

@description('Location for the resources.')
param location string = resourceGroup().location

@description('Stream Analytics Job Name, can contain alphanumeric characters and hypen and must be 3-63 characters long')
@minLength(3)
@maxLength(63)
param streamAnalyticsJobName string

@description('You can choose the number of Streaming Units, ranging from 3, 7, 10, 20, 30, in multiples of 10, and continuing up to 660.')
@minValue(3)
@maxValue(660)

param numberOfStreamingUnits int

resource streamingJob 'Microsoft.StreamAnalytics/streamingjobs@2021-10-01-preview' = {
  name: streamAnalyticsJobName
  location: location
  properties: {
    sku: {
      name: 'StandardV2'
    }
    outputErrorPolicy: 'Stop'
    eventsOutOfOrderPolicy: 'Adjust'
    eventsOutOfOrderMaxDelayInSeconds: 0
    eventsLateArrivalMaxDelayInSeconds: 5
    dataLocale: 'en-US'
    transformation: {
      name: 'Transformation'
      properties: {
        streamingUnits: numberOfStreamingUnits
        query: 'SELECT\r\n    *\r\nINTO\r\n    [YourOutputAlias]\r\nFROM\r\n    [YourInputAlias]'
      }
    }
  }
}

output location string = location
output name string = streamingJob.name
output resourceGroupName string = resourceGroup().name
output resourceId string = streamingJob.id

مورد Azure المعرّف في ملف Bicep هو Microsoft.StreamAnalytics/StreamingJobs: إنشاء مهمة Azure Stream Analytics.

نشر ملف Bicep

  1. احفظ ملف Bicep بالاسم main.bicep على الكمبيوتر المحلي الخاص بك.

  2. بادر بتوزيع ملف Bicep باستخدام Azure CLI أو Azure PowerShell.

    az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters streamAnalyticsJobName =<job-name> numberOfStreamingUnits=<int>

    يجب توفير قيم للمعلّمات التالية:

    • streamAnalyticsJobName: استبدل <job-name> باسم مهمة Stream Analytics. يمكن أن يحتوي الاسم على أحرف أبجدية رقمية وواصلات، ويجب أن يتراوح طوله بين 3 و63 حرفاً على الأقل.
    • numberOfStreamingUnits: استبدل <int> بعدد وحدات الدفق. تتضمن القيم المسموح بها: 1 و3 و6 و12 و18 و24 و30 و36 و42 و48.

    إشعار

    عند الانتهاء من عملية النشر، يجب أن ترى رسالة تشير إلى نجاح عملية النشر.

مراجعة الموارد الموزعة

يمكنك إما استخدام مدخل Microsoft Azure للتحقق من وظيفة Azure Stream Analytics، أو استخدام النص التالي Azure CLI أو Azure PowerShell لسرد المورد.

Azure CLI

استخدم مدخل Microsoft Azure أو Azure CLI أو Azure PowerShell لإدراج الموارد الموزعة في مجموعة الموارد.

az resource list --resource-group exampleRG

تنظيف الموارد

إذا كنت تخطط للمتابعة مع البرامج التعليمية اللاحقة، فقد ترغب في ترك هذه الموارد في موضعها. عند انعدام الحاجة إلى مجموعة الموارد، احذفها، ما يؤدي إلى حذف وظيفة Azure Stream .Analytics لحذف مجموعة الموارد باستخدام Azure CLI أو Azure PowerShell:

az group delete --name exampleRG

الخطوات التالية

في هذا التشغيل السريع، أنشأت مهمة Azure Stream Analytics باستخدام Bicep وتحققت من صحة التوزيع. للتعرّف على كيفية إنشاء ملفات Bicep باستخدام Visual Studio Code، تابع إلى المقالة التالية:

التشغيل السريع: إنشاء ملفات Bicep باستخدام Visual Studio Code