คอลเล็กชัน

คำอธิบาย

แสดงผลเอกสารทั้งหมดจากคอลเล็กชันที่ระบุ คุณซ้อนคอลเล็กชันได้

ตัวอย่าง

Web

const results = await execute(db.pipeline()
  .collection("users/bob/games")
  .sort(field("name").ascending())
  );
Swift
let results = try await db.pipeline()
  .collection("users/bob/games")
  .sort([Field("name").ascending()])
  .execute()

Kotlin

val results = db.pipeline()
    .collection("users/bob/games")
    .sort(field("name").ascending())
    .execute()

Java

Task<Pipeline.Snapshot> results = db.pipeline()
    .collection("users/bob/games")
    .sort(field("name").ascending())
    .execute();
Python
from google.cloud.firestore_v1.pipeline_expressions import Field

results = (
    client.pipeline()
    .collection("users/bob/games")
    .sort(Field.of("name").ascending())
    .execute()
)
Java
Pipeline.Snapshot results =
    firestore
        .pipeline()
        .collection("users/bob/games")
        .sort(ascending(field("name")))
        .execute()
        .get();

พฤติกรรม

หากต้องการใช้collection(...)สเตจ จะต้องปรากฏเป็นสเตจแรก ในไปป์ไลน์ (หรือไปป์ไลน์ย่อย)

ลำดับของเอกสารที่แสดงจากcollection(...)จะไม่เสถียรและ ไม่สามารถใช้เป็นข้อมูลอ้างอิงได้ Firestore จะพยายามเรียกใช้การค้นหาด้วยวิธีที่มีประสิทธิภาพมากที่สุด ซึ่งอาจเปลี่ยนลำดับได้โดยขึ้นอยู่กับสคีมา หรือการกำหนดค่าดัชนี sort(...) ขั้นตอนถัดไป สามารถใช้เพื่อรับการจัดลำดับที่แน่นอนได้

ตัวอย่างเช่น สำหรับเอกสารต่อไปนี้

Node.js

await db.collection("cities").doc("SF").set({name: "San Francsico", state: "California"});
await db.collection("cities").doc("NYC").set({name: "New York City", state: "New York"});
await db.collection("cities").doc("CHI").set({name: "Chicago", state: "Illinois"});
await db.collection("states").doc("CA").set({name: "California"});

collection สเตจสามารถใช้เพื่อดึงข้อมูลเมืองทั้งหมดในคอลเล็กชัน cities จากนั้นจัดเรียงตามชื่อจากน้อยไปมาก

Node.js

const results = await db.pipeline()
  .collection("/cities")
  .sort(field("name").ascending())
  .execute();

คำค้นหานี้จะสร้างเอกสารต่อไปนี้

  { name: "Chicago", state: "Illinois" }
  { name: "New York City", state: "New York" }
  { name: "San Francisco", state: "California" }

คอลเล็กชันย่อย

นอกจากนี้ ยังใช้collection(...)ได้เพื่อกำหนดเป้าหมายคอลเล็กชันภายใต้ ผู้ปกครองที่เฉพาะเจาะจงโดยระบุเส้นทางแบบเต็มไปยังcollection(...)

ตัวอย่างเช่น สำหรับเอกสารต่อไปนี้

Node.js

await db.collection("cities/SF/departments").doc("building").set({name: "SF Building Deparment", employees: 750});
await db.collection("cities/NY/departments").doc("building").set({name: "NY Building Deparment", employees: 1000});
await db.collection("cities/CHI/departments").doc("building").set({name: "CHI Building Deparment", employees: 900});
await db.collection("cities/NY/departments").doc("finance").set({name: "NY Finance Deparment", employees: 1200});

ในตัวอย่างนี้ เราต้องการเฉพาะแผนกของเมืองนิวยอร์ก

Node.js

const results = await db.pipeline()
  .collection("/cities/NY/departments")
  .sort(field("employees").ascending())
  .execute();

ซึ่งจะแสดงแผนกทั้งหมดภายใต้เส้นทางแบบเต็ม cities/NY/departments

  { name: "NY Building Deparment", employees: 1000 }
  { name: "NY Finance Deparment", employees: 1200 }