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 | orc | parquet >",
 "extension" : "< csv | tsv | shp | orc | parquet >",
 "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 أو parquet أو orc.
  • extension- خاصية مطلوبة تشير إلى ملحق الملف. في ملفات الشكل، يعد ذلك shp، تستخدم الملفات المحددة امتداد الملف للبيانات (مثل، csv أو tsv) تقوم ملفات ORC باستخدام orc، وتستخدم الملفات المربعة parquet.
  • 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—لملفات الأشكال مع حقول التاريخ. يجب أن تحتوي مجموعات البيانات المحدودة وORC والمربعة التي تضم حقولاً تمثل تاريخًا على تواريخ مُمثلةً بواسطة حقل esriFieldTypeString.

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

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

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

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

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

مثال على استخدام ملف محدود بقيم x وy وz:

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

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

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

الوصف

ملاحظة:‏

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

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

زمن

كائن 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"}, "dropSourceFields" : true, "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 المطلوب يوضع صيغة التوقيت الزمني للبيانات. المناطق الزمنية وفقًا لـ Joda-Time. للتعرف على صيغ Joda-Time، راجع المناطق الزمنية المتاحة لـ Joda-Time. timeZone . يمكن تنسيقه كما يلي:
      • استخدام الاسم الكامل للمنطقة الزمنية: Pacific Standard Time
      • باستخدام إزاحة المنطقة الزمنية مُمثلة بالساعات: -0100 أو -01:00.
      • ربما يمكنك استخدام اختصارات المنطقة الزمنية UTC أو GMT فقط، بخلاف ذلك استخدم الاسم الكامل أو ازاحة الساعات.
  • fields- حقل مطلوب ليُشير إلى أسماء الحقل وتنسيقات الوقت. تكون الخصائص المطلوبة لـ fields كما يلي:
    • name- حقل مطلوب يُشير إلى اسم الحقل المستخدم لتمثيل الوقت. قد تتوفر مثيلات متعددة من هذا الكائن.
    • formats- حقل مطلوب يُشير إلى تنسيق الحقل المستخدم لتمثيل الوقت. قد توجد تنسيقات متعددة لحقل مفرد (كما هو معروض أعلاه). قد تتوفر مثيلات متعددة من هذا الكائن. لمعرفة كيفية تنسيق الحقول، راجع موضوع تنسيقات الوقت في بيان مشاركة ملف البيانات الضخمة.
    • role- حقل مطلوب عندما يكون timeType هو interval. يمكن تمثيله إما startTime أو endTime لفاصل زمني.
  • dropSourceFields—خاصية اختيارية لقواعد البيانات ذات الحقول الممثلة للوقت. ويشير ذلك إلى أنه إذا اُستخدمت الحقول لتحديد الوقت فستُستخدم كحقول في التحليل. إذا تم التعيين إلى "صحيح"، فلن تظهر الحقول المُستخدمة للوقت كحقول تحليل (مثل إحصائيات الملخص) وستسقط عند تشغل الأدوات. القيمة الافتراضية خاطئة.