Distinct (변환 단계)

Distinct (변환 단계)

설명

일련의 표현식에 대한 고유한 값 조합을 모두 찾습니다.

distinct(...) 단계는 하나 이상의 선택 가능한 표현식을 사용하므로 select(...)와 구문이 비슷합니다. 표현식이 필드 참조인 경우 문자열을 사용할 수 있습니다.

예시

Node.js

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

Swift

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

Kotlin
Android

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

Java
Android

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

Python

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

행동

distinct(...) 단계는 그룹이 없는 aggregate(...) 단계와 유사하게 작동합니다. aggregate(...) 및 select(...)도 참고하세요.

고유한 필드 값 찾기

예를 들어 다음 cities 컬렉션의 모든 국가 목록을 가져오려면 다음을 실행합니다.

Node.js

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"});

다음을 사용하여 고유한 국가를 찾을 수 있습니다.

Node.js

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

그러면 다음과 같은 결과가 생성됩니다.

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

표현식의 고유한 출력

여러 필드의 고유한 조합이나 더 복잡한 표현식을 찾을 수도 있습니다. 예를 들면 다음과 같습니다.

Node.js

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

다음을 가져옵니다.

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

등가성 동작

고유 값의 등가성 동작은 등식과 동일한 시맨틱스를 따릅니다.

즉, 원래 유형 (32비트 정수, 64비트 정수, 부동 소수점 숫자, 십진수 등)에 관계없이 수학적으로 동등한 숫자 값과 같은 동등한 값은 동일한 고유 값으로 간주됩니다.

예를 들어 32비트 정수 1, 64비트 정수 1L, 부동 소수점 1.0 의 foo 값이 각각 포함된 여러 문서가 있는 numerics 컬렉션에서 distinct(...)는 하나의 결과만 반환합니다.

데이터 세트에 서로 다른 동등한 값이 있는 경우 그룹의 출력 값은 이러한 동등한 값 중 하나 가 될 수 있습니다. 이 예시에서 foo 값은 1, 1L 또는 1.0으로 반환될 수 있습니다.

결정적인 것처럼 보이더라도 특정 값이 선택되는 동작에 의존하려고 하면 안 됩니다.

메모리 사용량

distinct(...) 단계가 실행되는 방식은 사용 가능한 색인에 따라 다릅니다. 쿼리 최적화 도구에서 적절한 색인을 선택하지 않으면 distinct(...)는 메모리에 모든 고유 값을 버퍼링해야 합니다.

고유한 값이 매우 많거나 값이 매우 큰 경우 (예: 큰 값에 대한 고유한 값) 이 단계에서 메모리가 부족할 수 있습니다.

이 경우 데이터 세트를 제한하는 필터를 적용하여 distinct(...)를 실행하거나 권장되는 대로 색인을 만들어 메모리 사용량이 많아지지 않도록 해야 합니다.

쿼리 설명은 디버깅에 도움이 되는 실제 쿼리 실행 계획 및 프로파일링 데이터에 대한 정보를 제공합니다.