مشاركة عبر

التشغيل السريع: إنشاء مساحة عمل Azure synapse باستخدام Azure PowerShell

  • مقالة

إن Azure PowerShell عبارة عن مجموعة من أوامر cmdlets لإدارة موارد Azure مباشرةً من PowerShell. يمكنك استخدامه في متصفحك الخاص مع Azure Cloud Shell. يمكنك أيضًا تثبيته على macOS أو Linux أو Windows.

في هذه التشغيل السريع، تتعلم إنشاء مساحة عمل Synapse باستخدام Azure PowerShell.

في حال لم يكن لديك اشتراك Azure، قم بإنشاء حساب مجاني قبل البدء.

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

  • حساب تخزين Azure Data Lake Storage Gen2

    هام

    يجب أن تكون مساحة عمل Azure Synapse قادرة على القراءة والكتابة إلى حساب ADLS Gen2 المحدد. وبالنسبة إلى أي حساب تخزين تقوم بربطه كحساب تخزين أساسي، يجب أن تكون قد قمت بتمكين مساحة الاسم الهرمية عند إنشاء حساب التخزين، كما هو موضح في صفحة إنشاء حساب تخزين.

إذا اخترت استخدام Cloud Shell، راجع نظرة عامة على Azure Cloud Shell للحصول على مزيد من المعلومات.

تثبيت وحدة Azure PowerShell محلياً

في حال اختيارك لاستخدام PowerShell محلياً، فإن هذه المقالة تتطلب منك تثبيت الوحدة النمطية Az PowerShell والاتصال بحساب Microsoft Azure باستخدام Connect-AzAccount cmdlet. ولمزيد من المعلومات حول تثبيت الوحدة النمطية Az PowerShell، راجع تثبيت Azure PowerShell.

لمزيد من المعلومات حول المصادقة باستخدام Azure PowerShell، راجع تسجيل الدخول باستخدام Azure PowerShell.

تثبيت وحدة Azure Synapse PowerShell

هام

في أثناء معاينة وحدة Az.Synapse PowerShell، يجب تثبيتها بشكلٍ منفصل باستخدام Install-Module cmdlet. بعد أن تصبح وحدة PowerShell النمطية هذه متاحة بشكل عام، ستكون جزءاً من إصدارات وحدة Az PowerShell المستقبلية وستتوفر بشكل افتراضي من داخل Azure Cloud Shell.

Install-Module -Name Az.Synapse

إنشاء مساحة عمل Azure Synapse باستخدام Azure PowerShell

  1. حدد متغيرات البيئة الضرورية لإنشاء موارد لمساحة عمل Azure Synapse.

    اسم المتغير الوصف
    StorageAccountName اسم حساب تخزين ADLS Gen2 الحالي.
    StorageAccountResourceGroup اسم مجموعة موارد حساب تخزين ADLS Gen2 الحالية.
    FileShareName اسم نظام ملفات التخزين الموجود لديك.
    SynapseResourceGroup اختر اسماً جديداً لمجموعة موارد Azure Synapse.
    المنطقة اختر إحدى مناطق Azure.
    SynapseWorkspaceName اختر اسماً فريداً لمساحة عمل Azure Synapse الجديدة.
    SqlUser اختر قيمة لاسم مستخدم جديد.
    SqlPassword اختر كلمة مرور آمنة.
    ClientIP عنوان IP العام للنظام الذي تقوم بتشغيل PowerShell منه.

  2. إنشاء مجموعة موارد كحاوية لمساحة عمل Azure Synapse:

    New-AzResourceGroup -Name $SynapseResourceGroup -Location $Region

  3. إنشاء مساحة عمل Azure Synapse Workspace:

    $Cred = New-Object -TypeName System.Management.Automation.PSCredential ($SqlUser, (ConvertTo-SecureString $SqlPassword -AsPlainText -Force))

$WorkspaceParams = @{
  Name = $SynapseWorkspaceName
  ResourceGroupName = $SynapseResourceGroup
  DefaultDataLakeStorageAccountName = $StorageAccountName
  DefaultDataLakeStorageFilesystem = $FileShareName
  SqlAdministratorLoginCredential = $Cred
  Location = $Region
}
New-AzSynapseWorkspace @WorkspaceParams

  4. الحصول على عنوان URL للويب والتطوير لمساحة عمل Azure Synapse:

    $WorkspaceWeb = (Get-AzSynapseWorkspace -Name $SynapseWorkspaceName -ResourceGroupName $StorageAccountResourceGroup).ConnectivityEndpoints.web
$WorkspaceDev = (Get-AzSynapseWorkspace -Name $SynapseWorkspaceName -ResourceGroupName $StorageAccountResourceGroup).ConnectivityEndpoints.dev

  5. إنشاء قاعدة جدار حماية للسماح لك بالوصول إلى مساحة عمل Azure Synapse من جهازك:

    $FirewallParams = @{
  WorkspaceName = $SynapseWorkspaceName
  Name = 'Allow Client IP'
  ResourceGroupName = $StorageAccountResourceGroup
  StartIpAddress = $ClientIP
  EndIpAddress = $ClientIP
}
New-AzSynapseFirewallRule @FirewallParams

  6. افتح عنوان URL على الويب لمساحة Azure Synapse المخزن في متغير البيئة WorkspaceWeb للوصول إلى مساحة العمل الخاصة بك:

    Start-Process $WorkspaceWeb

    ويب مساحة عمل Azure Synapse

  7. بمجرد التوزيع، يلزم الحصول على أذونات إضافية.

  • في مدخل Microsoft Azure، قم بتعيين مستخدمين آخرين فيما يتعلق بمساحة العمل إلى دور المساهم في مساحة العمل. للخطوات التفصيلية، راجع ⁧⁩تعيين أدوار Azure باستخدام مدخل Azure⁧⁩.
  • يجب تعيين أدوار Synapse RBAC المناسبة للمستخدمين الآخرين باستخدام Synapse Studio.
  • يجب على عضو دور Owner لحساب تخزين Azure تعيين دور Storage Blob Data Contributor إلى MSI لمساحة عمل Azure Synapse والمستخدمين الآخرين.

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

اتبع الخطوات التالية لحذف مساحة عمل Azure Synapse.

تحذير

سيؤدي حذف مساحة عمل Azure Synapse إلى إزالة محركات التحليلات والبيانات المخزنة في قاعدة البيانات الخاصة بمجمعات SQL المضمنة وبيانات تعريف مساحة العمل. لن يكون من الممكن الاتصال بنقاط نهاية SQL أو Apache Spark. سيتم حذف جميع التعليمات البرمجية للبيانات الاصطناعية (الاستعلامات ودفاتر الملاحظات وتعريفات الوظائف والتدفقات). حذف مساحة العمل لن يؤثر على البيانات الموجودة في Data Lake Store Gen2 المرتبط بمساحة العمل.

إذا لم تكن هناك حاجة إلى مساحة عمل Azure Synapse التي تم إنشاؤها في هذه المقالة، يمكنك حذفها عن طريق تشغيل المثال التالي.

Remove-AzSynapseWorkspace -Name $SynapseWorkspaceNam -ResourceGroupName $SynapseResourceGroup

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

بعد ذلك، يمكنك إنشاء تجمعات SQL أو إنشاء مجمعات Apache Spark لبدء تحليل بياناتك واستكشافها.