التشغيل السريع: استخدم محرر الاستعلام في مدخل Microsoft Azure (معاينة) للاستعلام عن قاعدة بيانات azure SQL

ينطبق على: قاعدة بيانات Azure SQL

محرر الاستعلام هو أداة في مدخل Microsoft Azure لتشغيل استعلامات SQL مقابل قاعدة البيانات في Azure SQL Database أو مستودع البيانات في Azure Synapse Analytics.

ستتعلم في التشغيل السريع هذا على كيفية استخدام Query Editor لتشغيل استعلامات Transact-SQL (T-SQL) مقابل أي قاعدة بيانات.

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

يشترط الانتهاء التشغيل السريع هذا توافر قاعدة بيانات نموذجية لقاعدة بيانات AdventureWorksLT. قد ترغب اختيارياً في تعيين مسؤول Microsoft Azure Active Directory للخادم.

إنشاء قاعدة بيانات باستخدام البيانات النموذجية

إذا لم يكن لديك نسخة عمل من قاعدة البيانات النموذجية لقاعدة بيانات AdventureWorksLT في قاعدة بيانات SQL، فسيساعدك التشغيل السريع التالي على إنشاء قاعدة بيانات إنشاءً سريعاً:

التشغيل السريع: أنشأ قاعدة بيانات أحادية في قاعدة بيانات Azure SQL باستخدام مدخل Microsoft Azure أو PowerShell أو Azure CLI

تعيين مسؤول Microsoft Azure Active Directory للخادم (اختياري)

يمكنك تهيئة مسؤول Microsoft Azure Active Directory (Azure AD) من استخدام هوية واحدة لتسجيل الدخول إلى مدخل Microsoft Azure وقاعدة البيانات الخاصة بك. إذا كنت ترغب في استخدام Azure AD للاتصال بمحرر الاستعلام، فاتبع الخطوات التالية.

هذه العملية اختيارية، يمكنك بدلاً من ذلك استخدام مصادقة SQL للاتصال بمحرر الاستعلام.

ملاحظة

• تُعد حسابات البريد الإلكتروني (على سبيل المثال، outlook.com gmail.com yahoo.com وما إلى ذلك) غير مدعومة حتى الآن كمسؤولي Azure AD. تأكد من اختيار مستخدم تم إنشاؤه إما في الأصل في Azure AD أو مستخدم تم دمجه في Azure AD.
• ينجح تسجيل دخول مسؤول Azure AD من خلال الحسابات التي مكنت خاصية المصادقة الثنائية، ولكن لا يدعم محرر الاستعلام المصادقة الثنائية.

1. انتقل إلى خادم قاعدة بيانات لغة الاستعلامات المركبة SQL في مدخل Microsoft Azure.

2. اختر من قائمة خادم SQL مسؤول دليل نشط.

3. اختر من شريط أدوات صفحة مسؤول دليل SQL نشطتعيين مسؤول.

   

4. أدخل في صفحة إضافة مسؤول، في مربع البحث، مستخدماً أو مجموعة للبحث عنها، وحددها كمسؤول، ثم اختر زر تحديد.

5. في شريط أدوات صفحة مسؤول دليل نشط في خادمSQL اختر حفظ.

استخدم محرر استعلام SQL

1. سجل الدخول إلى مدخل Microsoft Azure واختر قاعدة البيانات التي تريد الاستعلام عنها.

2. في قائمة قاعدة بيانات SQL، اختر محرر الاستعلام (معاينة).

   

إنشاء اتصال بقاعدة البيانات

على الرغم من تسجيل الدخول إلى المدخل، إلا أنك لا تزال بحاجة إلى تقديم بيانات اعتماد للوصول إلى قاعدة البيانات. يمكنك الاتصال باستخدام مصادقة SQL أو Microsoft Azure Active Directory للاتصال بقاعدة البيانات.

اتصل باستخدام مصادقة SQL

1. في صفحة تسجيل الدخول، اسفل مصادقة خادم SQL،، أدخل تسجيل دخول وكلمة المرورللمستخدمالذي يمكنه الوصول إلى قاعدة البيانات. إذا لم تكن متأكداً، فاستخدم تسجيل الدخول وكلمة المرور لمشرف الخادم الخاص في خادم قاعدة البيانات.

   

2. حدد "OK".

اتصل باستخدامMicrosoft Azure Active Directory

في محرر الاستعلام (معاينة) ، انظر إلى صفحة تسجيل الدخول في قسم مصادقة دليل نشط. ستجرى المصادقة تلقائيا، لذلك إذا كنت مسؤولاً في Azure AD إلى قاعدة البيانات، فسوف تظهر رسالة مفادها نجاح تسجيل الدخول. ثم حدد الزر متابعة كـ<معرف المستخدم أو المجموعة>. إذا كانت الصفحة تشير إلى أنه لم يتم تسجيل الدخول بنجاح، فقد تحتاج إلى تحديث الصفحة.

