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

ชื่อที่มนุษย์อ่านได้ ซึ่งแสดงใน UI ของคอนโซล

ต้องไม่ซ้ำกันภายในโปรเจ็กต์

description

string

คำอธิบายของชุดข้อมูลนี้

versionId

string

รหัสเวอร์ชันของชุดข้อมูล

usage[]

enum (Usage)

Use Case ที่ระบุสำหรับชุดข้อมูลนี้

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 สำหรับชุดข้อมูลสำหรับการอัปโหลดครั้งเดียว

การใช้งาน

การใช้งานจะระบุตำแหน่งที่จะใช้ข้อมูลเพื่อบอกถึงวิธีประมวลผลข้อมูล

Enum
USAGE_UNSPECIFIED ไม่ได้ตั้งค่าการใช้งานชุดข้อมูลนี้
USAGE_DATA_DRIVEN_STYLING ชุดข้อมูลนี้จะใช้สำหรับการจัดรูปแบบโดยอิงตามข้อมูล

LocalFileSource

รายละเอียดเกี่ยวกับแหล่งข้อมูลเมื่อเป็นไฟล์ในเครื่อง

การแสดง JSON
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
ช่อง
filename

string

ชื่อของไฟล์ที่อัปโหลด

fileFormat

enum (FileFormat)

รูปแบบของไฟล์ที่อัปโหลด

FileFormat

รูปแบบของไฟล์ที่กำลังอัปโหลด

Enum
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)

enum ของรัฐสำหรับสถานะ

errorMessage

string

ข้อความแสดงข้อผิดพลาดที่ระบุสาเหตุของความล้มเหลว โดยจะว่างเปล่าหากชุดข้อมูลไม่อยู่ในสถานะล้มเหลว

รัฐ

รายการสถานะของชุดข้อมูล

Enum
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

ลบชุดข้อมูลที่ระบุ

get

รับชุดข้อมูล

list

แสดงรายการชุดข้อมูลทั้งหมดสำหรับโปรเจ็กต์ที่ระบุ

patch

อัปเดตข้อมูลเมตาสำหรับชุดข้อมูล