Riêng biệt

Mô tả

Tìm tất cả các tổ hợp giá trị riêng biệt cho một chuỗi biểu thức.

Giai đoạn distinct(...) có cú pháp tương tự như select(...) vì giai đoạn này lấy một hoặc nhiều biểu thức có thể chọn. Bạn có thể sử dụng chuỗi khi biểu thức chỉ là một giá trị tham chiếu trường:

Ví dụ

let cities = await db.pipeline()
  .collection("cities")
  .distinct("country")
  .execute();

cities = await db.pipeline()
  .collection("cities")
  .distinct(
    field("state").toLower().as("normalizedState"),
    field("country"))
  .execute();
test.firestore.js

let cities = await execute(db.pipeline()
  .collection("cities")
  .distinct("country"));

cities = await execute(db.pipeline()
  .collection("cities")
  .distinct(
    field("state").toLower().as("normalizedState"),
    field("country")));
test.firestore.js

let results = try await db.pipeline()
  .collection("books")
  .distinct([
    Field("author").toUpper().as("author"),
    Field("genre")
  ])
  .execute()
PipelineSnippets.swift

var cities = db.pipeline()
    .collection("cities")
    .distinct("country")
    .execute()

cities = db.pipeline()
    .collection("cities")
    .distinct(
        field("state").toLower().alias("normalizedState"),
        field("country")
    )
    .execute()
DocSnippets.kt

Task<Pipeline.Snapshot> cities;
cities = db.pipeline()
        .collection("cities")
        .distinct("country")
        .execute();

cities = db.pipeline()
        .collection("cities")
        .distinct(
                field("state").toLower().alias("normalizedState"),
                field("country"))
        .execute();
DocSnippets.java

from google.cloud.firestore_v1.pipeline_expressions import Field

cities = client.pipeline().collection("cities").distinct("country").execute()

cities = (
    client.pipeline()
    .collection("cities")
    .distinct(Field.of("state").to_lower().as_("normalizedState"), "country")
    .execute()
)
firestore_pipelines.py

Pipeline.Snapshot cities1 =
    firestore.pipeline().collection("cities").distinct("country").execute().get();

Pipeline.Snapshot cities2 =
    firestore
        .pipeline()
        .collection("cities")
        .distinct(toLower(field("state")).as("normalizedState"), field("country"))
        .execute()
        .get();
PipelineSnippets.java

Hành vi

Giai đoạn distinct(...) hoạt động tương tự như giai đoạn aggregate(...) không có nhóm. Xem thêm aggregate(...) và select(...).

Tìm các giá trị riêng biệt của trường

Ví dụ: để lấy danh sách mọi quốc gia trong bộ sưu tập cities sau đây:

await db.collection("cities").doc("SF").set({name: "San Francisco", state: "CA", country: "USA"});
await db.collection("cities").doc("LA").set({name: "Los Angeles", state: "CA", country: "USA"});
await db.collection("cities").doc("NY").set({name: "New York", state: "NY", country: "USA"});
await db.collection("cities").doc("TOR").set({name: "Toronto", state: null, country: "Canada"});
await db.collection("cities").doc("MEX").set({name: "Mexico City", state: null, country: "Mexico"});

Bạn có thể tìm thấy các quốc gia riêng biệt bằng cách sử dụng:

const cities = await db.pipeline()
  .collection("/cities")
  .distinct("country")
  .execute();

thao tác này sẽ tạo ra kết quả sau:

{ country: "USA" }
{ country: "Canada" }
{ country: "Mexico" }

Đầu ra riêng biệt của các biểu thức

Bạn cũng có thể tìm thấy các tổ hợp riêng biệt của nhiều trường hoặc các biểu thức phức tạp hơn. Ví dụ:

const cities = await db.pipeline()
  .collection("/cities")
  .distinct(
    field("state").toLower().as("normalized_state"),
    field("country"))
  .execute();

để nhận được:

{ country: "USA", normalized_state: "ca" }
{ country: "USA", normalized_state: "ny" }
{ country: "Canada", normalized_state: null }
{ country: "Mexico", normalized_state: null }

Hành vi tương đương

Hành vi tương đương trên các giá trị riêng biệt tuân theo cùng một ngữ nghĩa như các đẳng thức.

Điều này có nghĩa là các giá trị tương đương (ví dụ: các giá trị số tương đương về mặt toán học), bất kể loại ban đầu (số nguyên 32 bit, số nguyên 64 bit, số dấu phẩy động, số thập phân, v.v.) đều được coi là cùng một giá trị riêng biệt.

Ví dụ: trong một tập hợp numerics có nhiều tài liệu chứa các giá trị foo lần lượt là số nguyên 32 bit 1, số nguyên 64 bit 1L và số thực dấu phẩy động 1.0, distinct(...) sẽ chỉ trả về 1 kết quả.

Trong những trường hợp có các giá trị tương đương khác nhau trong tập dữ liệu, giá trị đầu ra của nhóm có thể là bất kỳ giá trị nào trong số các giá trị tương đương này. Trong ví dụ này, giá trị foo có thể được trả về dưới dạng 1, 1L hoặc 1.0.

Ngay cả khi có vẻ như là xác định, bạn không nên cố gắng dựa vào hành vi của một giá trị cụ thể được chọn.

Mức sử dụng bộ nhớ

Cách thực thi giai đoạn distinct(...) phụ thuộc vào các chỉ mục có sẵn. Khi không có chỉ mục phù hợp nào được trình tối ưu hoá truy vấn chọn, distinct(...) sẽ yêu cầu đệm tất cả các giá trị riêng biệt trong bộ nhớ.

Trong trường hợp có rất nhiều giá trị riêng biệt hoặc giá trị rất lớn (ví dụ: riêng biệt trên các giá trị lớn), giai đoạn này có thể hết bộ nhớ.

Trong những trường hợp như vậy, bạn nên áp dụng bộ lọc để giới hạn tập dữ liệu cần thực hiện distinct(...) hoặc tạo chỉ mục theo đề xuất để tránh sử dụng nhiều bộ nhớ.

Tính năng Giải thích truy vấn sẽ cung cấp thông tin về kế hoạch thực thi truy vấn thực tế và dữ liệu lập hồ sơ để hỗ trợ gỡ lỗi.