قاعدة البيانات في قاعدة بيانات Azure SQL

يجب تشغيل الاستعلامات النموذجية التالية بنجاح مقابل قاعدة بيانات نموذج AdventureWorksLT.

شغل واختر استعلام

1. أدخل الاستعلام التالي في جزء محرر الاستعلام:

    SELECT TOP 20 pc.Name as CategoryName, p.name as ProductName
    FROM SalesLT.ProductCategory pc
    JOIN SalesLT.Product p
    ON pc.productcategoryid = p.productcategoryid;
   

2. اختر تشغيل ثم قم بمراجعة الإخراج في جزء النتائج.

   

3. يمكنك بشكل اختياري حفظ الاستعلام كملف .sql أو ترحيل البيانات التي تم استعادتها كملف .json أو .csv أو .xml.

شغل إدخال استعلام

شغل عبارة أدخل Transact-SQL التالية لإضافة منتج جديد إلى الجدول SalesLT.Product.

1. استبدال الاستعلام السابق بهذا الاستعلام.

   INSERT INTO [SalesLT].[Product]
          ( [Name]
          , [ProductNumber]
          , [Color]
          , [ProductCategoryID]
          , [StandardCost]
          , [ListPrice]
          , [SellStartDate]
          )
   VALUES
          ('myNewProduct'
          ,123456789
          ,'NewColor'
          ,1
          ,100
          ,100
          ,GETDATE() );
   

2. حدد Run لإدخال صف جديد في الجدول Product. يعرض جزء الرسائلنجاح الاستعلام: الصفوف المغيرة: 1.

تشغيل استعلام UPDATE

تشغيل عبارة تحديث T-SQL التالي لتعديل المنتج الجديد.

1. استبدال الاستعلام السابق بهذا الاستعلام.

   UPDATE [SalesLT].[Product]
   SET [ListPrice] = 125
   WHERE Name = 'myNewProduct';
   

2. حدد "Run" لتحديث الصف المحدد في الجدول Product. يعرض جزء الرسائلنجاح الاستعلام: الصفوف المغيرة: 1.

تشغيل استعلام DELETE

شغل العبارة التالية حذف Transact-SQL لإزالة المنتج الجديد.

1. استبدال الاستعلام السابق بهذا الاستعلام:

   DELETE FROM [SalesLT].[Product]
   WHERE Name = 'myNewProduct';
   

2. حدد "Run" لحذف الصف المحدد في الجدول Product. يعرض جزء الرسائلنجاح الاستعلام: الصفوف المغيرة: 1.

استكشاف الأخطاء وإصلاحها

هناك بعض الأشياء التي يجب معرفتها عند استخدام محرر الاستعلام.

تهيئة إعدادات الشبكة المحلية

إذا ظهر لك أحد الأخطاء التالية في محرر الاستعلام:

• قد تمنع إعدادات الشبكة المحلية محرر الاستعلام من إصدار الاستعلامات. يُرجى النقر هنا للحصول على إرشادات حول كيفية تكوين إعدادات الشبكة
• تعذر إنشاء اتصال بالخادم. قد يشير هذا إلى وجود مشكلة في تكوين جدار الحماية المحلي أو إعدادات وكيل الشبكة

تحدث هذه الأخطاء لأن محرر الاستعلام يستخدم المنفذين 443 و1443 للتواصل. ستحتاج إلى التأكد من تمكين حركة بروتوكول نقل النص التشعبي الآمن الصادرة على هذه المنافذ. ستنقلك التعليمات أدناه إلى كيفية القيام بذلك، اعتمادا على نظام التشغيل الخاص بك. قد تحتاج إلى العمل مع شركة تقنية المعلومات لمنح الموافقة لفتح هذا الاتصال على الشبكة المحلية.

الخطوات إلى Windows

1. افتح Windows Defender Firewall.
2. في القائمة اليسرى، حدد Advanced settings.
3. في جدار حماية Windows Defender مع الأمان المتقدم، اختر القواعد الصادرة في القائمة من الجانب الأيسر.
4. حدد New Rule... في القائمة الموجودة بالجانب الأيمن.

في معالج القاعدة الصادرة الجديدة اتبع الخطوات التالية:

1. اختر المنفذ كنوع القاعدة التي تريد إنشاءها. حدد "Next".
2. حدد TCP.
3. اختر منافذ محددة عن بعد وأدخل "443، 1443". ثم حدد Next.
4. حدد "السماح بالاتصال إذا كان آمناً".
5. حدد Next ثم حدد Next مرة أخرى.
6. حافظ على تحديد "المجال" و"خاص" و"عام".
7. أدخل اسم القاعدة، على سبيل المثال "الوصول إلى محرر استعلام Azure SQL" وأدخل وصف اختياري. ثم حدد إنهاء.

خطوات تشغيل Mac

