إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
توضح هذه المقالة التغييرات في واجهات برمجة تطبيقات الاستعلامات والتنبيهات والأذونات ومصادر البيانات المضمنة في أحدث إصدار من Databricks SQL API. استخدم هذه المقالة لمساعدتك في ترحيل تطبيقاتك وتكاملاتك إلى إصدار واجهة برمجة التطبيقات الجديد.
سيستمر دعم واجهة برمجة التطبيقات القديمة لمدة ستة أشهر. تمنحك فترة الانتقال هذه الوقت للترحيل قبل التخلص التدريجي من الإصدار الأقدم.
التغييرات في واجهة برمجة تطبيقات الاستعلامات
تتضمن واجهة برمجة تطبيقات الاستعلامات الجديدة تجربة أكثر سهولة في الاستخدام مع أسماء وصفية أكثر واستجابات مرقمة الصفحات واستجابات القوائم التي يتم فرزها تلقائيا حسب وقت الإنشاء. تصف القائمة التالية التغييرات التي تم إجراؤها على واجهة برمجة تطبيقات الاستعلامات:
- مسار واجهة برمجة التطبيقات هو الآن
api/2.0/sql/queries، ويحل محل المسار القديم ل/api/2.0/preview/sql/queries. - يتضمن تعريف استعلام جديد بأسماء وأنواع حقول وصفية أكثر.
- تدعم نقطة نهاية التحديث الآن التحديثات الجزئية باستخدام
PATCHبدلا منPOST. - تدعم نقطة نهاية التحديث الآن نقل ملكية الاستعلامات. في السابق، كان يسمح بذلك فقط باستخدام [Transfer object ownership API](/API/workspace/dbsqlpermissions/transfer ownership).
- يتم الآن ترقيم استجابات نقطة نهاية القائمة باستخدام ترقيم الصفحات المستند إلى الرمز المميز.
- لم تعد نقطة نهاية القائمة تدعم التصفية حسب الاسم أو الترتيب المخصص. بدلا من ذلك، يتم إرجاع جميع الاستعلامات التي يمكن الوصول إليها وفرزها بترتيب تصاعدي حسب وقت الإنشاء.
- لم تعد نقطة نهاية الاستعادة مدعومة. يمكن متابعة استعادة الاستعلامات المهملة من خلال واجهة مستخدم Azure Databricks.
للحصول على وثائق كاملة حول واجهة برمجة تطبيقات الاستعلامات المحدثة، راجع الاستعلامات.
التغييرات في واجهة برمجة تطبيقات التنبيهات
تتضمن واجهة برمجة تطبيقات التنبيهات الجديدة تجربة أكثر سهولة في الاستخدام مع أسماء وأنواع حقول وصفية أكثر واستجابات مرقمة الصفحات لنقاط نهاية القائمة ودعم التحديثات الجزئية. تصف القائمة التالية التغييرات التي تم إجراؤها على واجهة برمجة تطبيقات التنبيهات:
- مسار واجهة برمجة التطبيقات هو الآن
api/2.0/sql/alerts، ويحل محل المسار القديم ل/api/2.0/preview/sql/alerts. - يتضمن تعريف تنبيه جديد مع استخدام أسماء وأنواع حقول وصفية أكثر.
- تدعم نقطة نهاية التحديث الآن التحديثات الجزئية باستخدام
PATCHبدلا منPOST. - تدعم نقطة نهاية التحديث الآن نقل ملكية الاستعلامات. في السابق، كان يسمح بذلك فقط باستخدام واجهة برمجة تطبيقات نقل ملكية الكائن.
- يتم الآن ترقيم استجابات نقطة نهاية القائمة باستخدام ترقيم الصفحات المستند إلى الرمز المميز.
- تقوم نقطة نهاية الحذف الآن بنقل التنبيه إلى سلة المهملات بدلا من حذف التنبيه نهائيا. سيتم تنظيف التنبيهات المهملة تلقائيا بعد 30 يوما. يمكن استعادة التنبيهات المحذوفة في غضون 30 يوما من الحذف من خلال واجهة مستخدم Azure Databricks.
للحصول على وثائق كاملة حول واجهة برمجة تطبيقات التنبيهات المحدثة، راجع التنبيهات.
التغييرات في واجهة برمجة تطبيقات الأذونات
لم تعد واجهة برمجة تطبيقات الأذونات تدعم Get object ACL و Set object ACL. استخدم واجهة برمجة تطبيقات مساحة العمل لإدارة أذونات هذه الإجراءات.
تم وضع علامة قديم على واجهة برمجة تطبيقات مصادر البيانات
تم الآن وضع علامة على واجهة برمجة تطبيقات مصادر البيانات على أنها قديمة. حاليا، تقتصر وظائفه على الحصول على قائمة بمستودعات SQL. لأن واجهة برمجة تطبيقات الاستعلامات الجديدة تدعم تمرير وإرجاع معرفات مستودع SQL بدلا من معرفات مصدر البيانات، لم يعد استدعاء API منفصل للتحويل بين مصادر البيانات ومستودعات SQL مطلوبا.