คอลเล็กชัน

คำอธิบาย

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

ไวยากรณ์

Node.js

const results = await db.pipeline()
  .collection('/cities/SF/departments')
  .execute();

ตัวอย่างไคลเอ็นต์

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ไม่เสถียรและ ไม่ควรนำมาใช้ คุณใช้ขั้นตอนการจัดเรียงที่ตามมาเพื่อรับ การจัดเรียงที่แน่นอนได้

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

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}