REST Resource: projects.datasets

المورد: مجموعة بيانات

تمثيل لمورد مجموعة البيانات.

تمثيل JSON
{
  "name": string,
  "displayName": string,
  "description": string,
  "versionId": string,
  "usage": [
    enum (Usage)
  ],
  "status": {
    object (Status)
  },
  "createTime": string,
  "updateTime": string,
  "versionCreateTime": string,
  "versionDescription": string,

  // Union field data_source can be only one of the following:
  "localFileSource": {
    object (LocalFileSource)
  },
  "gcsSource": {
    object (GcsSource)
  }
  // End of list of possible types for union field data_source.
}
الحقول
name

string

اسم المورد. التنسيق: projects/{project}/datasets/{datasetId}

displayName

string

اسم سهل القراءة للمستخدم، ويظهر في واجهة مستخدم وحدة التحكّم.

يجب أن تكون فريدة داخل المشروع.

description

string

تمثل هذه السمة وصفًا لمجموعة البيانات هذه.

versionId

string

تمثّل هذه السمة معرّف نسخة مجموعة البيانات.

usage[]

enum (Usage)

حالة الاستخدام المحددة لمجموعة البيانات هذه.

status

object (Status)

النتائج فقط. حالة نسخة مجموعة البيانات هذه.

createTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه إنشاء مجموعة البيانات لأول مرة.

updateTime

string (Timestamp format)

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

versionCreateTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه إنشاء هذه النسخة

versionDescription

string

النتائج فقط. تمثّل هذه السمة وصف هذا الإصدار من مجموعة البيانات. يتم توفيرها عند استيراد البيانات إلى مجموعة البيانات.

حقل الاتحاد data_source. تمثل هذه السمة تفاصيل حول مصدر البيانات لمجموعة البيانات. يمكن أن يكون data_source واحدًا فقط مما يلي:
localFileSource

object (LocalFileSource)

مصدر ملف محلي لمجموعة البيانات الخاصة بعملية تحميل واحدة.

gcsSource

object (GcsSource)

مصدر ملف في Google Cloud Storage لمجموعة البيانات في عملية تحميل واحدة.

الاستخدام

يحدِّد الاستخدام المكان الذي من المفترض أن تُستخدم فيه البيانات لتحديد كيفية معالجة البيانات.

عمليات التعداد
USAGE_UNSPECIFIED لم يتم ضبط استخدام مجموعة البيانات هذه.
USAGE_DATA_DRIVEN_STYLING سيتم استخدام مجموعة البيانات هذه للتصميم المستند إلى البيانات.

LocalFileSource

التفاصيل حول مصدر البيانات عندما يكون ملفًا محليًا.

تمثيل JSON
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
الحقول
filename

string

اسم الملف للملف الذي تم تحميله.

fileFormat

enum (FileFormat)

تمثّل هذه السمة تنسيق الملف الذي يتم تحميله.

FileFormat

تنسيق الملف الذي يتم تحميله.

عمليات التعداد
FILE_FORMAT_UNSPECIFIED تنسيق ملف غير محدَّد
FILE_FORMAT_GEOJSON GeoJson.
FILE_FORMAT_KML KML.
FILE_FORMAT_CSV بملف CSV.

GcsSource

تعرض هذه السمة التفاصيل حول مصدر البيانات عند توفّره في Google Cloud Storage.

تمثيل JSON
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
الحقول
inputUri

string

معرّف الموارد المنتظم (URI) لبيانات المصدر. مثلاً: gs://my_bucket/my_object

fileFormat

enum (FileFormat)

تنسيق ملف عنصر Google Cloud Storage يُستخدم هذا في الأساس للتحقق من الصحة.

الحالة

حالة مجموعة البيانات.

تمثيل JSON
{
  "state": enum (State),
  "errorMessage": string
}
الحقول
state

enum (State)

تعداد الولاية للحالة

errorMessage

string

رسالة خطأ تشير إلى سبب التعذُّر. ويكون هذا الحقل فارغًا إذا لم تكن مجموعات البيانات في حالة "إخفاق".

الحالة

تمثل هذه السمة قائمة بالحالات الخاصة بمجموعة البيانات.

عمليات التعداد
STATE_UNSPECIFIED لم يتم ضبط حالة مجموعة البيانات هذه.
STATE_IMPORTING يتم استيراد البيانات إلى مجموعة بيانات.
STATE_IMPORT_SUCCEEDED تم استيراد البيانات إلى مجموعة بيانات بنجاح.
STATE_IMPORT_FAILED تعذّر استيراد البيانات إلى مجموعة بيانات.
STATE_DELETING مجموعة البيانات قيد الحذف.
STATE_DELETION_FAILED حالة تعذُّر الحذف. تشير هذه الحالة إلى تعذّر حذف مجموعة البيانات. يمكن إعادة محاولة الحذف.
STATE_PROCESSING تجري معالجة البيانات.
STATE_PROCESSING_FAILED حالة تعذُّر المعالجة. تشير هذه الحالة إلى تعذّر المعالجة وقد يتم الإبلاغ عن أخطاء.
STATE_NEEDS_REVIEW هذه الحالة غير مستخدمة حاليًا.
STATE_PUBLISHING حالة النشر. تشير هذه الحالة إلى أنّ عملية النشر قيد التنفيذ.
STATE_PUBLISHING_FAILED حالات تعذُّر النشر تشير هذه الحالة إلى تعذُّر النشر. يمكنك إعادة محاولة النشر.
STATE_COMPLETED الحالة المكتملة. تمثل هذه الحالة مجموعة البيانات المتاحة للاستخدام المحدد لها.

الطُرق

create

تنشئ مجموعة بيانات جديدة للمشروع المحدد.

delete

تحذف مجموعة البيانات المحددة.

fetchDatasetErrors

للحصول على جميع أخطاء مجموعة البيانات.

get

تحصل على مجموعة البيانات.

list

يسرد جميع مجموعات البيانات للمشروع المحدد.

patch

لتعديل البيانات الوصفية لمجموعة البيانات.