함수: queryOnce()

호출 시그니처

function queryOnce<TQueryFn, TQuery>(queryFn): Promise<InferResultType<ExtractContext<TQuery>>>;

정의 위치: packages/db/src/query/query-once.ts:59

일회성 쿼리를 실행하고 결과를 배열로 반환합니다.

라이브 쿼리 컬렉션을 생성하고 미리 로드한 후 결과를 추출하며, 컬렉션을 자동으로 정리합니다. 다음 용도에 적합합니다:

• AI/LLM 컨텍스트 구축
• 데이터 내보내기
• 백그라운드 처리
• 테스트

타입 매개변수

TQueryFn

TQueryFn extends (q) => QueryBuilder<any>

TQuery

TQuery extends QueryBuilder<any> = ReturnType<TQueryFn>

매개변수

queryFn

TQueryFn & RootQueryFn<TQuery>

쿼리 빌더를 받아 쿼리를 반환하는 함수입니다

반환값

Promise<InferResultType<ExtractContext<TQuery>>>

쿼리 결과 배열로 확인되는 프로미스입니다

예제

// Basic query
const users = await queryOnce((q) =>
  q.from({ user: usersCollection })
)

// With filtering and projection
const activeUserNames = await queryOnce((q) =>
  q.from({ user: usersCollection })
   .where(({ user }) => eq(user.active, true))
   .select(({ user }) => ({ name: user.name }))
)

호출 시그니처

function queryOnce<TQuery>(config): Promise<InferResultType<ExtractContext<TQuery>>>;

정의 위치: packages/db/src/query/query-once.ts:83

구성 객체를 사용하여 일회성 쿼리를 실행합니다.

타입 매개변수

TQuery

TQuery extends QueryBuilder<any>

매개변수

config

QueryOnceConfig<ExtractContext<TQuery>> & object

쿼리 함수가 포함된 구성 객체입니다

반환값

Promise<InferResultType<ExtractContext<TQuery>>>

쿼리 결과 배열로 확인되는 프로미스입니다

예제

const recentOrders = await queryOnce({
  query: (q) =>
    q.from({ order: ordersCollection })
     .orderBy(({ order }) => desc(order.createdAt))
     .limit(100),
})