REST Resource: corpora.documents.chunks

ทรัพยากร: กลุ่ม

Chunk เป็นส่วนย่อยของ Document ที่ถือว่าเป็นหน่วยอิสระเพื่อวัตถุประสงค์ในการแสดงเวกเตอร์และการจัดเก็บ Corpus มี Chunk ได้สูงสุด 1 ล้านราย

การแสดง JSON 
{
  "name": string,
  "data": {
    object (ChunkData)
  },
  "customMetadata": [
    {
      object (CustomMetadata)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (State)
}
ช่อง
name

string

เปลี่ยนแปลงไม่ได้ ตัวระบุ ชื่อทรัพยากร Chunk รหัส (ชื่อที่ไม่มีคำนำหน้า "corpora/*/documents/*/chunks/") จะมีอักขระที่เป็นตัวอักษรพิมพ์เล็กหรือขีดกลางยาวได้สูงสุด 40 อักขระ และต้องไม่ขึ้นต้นหรือลงท้ายด้วยขีดกลาง หากชื่อว่างเปล่าในการสร้าง ระบบจะสร้างรหัสที่ไม่ซ้ำกัน 12 อักขระแบบสุ่ม ตัวอย่าง: corpora/{corpus_id}/documents/{document_id}/chunks/123a456b789c
data

object (ChunkData)

ต้องระบุ เนื้อหาสำหรับ Chunk เช่น สตริงข้อความ จำนวนโทเค็นสูงสุดต่อกลุ่มคือ 2043
customMetadata[]

object (CustomMetadata)

ไม่บังคับ ข้อมูลเมตาที่กําหนดเองที่ผู้ใช้ระบุซึ่งจัดเก็บไว้เป็นคู่คีย์-ค่า จำนวน CustomMetadata สูงสุดต่อกลุ่มคือ 20
createTime

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาสร้าง Chunk

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาที่ Chunk ได้รับการอัปเดตล่าสุด

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
state

enum (State)

เอาต์พุตเท่านั้น สถานะปัจจุบันของ Chunk

ChunkData

ข้อมูลที่ดึงมาซึ่งแสดงถึงเนื้อหาของ Chunk

การแสดง JSON 
{

  // Union field data can be only one of the following:
  "stringValue": string
  // End of list of possible types for union field data.
}
ช่อง

ฟิลด์การรวม data

data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
stringValue

string

เนื้อหา Chunk เป็นสตริง จำนวนโทเค็นสูงสุดต่อกลุ่มคือ 2043

รัฐ

สถานะสำหรับวงจรของ Chunk

Enum
STATE_UNSPECIFIED ค่าเริ่มต้น ระบบจะใช้ค่านี้หากไม่มีการกำหนดสถานะ
STATE_PENDING_PROCESSING กำลังประมวลผล Chunk (การฝังและการจัดเก็บข้อมูลเวกเตอร์)
STATE_ACTIVE ระบบประมวลผล Chunk และพร้อมสำหรับการค้นหาแล้ว
STATE_FAILED ประมวลผล Chunk ไม่สำเร็จ

วิธีการ

batchCreate

 สร้างกลุ่ม Chunk

batchDelete

 ลบ Chunk เป็นกลุ่ม

batchUpdate

 อัปเดตเป็นกลุ่ม Chunk วินาที

create

 สร้าง Chunk

delete

 ลบ Chunk

get

 รับข้อมูลเกี่ยวกับ Chunk ที่เฉพาะเจาะจง

list

 แสดงรายการ Chunk ทั้งหมดใน Document

patch

 อัปเดต Chunk