رموز الخطأ: استيعاب Microsoft Planetary Computer Pro

تسرد هذه المقالة رموز الخطأ التي يمكن أن تحدث عند استيعاب البيانات الجغرافية المكانية أو حذفها من Microsoft Planetary Computer Pro GeoCatalog. استخدم هذا المرجع لتحديد سبب فشل الاستيعاب والعثور على خطوات الحل لكل نوع خطأ.

يمكن أن تحدث أخطاء الاستيعاب خلال مراحل مختلفة من عملية استيعاب البيانات، بما في ذلك عمليات المصادقة والتحقق والتحويل والتخزين (الإضافة والحذف). يوفر الجدول التالي معلومات مفصلة حول كل رمز خطأ ومعناه وخطوات لحل المشكلة.

جدول رموز الخطأ:

رمز الشرح استكشاف الأخطاء وإصلاحها
AssetTransformationError فشل النظام في تحويل الأصل أثناء الاستيعاب. • التحقق من أن ملفات الأصول بتنسيق معتمد
• تحقق من أن ملفات الأصول غير تالفة
• تأكد من إمكانية الوصول إلى عناوين URL للأصول من مصدر الاستيعاب الخاص بك
CogTransformationError فشلت عملية تحويل GeoTIFF المحسنة للسحابة (COG). • تأكد من أن ملفات المصدر هي ملفات GeoTIFF صالحة مع معلومات مرجعية جغرافية مناسبة
• التحقق من صحة ملفاتك باستخدام أدوات GDAL قبل الاستيعاب
CogTransformationTimeout تجاوزت عملية تحويل COG الحد الزمني، عادة مع ملفات كبيرة جدا. • تقسيم الملفات الكبيرة إلى تجانبات أصغر
• تحويل الملفات إلى تنسيق COG قبل الاستيعاب لتخطي التحويل
CanceledOperation تم إلغاء عملية الاستيعاب يدويا أو إنهاؤها. • لا يلزم اتخاذ أي إجراء للإلغاءات المقصودة
• التحقق من سجلات النظام لأسباب الإلغاء التلقائي
CollectionDoesNotExist معرف مجموعة STAC المشار إليه في طلب الاستيعاب غير موجود. إنشاء المجموعة قبل محاولة استيعاب العناصر فيها
EmptyAsset لا يحتوي ملف الأصل المشار إليه في عنصر STAC على محتوى أو أنه 0 بايت. • التحقق من وجود ملفات الأصول في عناوين URL المحددة
• تأكد من أن ملفات الأصول تحتوي على بيانات صالحة
ErrorsInBatchOperation فشل عنصر واحد أو أكثر في عملية استيعاب مجمع. • التحقق من تفاصيل العملية بحثا عن حالات فشل محددة في العناصر
• حاول استيعاب العناصر الفاشلة بشكل فردي لعزل المشكلات
GenericHttpIngestionError حدث خطأ HTTP عام أثناء الوصول إلى موارد الاستيعاب. • التحقق من اتصال الشبكة
• التحقق من إمكانية الوصول إلى جميع عناوين URL للأصول
• مراجعة رموز حالة HTTP في السجلات لمشكلات محددة
GenericIngestionError حدث خطأ غير محدد أثناء الاستيعاب. • تحقق من رسائل الخطأ التفصيلية وسجلات النظام
• اتصل بالدعم إذا استمرت المشكلة
ImportFileValidationFailed فشل التحقق من صحة كتالوج STAC أو ملف المجموعة. استكشاف أخطاء التحقق من صحة STAC وإصلاحها
IngestionAuthenticationFailed تعذر على GeoCatalog المصادقة على مصدر الاستيعاب. استكشاف مشكلات أذونات الوصول وإصلاحها
IngestionResourceConnectionFailed تعذر إنشاء اتصال بحاوية التخزين. استكشاف مشكلات أذونات الوصول وإصلاحها
IngestionResourceForbidden يفتقر GeoCatalog إلى أذونات للوصول إلى المورد. استكشاف مشكلات أذونات الوصول وإصلاحها
IngestionResourceTimeout تجاوز طلب الوصول إلى مصدر الاستيعاب الحد الزمني. • إعادة محاولة العملية
• التحقق من صحة خدمة Azure بحثا عن الانقطاعات
• التحقق من اتصال الشبكة بين GeoCatalog والتخزين
IngestionResourceUriNotFound الأصل المحدد أو عنوان URI للكتالوج غير موجود. استكشاف مشكلات أذونات الوصول وإصلاحها
InternalError حدث خطأ غير متوقع داخل خدمة GeoCatalog. • إعادة محاولة العملية
• إذا استمر الخطأ، فاتصل بالدعم باستخدام معرف العملية والطوابع الزمنية
InternalIntermitentError حدث خطأ داخلي مؤقت. • انتظر بضع دقائق وأعد محاولة العملية
• عادة ما يتم حل هذه الأخطاء تلقائيا
InvalidAssetHref URL الأصل في عنصر STAC غير صحيح أو غير صالح. • تأكد من أن جميع hrefs الأصول منسقة بشكل صحيح عناوين URL
• استخدام عناوين URL المطلقة، وليس المسارات النسبية
• تحقق من أن جميع عناوين URL تشير إلى موارد يمكن الوصول إليها
InvalidGeoparquet لا يفي ملف GeoParquet بمواصفات التنسيق المطلوبة. • التحقق من صحة ملفات GeoParquet باستخدام الأدوات المناسبة
• تأكد من أن الملفات تحتوي على أعمدة هندسية صالحة
InvalidInputData يحتوي عنصر STAC أو بيانات المجموعة على حقول أو قيم غير صحيحة. استكشاف أخطاء التحقق من صحة STAC وإصلاحها
InvalidStacCatalog لا تتوافق بنية كتالوج STAC مع المواصفات. استكشاف أخطاء التحقق من صحة STAC وإصلاحها
ItemAlreadyExistsInCollection يوجد بالفعل عنصر STAC بنفس المعرف في المجموعة. • استخدام معرفات فريدة لكل عنصر
• حذف العنصر الموجود قبل محاولة استيعابه مرة أخرى
ItemSizeExceeded يتجاوز عنصر STAC JSON الحد الأقصى المسموح به للحجم (1 ميغابايت). • تقليل عدد الأصول أو الخصائص في العنصر
• تقسيم عناصر كبيرة إلى عناصر أصغر متعددة
ItemTransformationError فشل معالجة عنصر STAC أو تحويله. استكشاف أخطاء التحقق من صحة STAC وإصلاحها
ManagedIdentityInfoNotFound الهوية المدارة المحددة غير موجودة أو غير مقترنة ب GeoCatalog. استكشاف مشكلات أذونات الوصول وإصلاحها
NoRecordsToDelete لم تعثر عملية الحذف على أي سجلات مطابقة. • تحقق من معرفات عناصر STAC أو معايير البحث المستخدمة للحذف
• تأكيد وجود العناصر في المجموعة المحددة
NoRecordsToPatch لم تعثر عملية التصحيح على أي سجلات مطابقة. • تأكد من وجود عناصر STAC التي تحاول تحديثها في المجموعة
• التحقق من صحة معرفات العناصر
NoRecordsToUpdate لم تعثر عملية التحديث على أي سجلات مطابقة. • تحقق من وجود العناصر قبل محاولة التحديثات
• تحقق من معرفات العناصر ومعرفات المجموعة للتأكد من دقتها
OperationIsCanceled تم إلغاء عملية الاستيعاب قبل الاكتمال. • تحقق مما إذا كان الإلغاء مقصودا
• مراجعة سجلات النظام لمشغلات الإلغاء التلقائي
OperationNotExistsInCollection معرف العملية المشار إليه غير موجود لهذه المجموعة. • تحقق من أنك تستخدم معرف العملية الصحيح والمجموعة
PatchValidation تحتوي عملية التصحيح على بيانات أو عمليات غير صحيحة. • تأكد من أن التصحيح الخاص بك يتبع مواصفات JSON Patch
• التحقق من أن عمليات التصحيح تستهدف حقولا صالحة
PostItemCollectionSizeExceeded تتجاوز دفعة العناصر التي يتم نشرها حد الحجم. • تقليل عدد العناصر في طلب واحد
• استخدام واجهة برمجة تطبيقات الاستيعاب المجمع لمجموعات البيانات الكبيرة
PublicAccessRestricted لا يسمح مورد التخزين بالوصول العام. استكشاف مشكلات أذونات الوصول وإصلاحها
StacValidationFailed لا يفي عنصر STAC بمتطلبات التحقق من الصحة. استكشاف أخطاء التحقق من صحة STAC وإصلاحها
TotalAssetsExceeded يحتوي عنصر STAC على عدد كبير جدا من الأصول (100 أصل كحد أقصى). • تقليل عدد الأصول لكل عنصر إلى أقل من 100
• تقسيم إلى عناصر متعددة