Skip To Content

التعرف على بيان مشاركة ملف البيانات الضخم

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

ملاحظة:‏

تحرير مشاركة ملف البيانات الضخمة هو خيار مُتقدّم. لمعرفة المزيد عن تطبيق التغييرات على مجموعات البيانات الفردية في البيان، راجع موضوع تحرير بيانات مشاركة ملف البيانات الضخمة في المدير. لمعرفة المزيد عن تطبيق ملف النصائح للملفات المحددة، راجع موضوع فَهم ملف النصائح.

يتكون البيان من مجموعات بيانات. يعتمد عدد مجموعات البيانات على عدد المجلدات التي تحتويها مشاركة ملف البيانات الضخمة. في المثال التالي، تتوفر خمس مجموعات بيانات:

"datasets":[
  {.. dataset1 ..},
  {.. dataset2 ..},
  {.. dataset3 ..},
  {.. dataset4 ..},
  {.. dataset5 ..},
]

في كل مجموعة بيانات، توجد خمسة كائنات من المستوى الأول قد تكون قابلة للتطبيق. في هذه الكائنات، مطلوب nameوformatوschema.

{
 "name": "dataset1", "format": {}, "schema": {}, "geometry": {}, "time": {}
}

الاسم

كائن name مطلوب، ويُعرّف اسم مجموعة البيانات. يجب أن يكون فريدًا داخل البيان.

تنسيق

كائن format مطلوب، ويُعرّف نوع البيانات المدخلة وتنسيقها.

الصيغةمثال
"format" : {
 "type" :  "< delimited | shapefile>",
 "extension" : "< csv | tsv | shp >",
 "fieldDelimiter" : "< delimiter >",
 "recordTerminator: "< terminator >",
 "quoteChar":  "< character for quotes>",
 "hasHeaderRow" :  < true | false >, 
 "encoding" : "< encoding format >"
}

مثال على استخدام ملف الشكل:

"format" : {
 "type": "shapefile", "extension": "shp"
}

مثال على استخدام ملف محدد:

"format" : {
 "type": "delimited", "extension": "csv", "fieldDelimiter": ",", "recordTerminator": "\n",  "quoteChar" "\"",
 "hasHeaderRow": true, "encoding" : "UTF-8"
}

الوصف

  • type- خاصية مطلوبة تُعرّف مصدر البيانات. ويمكن أن تكون delimited أو shapefile.
  • extension- خاصية مطلوبة تشير إلى ملحق الملف. في ملفات الشكل، يعد ذلك shp، فيما تستخدم الملفات المحددة ملحق الملف للبيانات (مثل، csv أو tsv).
  • fieldDelimiter- مطلوب عند type is delimited. يمثل هذا الحقل ما يفصل بين الحقول في الملف المحدد.
  • recordTerminator- مطلوب فقط عند type هو delimited. يمثل هذا الحقل ما يُنهِي المعالم في الملف المحدد.
  • quoteChar- مطلوب فقط عند type هو delimited. يشير الحرف إلى كيفية تحديد الاقتباسات في الملف المحدد.
  • hasHeaderRow- مطلوب فقط عند type هو delimited. ويُحدد ما إذا كان يجب أن يُعامَل الصف الأول في ملف محدد كعنوان أو كالمعلم الأول.
  • encoding- مطلوب فقط عند type هو delimited. ويُحدد ذلك نوع التكويد المستخدم.

مخطط

كائن schema مطلوب، ويُعرّف حقول ونوع حقل البيانات المُدخَلَة.

الصيغةمثال
"schema" : {
 "fields" : {
  "name": "< fieldName >",
  "type" : "< esriFieldTypeString | 
     esriFieldTypeBigInteger | 
     esriFieldTypeDouble >"
 }
}
"schema" : {
 "fields":[  {
   "name": "trackid",   "type": "esriFieldTypeString"
  },  {
   "name": "x",   "type": "esriFieldTypeDouble"
  },  {
   "name": "y",   "type": "esriFieldTypeDouble"
  },  {
   "name": "time",   "type": "esriFieldTypeBigInteger"
  },  {
   "name": "value",   "type": "esriFieldTypeBigInteger"
  }
 ]
}

الوصف

  • fields- خاصية مطلوبة تُعرّف الحقول في المخطط.
  • name- خاصية مطلوبة تشير إلى اسم الحقل. يجب أن يكون اسم الحقل فريدًا في مجموعة البيانات، ولا يحتوي إلا على أحرف أبجدية رقمية وعلامات التسطير السفلي.
  • type- خاصية مطلوبة تُعرّف نوع الحقل. تتضمن الخيارات ما يلي:
    • esriFieldTypeString- للسلاسل
    • esriFieldTypeDouble- للأضعاف أو العناصر العائمة
    • esriFieldTypeBigInteger- للأعداد الصحيحة
    • esriFieldTypeDate—لملفات الأشكال مع حقول التاريخ. مجموعات البيانات المحددة بعلامة مع حقول تُمثل التاريج يجب أن تحتوي على تواريخ يُمثلها الحقل esriFieldTypeString.

الرسوم الهندسية

كائن geometry هو كائن اختياري. يكون مطلوبًا إذا توفر لدى مجموعة البيانات تمثيل مكاني مثل نقطة أو متعدد الخطوط أو مضلع.

الصيغةمثال
"geometry" : {
 "geometryType" : "< esriGeometryType >",
 "spatialReference" : {
  "wkid": <wkidNum>,
  "latestwkid" : <latestWkidNum>
  },
 "fields": [
 {
  "name": "<fieldName1>",
  "formats": ["<fieldFormat1>"]
 },
 {
  "name": "<fieldName2>",
  "formats": ["<fieldFormat2>"]
 }
 ]
}