1. افتح تفضيلات النظام (قائمة Apple > تفضيلات النظام).
2. حدد Security & Privacy.
3. حدد «جدار الحماية».
4. إذا تم إيقاف تشغيل جدار الحماية، فحدد Click the lock to make changes في الجزء السفلي وحدد Turn on Firewall.
5. حدد Firewall Options.
6. في نافذة Security & Privacy حدد هذا الخيار: "السماح تلقائياً للبرامج الموقعة باستقبال الاتصالات الواردة".

خطوات لتطبيق لينكس

تشغيل هذه الأوامر لتحديث الجداول IPTABLEs

sudo iptables -A OUTPUT -p tcp --dport 443 -j ACCEPT
sudo iptables -A OUTPUT -p tcp --dport 1443 -j ACCEPT

معلومات الاتصال

• بالنسبة للاتصالات العامة بمحرر الاستعلام، يتعين عليك إضافة عنوان IP صادر إلى قواعد جدار الحماية المسموح بها للخادم من أجل الوصول إلى قواعد البيانات ومستودعات البيانات الخاصة بك.
• إذا كان لديك اتصال ارتباط خاص تم إعداده على الخادم وكنت تتصل بمحرر الاستعلام من عنوان IP في الشبكة الظاهرية الخاصة، يعمل محرر الاستعلام دون الحاجة إلى إضافة عنوان IP الخاص بالعميل إلى قواعد جدار حماية خادم قاعدة بيانات SQL.
• إن أذونات التحكم في الوصول المستندة إلى الأدوار (RBAC) الأساسية والمطلوبة لاستخدام محرر الاستعلام هي "وصول القراءة إلى الخادم وقاعدة البيانات". يمكن لأي شخص لديه هذا المستوى من الوصول إلى ميزة محرر الاستعلام. للحد من الوصول إلى مستخدمين معينين، يجب منعهم من تسجيل الدخول إلى محرر الاستعلام باستخدام Microsoft Azure Active Directory أو بيانات اعتماد مصادقة SQL. إذا لم يتمكنوا من تعيين أنفسهم كمسؤول AAD في الخادم أو الوصول أو إضافة حساب مسؤول SQL، يجب ألا تكون قادراً على استخدام محرر الاستعلام.
• إذا رأيت رسالة الخطأ "The X-CSRF-Signature header could not be validated"، فاتخذ الإجراء التالي لحل المشكلة:
  • تحقق من ضبط ساعة الكمبيوتر على التوقيت الصحيح والمنطقة الزمنية. يمكنك أيضاً محاولة مطابقة المنطقة الزمنية للكمبيوتر مع Azure من خلال البحث عن المنطقة الزمنية لموقع المثيل كشرق الولايات المتحدة والمحيط الهادئ وما إلى ذلك.
  • إذا كنت على شبكة وكيل، فتأكد من عدم تعديل أو إسقاط عنوان الطلب "X-CSRF-Signature".

التقييدات

• لا يدعم محرر الاستعلام الاتصال master بقاعدة البيانات. للاتصال بقاعدة بيانات master، استكشف عميلاً واحداً أو أكثر في الخطوات التالية.
• لا يمكن لمحرر الاستعلام الاتصال بـقاعدة بيانات نسخة متماثلة مع ApplicationIntent=ReadOnly. للاتصال بهذه الطريقة من عميل غني، يمكنك الاتصال باستخدام SQL Server Management Studio وتحديد ApplicationIntent=ReadOnly في 'Additional Connection Parameters' في خيارات الاتصال.
• محرر الاستعلام لديه مهلة 5 دقائق لتنفيذ الاستعلام. لتشغيل استعلامات أطول، استكشف عميلاً واحداً أو أكثر في الخطوات التالية.
• يدعم محرر الاستعلام الإسقاط الأسطواني فقط لأنواع بيانات الجغرافيا.
• لا يدعم محرر الاستعلام IntelliSense لجداول قاعدة البيانات وطرق عرضها، ولكنه يدعم الإكمال التلقائي للأسماء التي تم كتابتها بالفعل. للحصول على دعم IntelliSense، استكشف عميلاً واحداً أو أكثر في الخطوات التالية.
• يؤدي الضغط على F5 إلى تحديث صفحة محرر الاستعلام. سيتم فقد أي استعلام يتم العمل عليه.

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

يمكنك الاستعلام عن قاعدة بيانات في Azure SQL Database مع مجموعة متنوعة من العملاء، بما في ذلك:

• استخدم Management Studio (SSMS) للاتصال والاستعلام عن Azure SQL Database أو مثيل Azure SQL المُدار.
• استخدم Visual Studio Code للاتصال والاستعلام.
• استخدم Azure Data Studio للاتصال والاستعلام عن Azure SQL Database.

تعرف على المزيد عن Azure SQL Database في المقالات التالية:

• تعرف على المزيد عن Transact-SQL (T-SQL) المدعوم في Azure SQL Database.
• مسرد مصطلحات Azure SQL.
• ماذا يُقصد بـ Azure SQL؟