ประเภทข้อมูลที่รองรับ

หน้านี้จะอธิบายประเภทข้อมูลที่ Cloud Firestore รองรับ

ประเภทข้อมูล

ตารางต่อไปนี้แสดงประเภทข้อมูลที่ Cloud Firestore รองรับ นอกจากนี้ยังอธิบายลำดับการจัดเรียงที่ใช้เมื่อเปรียบเทียบค่าประเภทเดียวกัน ดังนี้

ประเภทข้อมูล ลำดับการจัดเรียง หมายเหตุ
อาร์เรย์ ตามค่าองค์ประกอบ

ในฐานข้อมูลรุ่น Standard อาร์เรย์จะมีค่าอาร์เรย์อื่นเป็นองค์ประกอบหนึ่งไม่ได้ ในฐานข้อมูลรุ่น Enterprise อาร์เรย์อาจมีค่าอาร์เรย์เป็นองค์ประกอบหนึ่งได้

ภายในอาร์เรย์ องค์ประกอบจะคงตำแหน่งที่กำหนดไว้ เมื่อจัดเรียงอาร์เรย์ 2 รายการขึ้นไป ระบบจะจัดเรียงอาร์เรย์ตามค่าองค์ประกอบ

เมื่อเปรียบเทียบอาร์เรย์ 2 รายการ ระบบจะเปรียบเทียบองค์ประกอบแรกของแต่ละอาร์เรย์ หากองค์ประกอบแรกเท่ากัน ระบบจะเปรียบเทียบองค์ประกอบที่ 2 และเปรียบเทียบต่อไปเรื่อยๆ จนกว่าจะพบความแตกต่าง หากอาร์เรย์ไม่มีองค์ประกอบให้เปรียบเทียบแล้ว แต่มีค่าเท่ากันจนถึงจุดนั้น ระบบจะจัดลำดับอาร์เรย์ที่สั้นกว่าก่อนอาร์เรย์ที่ยาวกว่า

เช่น [1, 2, 3] < [1, 2, 3, 1] < [2] อาร์เรย์ [2] มีค่าองค์ประกอบแรกมากที่สุด อาร์เรย์ [1, 2, 3] มีองค์ประกอบเท่ากับ 3 องค์ประกอบแรกของ [1, 2, 3, 1] แต่มีความยาวสั้นกว่า

บูลีน false < true —
ไบต์ ลำดับไบต์ ในฐานข้อมูลรุ่น Standard ค่าต้องไม่เกิน 1,048,487 ไบต์ (1 MiB - 89 ไบต์) และการค้นหาจะพิจารณาเฉพาะ 1,500 ไบต์แรกเท่านั้น ในฐานข้อมูลรุ่น Enterprise จะไม่มีการจำกัดขนาดของค่า (นอกเหนือจากขีดจำกัดขนาดเอกสารและรายการดัชนี) และระบบจะพิจารณาค่าทั้งหมดตามการค้นหา
วันที่และเวลา ตามลำดับเวลา เมื่อจัดเก็บใน Cloud Firestore จะมีความแม่นยำถึงระดับไมโครวินาทีเท่านั้น โดยจะปัดเศษความแม่นยำที่เกินมาลง
เลขจุดลอยตัว ตัวเลข ความแม่นยำแบบ Double 64 บิตตาม IEEE 754 รวมถึง NaN และ +/-Infinity (ที่ปรับให้เป็นมาตรฐาน)
จุดทางภูมิศาสตร์ ตามละติจูด แล้วจึงเป็นตามลองจิจูด หากต้องการค้นหาตามระยะทาง โปรดดูการค้นหาเชิงภูมิสารสนเทศ
จำนวนเต็ม ตัวเลข 64 บิต, ลงนามแล้ว
แผนที่ ตามคีย์ แล้วตามด้วยค่า

แสดงออบเจ็กต์ที่ฝังอยู่ภายในเอกสาร เมื่อจัดทำดัชนีแล้ว คุณจะค้นหาในช่องย่อยได้ หากคุณยกเว้นค่านี้จากการจัดทำดัชนี ระบบจะยกเว้นช่องย่อยทั้งหมดจากการจัดทำดัชนีด้วย

