تحويل إكسل إلى SQL – واجهة برمجة التطبيقات السحابية لـ Aspose.Cells
تقوم هذه الواجهة البرمجية REST بتحويل ملف جدول بيانات إلى تنسيق ملف SQL.
المتطلبات الأساسية
ل استخدام هذه الواجهة، يجب أن يكون لديك رمز JWT صالح تم إنشاؤه كما هو موضح في دليل المصادقة باستخدام رمز JWT. تدعم الواجهة ملفات إكسل حتى حدود الحجم المحددة في وثائق الخدمة، ويمكنها معالجة ملفات العمل المحمية بكلمة مرور عند تزويد معامل الاستعلام password.
واجهة PostConvertWorkbookToSQL البرمجية
POST https://api.aspose.cloud/v3.0/cells/convert/sql
الأمان والمصادقة
تتطلب واجهات برمجة التطبيقات السحابية لـ Aspose.Cells أمانًا ويجب المصادقة عبر رمز JWT.
معامل الاستعلام
| اسم المعامل | النوع | الوصف |
|---|---|---|
| password | string | كلمة المرور المطلوبة لفتح ملف إكسل. |
| storageName | string | اسم وحدة التخزين التي يُخزَّن فيها الملف. |
| checkExcelRestriction | bool | يشير إلى ما إذا كان سيتم فحص قيود ملف إكسل عند تعديل كائنات مرتبطة بالخلايا. |
معامل جسم الطلب
| اسم المعامل | النوع | الوصف |
|---|---|---|
| datafile | data file | ملف جدول البيانات المراد تحويله، ويُضمَّن كجزء أول في الطلب. |
الاستجابة
ترجع الواجهة كائن FileInfo يحتوي على ملف SQL المُولَّد.
| الحقل | النوع | الوصف |
|---|---|---|
| Filename | string | اسم ملف SQL (مثل example.sql). |
| FileSize | int | حجم الملف بالبايت. |
| FileContent | string | محتوى ملف SQL مشفرًا بترميز Base64. |
كودات حالة HTTP
| الكود | المعنى | الوصف |
|---|---|---|
| 200 | نجاح | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصرح به | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا | حجم الملف المرفوع يتجاوز الحد المسموح. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PostConvertWorkbookToSQL باستخدام SDKs
مواصفات واجهة PostConvertWorkbookToSQL
تُعرِّف مواصفات OpenAPI واجهة برمجة تفاعلية عامة وتتيح تنفيذ تفاعلات REST مباشرة من خلال متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يوضح المثال التالي كيفية إجراء المكالمات إلى الواجهة السحابية باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. فهي تُدار بالتفاصيل من المستوى المنخفض، وتتيح لك التركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells باستخدام SDKs مختلفة:
واجهات برمجية أخرى تنفذ هذه الوظيفة
-
POST /cells/{name}/saveAs – تحفظ ملف عمل بتنسيق مختلف وتخزن الناتج في وحدة التخزين المحددة.
-
PUT /cells/convert – تحول ملف عمل إلى تنسيق آخر مع إعدادات اختيارية وترد بالنتيجة في الاستجابة.
-
GET /cells/{name} – تسترجع ملف عمل مع إعدادات تحويل اختيارية.
ملاحظات
- عند تحويل ملفات إكسل المحمية بكلمة مرور، تأكد من تزويد معامل الاستعلام
password؛ وإلا فشلت العملية مع خطأ 400. - تُرجع الخدمة محتوى ملف SQL كنص مشفر بـ Base64؛ ويجب فك التشفير قبل حفظه في ملف
.sql.
ملفات عينات
حمّل ملف عمل إكسل تجريبي هنا ونتائج SQL جاهزة هنا لاختبار الواجهة بسرعة.