Skip to main content
← Glossary

TanStack Query의 Query

Query

고유한 키와 비동기 읽기 함수를 묶어 서버 사본과 요청 상태를 구독하는 TanStack Query의 단위다.

같은 뜻으로 쓰는 말

  • 쿼리
  • 데이터 Query
  • TanStack Query Query

마지막 검증

이 글에서 Query는 일반적인 질문이나 데이터베이스 문장이 아니라 TanStack Query의 서버 읽기 단위다. queryKey는 어떤 사본인지 식별하고, queryFn은 서버에서 값을 읽는다. 같은 키는 다시 가져오기, 보관과 여러 컴포넌트 사이 공유의 기준이 된다.

Query 결과에는 데이터 유무와 오류뿐 아니라 현재 다시 가져오는 중인지 같은 요청 정보도 들어 있다. 서버 데이터를 변경하는 작업과는 역할이 다르며, 이 시리즈에서는 먼저 읽은 사본의 최신성과 보존을 나누어 다룬다.

출처와 검증 범위

아래 날짜는 링크를 마지막으로 열어 본 날입니다. 문서 상단의 검증일은 글의 설명과 적용 범위를 다시 확인한 날입니다.

  1. QueriesTanStack · 공식 문서 · 확인 2026-08-09