مثال على استخدام ملف .csv:

"geometry" : {
 "geometryType" : "esriGeometryPoint", "spatialReference" : {
  "wkid": 3857 }, "fields": [ {
  "name": "Longitude",  "formats": ["x"] }, {
  "name": "Latitude",  "formats": ["y"] }
 ]
}

مثال على استخدام ملف .tsv:

"geometry" : {
 "geometryType" : "esriGeometryPolygon", "spatialReference" : {
  "wkid": 3857 }, "fields": [ {
  "name": "Shapelocation",  "formats": ["WKT"] }
 ]
}

الوصف

ملاحظة:‏

نظرًا لأن كائن geometry هو كائن اختياري، يتم إدراج الخصائص التالية على أنها خصائص مطلوبة أو اختيارية على افتراض أن الشكل الهندسي مستخدم:

  • geometryType- مطلوب. تتضمن الخيارات ما يلي:
    • esriGeometryPoint
    • esriGeometryPolyline
    • esriGeometryPolygon
  • spatialReference- خاصية مطلوبة تشير إلى الإسناد المكاني لمجموعة البيانات.
    • wkid- حقل يشير إلى الإسناد المكاني حيث أن wkid أو latestWkid مطلوب لمجموعة بيانات بشكل هندسي.
    • latestWkid- حقل يشير إلى الإسناد المكاني في إصدار برنامج متوفر حيث يكون wkid أو latestWkid مطلوبًا لمجموعة بيانات بشكل هندسي.
  • fields- خاصية مطلوبة لمجموعات بيانات محدودة بتمثيل مكاني. يشير ذلك إلى اسم الحقل أو أسماء وتنسيقات الشكل الهندسي.
    • name- خاصية مطلوبة لمجموعات بيانات محدودة بتمثيل مكاني. تُشير إلى اسم الحقل المستخدم لتمثيل الشكل الهندسي. وقد تتوفر مثيلات متعددة منها.
    • formats- خاصية مطلوبة لمجموعات بيانات محدودة بتمثيل مكاني. تُشير إلى تنسيق الحقل المستخدم لتمثيل الشكل الهندسي. وقد تتوفر مثيلات متعددة منها.

زمن

كائن time هو كائن اختياري. يكون مطلوبًا إذا توفر لدى مجموعة البيانات تمثيل مؤقت.

الصيغةمثال
"time" : {
 "timeType" : "< instant | interval >",
 "timeReference" : {
  "timeZone" : "<timeZone >"
  },
  "fields": [
  {
   "name": "<fieldName1>",
   "formats": ["<fieldFormat1>"]
   "role": "< start | end >"
  }
 ]
}

مثال على استخدام مثيل بتنسيقات متعددة في حقول الوقت:

"time": {
 "timeType": "instant", "timeReference": {"timeZone": "UTC"}, "fields": [ {
  "name": "iso_time",  "formats": [   "yyyy-MM-dd HH:mm:ss",   "MM/dd/yyyy HH:mm"
   ]  }
 ]
}

مثال على استخدام فاصل بحقول متعددة مستخدمة لـ startTime:

"time": {
 "timeType": "interval", "timeReference": {"timeZone": "-0900"}, "fields": [ {
  "name": "time_start",  "formats": ["HH:mm:ss"],  "role" : "start"
  }, {
  "name": "date_start",  "formats": ["yyyy-MM-dd"],  "role" : "start"
  }, {
  "name": "datetime_ending",  "formats": ["yyyy-MM-dd HH:mm:ss"],  "role" : "end"
  }
 ]
}

الوصف

ملاحظة:‏

نظرًا لأن كائن time هو كائن اختياري، يتم إدراج الخصائص التالية على أنها خصائص مطلوبة أو اختيارية على افتراض أن time مستخدَم:

  • timeType- نوع الوقت مطلوب إذا تضمنت مجموعة البيانات الوقت. تتضمن الخيارات ما يلي:
    • instant- لحظة مفردة في الوقت
    • interval- لفاصل زمني مُمثّل بواسطة وقت بداية وتوقُّف
  • timeReference- حقل مطلوب إذا تم تمكين مجموعة البيانات زمنيًا، مما يُشير إلى المنطقة الزمنية (timeZone).
    • timeZone- حقل مطلوب لـ timeReference يُشير إلى تنسيق المنطقة الزمنية للبيانات. timeZone يمكن تنسيقه كما يلي:
      • استخدام الاسم الكامل للمنطقة الزمنية: Pacific Standard Time
      • استخدام اختصار المنطقة الزمنية: PST
  • fields- حقل مطلوب ليُشير إلى أسماء الحقل وتنسيقات الوقت. تكون الخصائص المطلوبة لـ fields كما يلي:
    • name- حقل مطلوب يُشير إلى اسم الحقل المستخدم لتمثيل الوقت. قد تتوفر مثيلات متعددة من هذا الكائن.
    • formats- حقل مطلوب يُشير إلى تنسيق الحقل المستخدم لتمثيل الوقت. قد توجد تنسيقات متعددة لحقل مفرد (كما هو معروض أعلاه). قد تتوفر مثيلات متعددة من هذا الكائن. لمعرفة كيفية تنسيق الحقول، راجع موضوع تنسيقات الوقت في بيان مشاركة ملف البيانات الضخمة.
    • role- حقل مطلوب عندما يكون timeType هو interval. يمكن تمثيله إما startTime أو endTime لفاصل زمني.