Let (변환 단계)

설명

파이프라인의 후속 단계에서 참조할 수 있는 임시 변수를 정의합니다.

let(...) 단계에서 생성된 변수는 후반 단계에서 필드에 명시적으로 할당되지 않는 한 (예: add_fields(...) 또는 select(...) 사용) 최종 결과에 포함되지 않습니다. 이를 통해 출력 문서를 어지럽히지 않고 복잡한 로직을 재사용 가능한 작은 구성요소로 나누어 간소화할 수 있습니다. let(...) 단계는 하위 파이프라인이 상위 문서의 범위에서 값을 참조해야 하는 상관관계가 있는 하위 파이프라인에 특히 유용합니다.

예시

Node.js

const results = await db.pipeline()
  .collection("/awards")
  // `let(...)` referred to as `define(...)` in the Web SDK.
  .define(rand().as("r"))
  .addFields(
    switchOn(
      lessThan(variable("r"), 0.05), constant("rare"),
      lessThan(variable("r"), 0.25), constant("uncommon"),
      constant("common")).as("random_score"))
  .execute();

동작

변수와 필드의 차이

필드는 문서 내에 저장된 데이터를 나타내지만 변수는 파이프라인 실행 중에만 존재하는 임시 값입니다.

필드 변수
목적 문서에 필드 액세스 또는 저장 파이프라인 실행 중에 임시 값을 생성하거나 액세스
SDK 사용 field("name") variable("name")
범위 현재 문서에 로컬 파이프라인 및 하위 파이프라인에 전역
정의되지 않은 참조 absent로 평가됩니다. 런타임 오류를 생성합니다.

범위:

필드는 로컬 문서로 범위가 지정되지만 변수는 별도의 범위에 정의되며 여러 문서를 함께 '병합'하는 단계 (예: aggregate(...) 또는 distinct(...))가 처음 발생할 때까지 단계 전반에서 액세스할 수 있습니다. 여러 문서를 '병합'하는 단계에서는 변수 참조를 이후에 사용할 수 없습니다. 이전 단계의 결과를 함께 병합하면 변수에 대한 값이 더 이상 하나가 아니기 때문입니다.

해야 함: 문서 필드를 필터링한 후 변수를 참조합니다.

Node.js

const results = db.pipeline()
  .collection("/awards")
  .define(min(field("score").abs(), constant(100)).as("normalized_score"))
  .select(field("__name__"), field("owner_id"))
  // Successfully able to use the variable.
  .where(variable("normalized_score").greaterThan(10))
  .execute();

안됨: 집계 후에 변수를 참조합니다.

Node.js

const results = db.pipeline()
  .collection("/awards")
  .define(min(field("score").abs(), constant(100)).as("normalized_score"))
  .aggregate({
    accumulators: [ field("score").avg().as("avg_score") ],
    groups: [ field("owner_id") ]
  })
  // Attempting to use the variable throws a request validation error.
  .where(variable("normalized_score").greaterThan(10))
  .execute();

정의되지 않은 참조:

정의되지 않은 필드를 참조하는 것은 괜찮지만 (absent로 평가됨) 정의되지 않은 변수를 참조하려고 하면 요청 유효성 검사 중에 실패합니다. 이러한 의미에서 필드 참조는 런타임에 지도에서 조회를 실행하는 것으로 볼 수 있으며 변수 참조는 정적으로 컴파일된 프로그래밍 언어의 변수와 더 유사합니다.

전역 범위 및 하위 쿼리

중첩된 파이프라인을 사용할 때는 변수가 필수입니다. 하위 파이프라인은 자체 범위에서 실행되며 현재 처리 중인 문서의 필드에만 액세스할 수 있습니다. 하위 쿼리 내에서 '상위' 문서의 값을 사용하려면 먼저 let(...) 단계를 사용하여 변수로 정의해야 합니다.

Node.js

// Fetch reviewers alongside their negative reviews.
const pipeline = db.pipeline()
  .collection("/reviewers")
  // `let(...)` referred to as `define(...)` in the Web SDK.
  .define(field("__name__").as("reviewer_name"))
  .select("__name__", array(db.pipeline().collectionGroup("reviews")
    .where(field("author").equals(variable("reviewer_name")))
    .where(field("rating").lessThan(2))
    .select("review", "rating")).as("negative_reviews"))
  .execute();

중복 변수

이전 let(...) 단계에서 이미 정의된 이름으로 변수를 정의하면 이전 변수가 덮어쓰여집니다. 이는 파이프라인이 진행됨에 따라 임시 상태를 업데이트하는 데 사용할 수 있습니다.

하위 파이프라인에서 참조되는 변수는 많은 프로그래밍 언어에서 볼 수 있는 어휘 범위 지정 규칙을 따르며 가장 가까운 (상위) 파이프라인에서 정의된 동일한 이름의 변수를 참조합니다.

add_fields(...)와 비교

let(...) 단계는 add_fields(...) 단계와 유사하게 작동하지만 문서에 필드를 추가하는 대신 변수에 값을 할당합니다.