Skip To Content

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

ملاحظة:‏

At ArcGIS Enterprise 10.9.1 or later, it is recommended that you add or edit big data file shares through your portal contents page instead of ArcGIS Server Manager.

Learn more about adding big data file shares in the portal

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

ملاحظة:‏

يعد تحرير مشاركة ملف البيانات الضخمة من خلال البيان خيارًا متقدمًا. لمعرفة المزيد حول تطبيق التغييرات على مجموعات البيانات الفردية في مشاركة ملف البيانات الضخمة، راجع إدارة مشاركات ملف البيانات الضخمة في البوابة الإلكترونية. لمعرفة المزيد عن تطبيق ملف التلميحات للملفات المحددة، راجع ملف التلميحات.

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

"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 هو 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—خاصية مطلوبة تُعرّف نوع الحقل. تتضمن الخيارات ما يلي:
    • esriFieldTypeInteger— للأعداد الصحيحة.
    • esriFieldTypeSmallInteger— للأعداد الصحيحة.
    • esriFieldTypeBigInteger— للأعداد الصحيحة. ستُخزن حقول أعداد صحيحة كبيرة كحقول مزدوجة في خدمة المعالم.
    • esriFieldTypeString—للسلاسل.
    • esriFieldTypeDouble— للأضعاف أو العناصر العائمة.
    • esriFieldTypeDate—لملفات الأشكال مع حقول التاريخ. يجب أن تحتوي مجموعات البيانات المحدودة وORC والمربعة التي تضم حقولاً تمثل تاريخًا على تواريخ مُمثلةً بواسطة حقل esriFieldTypeString.
    • esriFieldTypeSingle—للقيم الفردية.
    • esriFieldTypeBlob—للقيم الثنائية. سيتم تخزين حقول Blob كحقول سلسلة في خدمة المعالم.
ملاحظة:‏

عند تحليل مشاركات ملف البيانات الضخمة من خلال GeoAnalytics Tools وحفظها كخدمة معالم، قد تتغير الأنواع. على سبيل المثال، سيصبح esriFieldTypeBigInteger في مشاركة ملف بيانات ضخمة حقل esriFieldTypeDouble في خدمة المعالم.

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

كائن 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—خاصية اختيارية لقواعد البيانات ذات الحقول الممثلة للوقت. ويشير ذلك إلى أنه إذا اُستخدمت الحقول لتحديد الوقت فستُستخدم كحقول في التحليل. إذا تم التعيين إلى "صحيح"، فلن تظهر الحقول المُستخدمة للوقت كحقول تحليل (مثل إحصائيات الملخص) وستسقط عند تشغل الأدوات. القيمة الافتراضية خطأ.