คำอธิบาย
แสดงผลเอกสารทั้งหมดจากคอลเล็กชันที่ระบุ คุณซ้อนคอลเล็กชันได้
ไวยากรณ์
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}