Skip To Content

أوامر ArcGIS Data Store REST

عند تكوين ArcGIS Data Store، تقوم بإقرانه بموقع GIS Server الذي يعمل كخادم استضافة البوابة الإلكترونية. يتم تنفيذ الإجراءات التي تغير أو تتحقق من حالة مخزن البيانات من دليل مسؤول ArcGIS Server لخادم الاستضافة كمسؤول ArcGIS Server. (تنسيق عنوان URL هو https://gisserver.domain.com:6443/arcgis/admin.) يمكنك أيضًا إزالة جهاز الاستعداد من مخزن البيانات العلائقية أو مخزن بيانات ذاكرة التخزين المؤقت التجانبي الذي يعمل في وضع الاستعداد الأساسي وإزالة جهاز الاستعداد من موقع GIS Server في دليل المسؤول ArcGIS Server. تُلخص الأجزاء التالية هذه العمليات وربطها بـ ArcGIS API documentation.

إذا لم تكن أنت مسؤول خادم الاستضافة لـ ArcGIS Server، فستحتاج إلى العمل مع هذا الشخص لإكمال المهام الموضحة هنا.

فيما يلي المسارات في دليل مسؤول ArcGIS Server، والتي تريد اتباعها للوصول إلى عمليات كل نوع من أنوع مخزن البيانات:

  • مخزن البيانات الارتباطي - انقر على عناصر > البيانات > enterpriseDatabases > <اسم مخزن البيانات> > الأجهزة > <اسم الجهاز>.
  • مخزن البيانات الكبير الزماني والمكاني - انقر على عناصر > البيانات > nosqlDatabases > AGSDataStore_bigdata_<اسم مخزن البيانات> > أجهزة > <اسم الجهاز>.
  • مخزن بيانات ذاكرة تخزين التجانب المؤقت - انقر على عناصر > البيانات > nosqlDatabases > AGSDataStore_nosql_<اسم مخزن البيانات> > أجهزة > <اسم الجهاز>.
  • مخزن الرسومات البيانية - انقر على عناصر > البيانات > nosqlDatabases > AGSDataStore_graph_<اسم مخزن البيانات> > الأجهزة > <اسم الجهاز>.
  • مخزن الكائنات - انقر على عناصر > البيانات > cloudStores > <اسم مخزن البيانات> > الأجهزة > <اسم الجهاز>.

قم بتغيير حالة جهاز مخزن البيانات

يُمكن إيقاف تشغيل الأجهزة الفردية وإعادة تشغيلها في مخزن البيانات. يمكنك أيضًا ترقية جهاز تخزين بيانات علائقي احتياطي أو جهاز تخزين بيانات ذاكرة التخزين المؤقت للتجانب ليكون الجهاز الأساسي.

لا يُسبب إيقاف جهاز مخزن البيانات الرئيسي في تجاوز فشل مخزن بيانات في النشر محليًا، حيث قد لا ترغب في تجاوز الفشل إذا كنت تقوم بمهمة الصيانة، مثل تحويل مخزن البيانات إلى وضع عدم الاتصال مؤقتًا.

مثال، ستقوم بتغيير حالة جهاز مخزن البيانات كجزءًا من سيناريوهات الترقية التالية:

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

قم بتسجيل الدخول إلى دليل مسؤول ArcGIS Server لخادم الاستضافة بصفته مسؤول موقع ArcGIS Server وانتقل إلى الجهاز المُحدد لاستخدام أي من الأوامر التالية لتغيير حالة جهاز مخزن البيانات.

  • stop
  • start
  • makePrimary (أجهزة احتياطية في مخزن بيانات علائقي أو مخزن بيانات ذاكرة التخزين المؤقت للتجانب في وضع الاستعداد الأساسي فقط)

التحقق من صحة مخزن البيانات

يُمكنك التحقق من حالة الأجهزة في مخزن البيانات باستخدام أمر validate ArcGIS Server REST.

قم بتسجيل الدخول إلى دليل مسؤول ArcGIS Server لخادم الاستضافة بصفتك مسؤول موقع ArcGIS Server، انتقل إلى أحد الأجهزة الموجودة في نوع مخزن البيانات المحدد الذي تريد التحقق منه، وانقر فوق التحقق من الصحة لمعرفة المعلومات المتعلقة بمخزن البيانات هذا. تتضمن المعلومات المهمة المتعلقة بحالة مخزن البيانات ما يلي:

  • verallhealth - القيم كما يلي:
    • Healthy - جميع المكونات الموجودة على جميع أجهزة الأعضاء يمكن الوصول إليها وتعمل على نحو جيد.
    • HealthyWithWarning - تنطبق هذه الحالة على مخازن البيانات الارتباطية ومخازن الكائنات ومخازن الرسم البياني فقط. هناك مكون واحد أو أكثر غير متاح، لكن مخزن البيانات لا يزال قابلاً للاستخدام. يتم إرجاع هذه القيمة لمخزن البيانات العلائقية عندما يكون الجهاز الأساسي سليمًا ولكن الجهاز الاحتياطي غير متاح. مخزن البيانات العلائقية ليس متوفرًا بدرجة كبيرة في هذه المرحلة. بالنسبة لمخازن الكائنات أو مخازن الرسوم البيانية التي تعمل في وضع المجموعة، قد لا يكون مخزن البيانات متاحًا بدرجة كبيرة.
    • Unhealthy - يعتبر مخزن البيانات "unhealthy" إذا كان يتعذر الوصول إلى أكثر من نصف الأجهزة الموجودة فيه ("datastore.overallhealth": "unhealthy"). يعتبر الجهاز غير صحي إذا كان يتعذر الوصول إليه ("machine.overallhealth": "غير صحي").
  • الحالة- في مخازن البيانات الارتباطية أو ذاكرة التخزين المؤقت للتجانب، تكون القيم المحتملة إما بدأت أو متوقفة. عند الإيقاف، يتعذر عليك نشر طبقات معالم مستضافة أو طبقات مشهد مستضاف إلى بوابة الإلكترونية.
  • clusterStatus - في مخازن البيانات الضخمة للموضع الزماني المكاني، تكون الحالات كما يلي:
    • أخضر - كل البيانات متاحة.
    • الأصفر- البيانات متاحة، ولكن لا تتوفر بعض أو كل النسخ المكررة من البيانات، كما أن مخزن البيانات الضخمة للموضع الزماني المكاني غير متاح بشكل كبير حاليًا. سترى دائمًا هذه الحالة إذا قمت بتكوين مخزن بيانات ضخمة للموضع الزماني المكاني على جهاز واحد. قد تظهر أيضًا هذه الحالة إذا كانت الأجهزة تقوم بإعادة توازن البيانات أو أنه يتعذر الوصول إلى جهاز واحد أو أكثر في مخزن البيانات الضخمة للموضع الزماني المكاني. إذا توفر لديك مخزن بيانات ضخمة للموضع الزماني المكاني على أكثر من جهاز وظهرت حالة صفراء، قم بالتأكيد على أن كل الأجهزة لا تزال متاحة بالتحقق من صحة كل جهاز. إذا توفرت، انتظر بضع ساعات، وتحقق مرة أخرى. إذا كانت الحالة لا تزال صفراء، افحص سجلات ArcGIS Server من الأخطاء.
    • أحمر- يتعذر الوصول إلى بعض أو كل البيانات. فحص السجلات وتصحيح الأخطاء.
  • الدور—بالنسبة للأجهزة الموجودة في مخزن بيانات علائقي أو مخزن بيانات ذاكرة التخزين المؤقت الأساسية الاحتياطية، يشير هذا إلى ما إذا كان الجهاز هو الجهاز الأساسي أو الجهاز الاحتياطي. بالنسبة لمخزن الكائنات ومخزن الرسم البياني، سيكون الدور أساسيًا لمثيل واحد، وcluster_member عند النشر في وضع المجموعة.
  • الرسائل—سترى رسائل تحذير وخطأ تتعلق بحالة تخزين البيانات هنا. على سبيل المثال، إذا قمت بالتحقق من صحة مخزن بيانات ذاكرة تخزين مؤقت تجانبي متعدد الأجهزة، فستتلقى رسالة إذا كانت بيانات ذاكرة التخزين المؤقت للمشهد غير عالية التوافر حاليًا (بمعنى آخر، توجد نسخة واحدة فقط من ذاكرة التخزين المؤقت للمشهد).

يمكنك استخدام التحقق من الصحة لما يلي:

  • تأكد من إيقاف أو تشغيل جهاز مخزن البيانات.
  • تأكد من قيام الأمر makePrimary بترقية الجهاز الاحتياطي إلى الجهاز الأساسي.
  • حدد ما إذا كان مخزن بيانات ذاكرة التخزين المؤقت للتجانب في حالة توفر عالية.
  • كخطوة أولية لاستكشاف الأخطاء وإصلاحها، إذا تعذر نشر المعالم المستضافة أو طبقات المشهد أو الوصول إليها، أو إذا لم تتمكن من إنشاء رسم بياني معرفي أو الوصول إليه.

إزالة جهاز الاستعداد

يُمكنك إزالة الجهاز الاحتياطي من مخزن البيانات الارتباطية أو مخزن بيانات ذاكرة تخزين مؤقت للتجانب الأساسي - الاحتياطي باستخدام أمر remove ArcGIS Server REST. مثال، إذا كنت ترغب في استخدام كمبيوتر مختلف لوضع الاستعداد، يُمكن إزالة جهاز الاستعداد القديم من مخزن البيانات وتثبيت ArcGIS Data Store على الجهاز الجديد وتكوين جهاز جديد بصفته جهاز استعداد.

قم بتسجيل الدخول إلى دليل مسؤول ArcGIS Server لخادم الاستضافة بصفته مسؤول موقع ArcGIS Server لاستخدام أمر إزالة.

إدارة ذاكرة التخزين المؤقت لاستجابة الاستعلام لطبقات المعالم المستضافة

بالنسبة لطبقات المعالم المستضافة التي يتم الاستعلام عنها بشكل متكرر، يمكن لمسؤول خادم الاستضافة لـ ArcGIS Server تمكين التخزين المؤقت لاستجابة الاستعلام على الطبقات الفردية للمساعدة في تحسين الأداء. بمجرد التمكين، في كل مرة تتلقى خدمة المعالم استعلامًا فريدًا، يتم تخزين المعالم والنطاق في ذاكرة التخزين المؤقت للكائنات. بناءً على المدة التي يتم فيها تخزين ذاكرات التخزين المؤقت (سياسة انتهاء صلاحية ذاكرة التخزين المؤقت) ومقدار مساحة القرص المتوفرة على الجهاز أو الأجهزة التي يتم تشغيل ملف تخزين الكائنات عليها، قد يمتلئ ملف تخزين الكائنات ويتوقف عن العمل.

بصفتك مسؤول ArcGIS Data Store، يجب عليك تكوين ملف تخزين الكائنات على جهاز أو أجهزة منفصلة عن البرامج الأخرى والتأكد من وجود مساحة قرص كافية لتخزين ذاكرات التخزين المؤقت هذه. يجب عليك أيضًا مراقبة سجلات ArcGIS Data Store لاكتشاف متى يقترب مخزن الكائنات من اكتمال السعة. يمكنك التحقق من صحة مخزن الكائنات لمعرفة النسبة المئوية لمساحة القرص المستخدمة على أجهزة تخزين الكائنات وتشغيل أداة مساعدة لتحديد ذاكرة التخزين المؤقت للطبقة الأكبر. إذا لزم الأمر، فاعمل مع مسئول ArcGIS Server لتغيير سياسة انتهاء صلاحية ذاكرة التخزين المؤقت أو لحذف ذاكرة التخزين المؤقت للطبقة الكبيرة.

تمكين التخزين المؤقت لاستجابة الاستعلام لطبقات المعالم

لتمكين التخزين المؤقت على طبقة أو طبقات في طبقة معالم مستضافة (خدمة معالم)، يجب على مسؤول ArcGIS Server لموقع خادم الاستضافة تسجيل الدخول إلى دليل مسؤول ArcGIS Server لخادم الاستضافة وإرسال الطلب التالي باستخدام عملية Update Definition REST:

{
    "layerCache": {
        "enabled": true
    }
}

إذا تم تحديث البيانات بشكل متكرر، فلا تقم بتمكين التخزين المؤقت؛ إذ أنه في كل مرة يتم فيها تحديث الطبقة، يجب إعادة بناء ذاكرة التخزين المؤقت، لذلك لن ترى أي مكاسب في الأداء عند استخدام الاستعلامات المخزنة مؤقتًا في طبقات المعالم التي يتم تحريرها بشكل متكرر.

تعيين سياسة انتهاء صلاحية ذاكرة التخزين المؤقت أو تغييرها

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

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

{
    "layerCache": {
        "enabled": true, 
        "expiration": <duration_in_days>
    }
}

اعلم أن صلاحية ذاكرات التخزين المؤقت تنتهي عند منتصف الليل بالتوقيت العالمي المنسق (UTC). إذا قمت بتعيين سياسة انتهاء الصلاحية على 1، فيمكن أن تستمر ذاكرة التخزين المؤقت لمدة تصل إلى يومين تقريبًا، اعتمادًا على وقت إنشاء ذاكرة التخزين المؤقت.

على سبيل المثال، إذا وصل العميل إلى طبقة معالم في الساعة 4:00 بالتوقيت العالمي المنسق، فستستمر ذاكرة التخزين المؤقت الخاصة به حتى الساعة 24:00 بالتوقيت العالمي المنسق في اليوم التالي.

حذف ذاكرة التخزين المؤقت للطبقة

إذا نفدت مساحة القرص من مخزن الكائنات، فسترى تحذيرًا في سجلات ArcGIS Data Store وسيعرض أمر validate REST مقدار مساحة القرص المستخدمة. لا يمكنك إضافة مساحة على القرص أو إضافة أجهزة إلى مخزن كائنات موجود، لذلك قد تحتاج إلى تنظيف ذاكرات التخزين المؤقت لتحرير مساحة على القرص. للقيام بذلك، يجب على مسؤول خادم الاستضافة لـ ArcGIS Server تعطيل التخزين المؤقت لتلك الطبقة.

{
    "layerCache": {
        "enabled": false
    }
}