مرجع واجهة برمجة التطبيقات SQL البيانات

هام

هذه الميزة في المعاينة العامة.

يدعم Databricks SQL REST API خدمات لإدارة الاستعلامات ولوحات المعلومات ومحفوظات الاستعلام ونقاط النهاية SQL.

توفر هذه المقالة نظرة عامة حول كيفية استخدام API REST. يتم سرد الارتباطات إلى كل مرجع API في نهاية المقالة.

للحصول على معلومات حول المصادقة على واجهة برمجة تطبيقات REST باستخدام رموز الوصول الشخصية، راجع المصادقة باستخدام رموز الوصول الشخصية ل Azure Databricks في Databricks SQL.

للحصول على معلومات حول المصادقة على واجهة برمجة تطبيقات REST باستخدام رموز Azure Active Directory، راجع المصادقة باستخدام رموز Azure Active Directory المميزة. على سبيل المثال، راجع استخدام رمز وصول Azure AD لمستخدم واستخدام رمز وصول Azure AD لأصل خدمة أساسي.

حدود المعدل

يدعم Api REST Databricks الحد الأقصى من طلبات 30/الثانية لكل مساحة عمل. ستتلقى الطلبات التي تتجاوز حد السعر رمز حالة استجابة 429.

تحليل الإخراج

يمكن أن يكون مفيدا تحليل أجزاء من إخراج JSON. في هذه الحالات، نوصي باستخدام الأداة المساعدة jq . لمزيد من المعلومات، راجع دليل jq. يمكنك تثبيت jq على ماك باستخدام Homebrew عن طريق تشغيل brew install jq .

بعض STRING الحقول (التي تحتوي على خطأ و المراسلة وصفي المقصود أن تستهلك من قبل واجهة المستخدم) غير منظم و يجب أن لا تعتمد على تنسيق هذه الحقول في سير العمل البرمجي.

استدعاء GET باستخدام سلسلة استعلام

بينما تتطلب معظم استدعاءات API تحديد نص JSON، يمكن GET للمكالمات تحديد الكائن الذي سيتم استرداده. على سبيل المثال، للحصول على تفاصيل نقطة نهاية SQL، قم بتشغيل:

curl ... https://<databricks-instance>/api/2.0/sql/endpoints/<endpoint-id>

المصادقة على واجهات برمجة التطبيقات SQL Databricks

واجهات برمجة التطبيقات SQL البيانات