ระบบจะจัดเรียงลำดับคีย์เสมอ เช่น หากคุณเขียน {c: "foo", a: "bar", b: "qux"} แผนที่จะจัดเรียงตามคีย์และบันทึกเป็น {a: "bar", b: "qux", c: "foo"}

ระบบจะจัดเรียงช่องแผนที่ตามคีย์และเปรียบเทียบตามคู่คีย์-ค่า โดยจะเปรียบเทียบคีย์ก่อนแล้วจึงเปรียบเทียบค่า หากคู่คีย์-ค่าแรกเท่ากัน ระบบจะเปรียบเทียบคู่คีย์-ค่าถัดไป และต่อไปเรื่อยๆ หากแผนที่ 2 รายการมีคู่คีย์-ค่าเหมือนกันทั้งหมด ระบบจะพิจารณาความยาวของแผนที่ ตัวอย่างเช่น แผนที่ต่อไปนี้เรียงจากน้อยไปมาก

{a: "aaa", b: "baz"}
{a: "foo", b: "bar"}
{a: "foo", b: "bar", c: "qux"}
{a: "foo", b: "baz"}
{b: "aaa", c: "baz"}
{c: "aaa"}
Null ไม่มี —
ข้อมูลอ้างอิง ตามองค์ประกอบเส้นทาง (คอลเล็กชัน, รหัสเอกสาร, คอลเล็กชัน, รหัสเอกสาร...) เช่น projects/[PROJECT_ID]/databases/[DATABASE_ID]/documents/[DOCUMENT_PATH]
สตริงข้อความ ลำดับไบต์ที่เข้ารหัส UTF-8 ในฐานข้อมูลรุ่น Standard ค่าต้องไม่เกิน 1,048,487 ไบต์ (1 MiB - 89 ไบต์) และการค้นหาจะพิจารณาเฉพาะ 1,500 ไบต์แรกเท่านั้น ในฐานข้อมูลรุ่น Enterprise จะไม่มีการจำกัดขนาดของค่า (นอกเหนือจากขีดจำกัดขนาดเอกสารและรายการดัชนี) และระบบจะพิจารณาค่าทั้งหมดตามการค้นหา
เวกเตอร์ ตามมิติข้อมูล แล้วตามด้วยค่าองค์ประกอบแต่ละรายการ มิติข้อมูลการฝังสูงสุดที่รองรับคือ 2048 หากต้องการจัดเก็บเวกเตอร์ที่มีมิติข้อมูลขนาดใหญ่ขึ้น ให้ใช้การลดมิติข้อมูล

การจัดเรียงประเภทค่า

เมื่อการค้นหาเกี่ยวข้องกับฟิลด์ที่มีค่าประเภทผสม Cloud Firestore จะใช้การจัดลำดับเชิงกำหนดตามการแสดงผลภายใน รายการต่อไปนี้แสดงลำดับดังกล่าว

  1. ค่า Null
  2. ค่าบูลีน
  3. ค่าจำนวนเต็มและค่าจุดลอยตัวที่จัดเรียงตามลำดับตัวเลข
  4. ค่าวันที่
  5. ค่าสตริงข้อความ
  6. ค่าไบต์
  7. ข้อมูลอ้างอิง Cloud Firestore รายการ
  8. ค่าจุดทางภูมิศาสตร์
  9. ค่าอาร์เรย์
  10. เวกเตอร์การฝัง
  11. ค่าแผนที่

การจัดเรียงตามตัวเลข

Cloud Firestore จะจัดเรียงค่าตัวเลขทั้งหมด (Integer และ Floating point) สลับกันไปมา การเปรียบเทียบจุดลอยตัวจะเป็นไปตามการจัดลำดับทั้งหมดของ IEEE 754 โดยมีข้อยกเว้นที่สำคัญคือ Cloud Firestore จะปรับค่า NaN ทั้งหมดให้เป็นมาตรฐาน และพิจารณาว่าค่านั้นน้อยกว่า -Infinity