블로그로 돌아가기

Performance · 2026년 6월 17일

더 작은 콘텐츠 스냅샷이 로컬라이제이션을 더 빠르게 만듭니다

로컬라이제이션 도구는 모든 화면마다 전체 Contentful 그래프를 hydrate할 필요가 없습니다. 더 작은 스냅샷은 탐색과 검토의 반응성을 유지합니다.

더 작은 콘텐츠 스냅샷이 로컬라이제이션을 더 빠르게 만듭니다

연결된 콘텐츠 그래프는 매우 거대해질 수 있습니다. 하나의 랜딩 페이지는 섹션을 참조하고, 그 섹션은 에셋과 엔트리를 참조하며, 그 엔트리는 더 많은 공유 콘텐츠를 가리킵니다.

이 깊이는 사이트를 렌더링할 때 유용합니다. 하지만 편집자가 엔트리를 찾거나 번역 상태를 확인하기만 하면 되는 경우에는 대개 필요하지 않습니다.

더 많은 데이터가 항상 더 많은 맥락을 의미하지는 않습니다

로컬라이제이션 도구는 순간마다 서로 다른 Contentful 뷰가 필요합니다.

콘텐츠 인덱스에는 엔트리를 식별하고, 검색하고, 필터링하기에 충분한 데이터가 필요합니다. 번역 요청에는 선택된 소스 필드와 보호된 구조가 필요합니다. 미리보기에는 전체 참조 그래프가 필요할 수 있습니다.

모든 뷰에 대해 가능한 가장 깊은 페이로드를 사용하는 것은 유용한 맥락을 추가하지 않으면서 비용만 발생시킵니다.

이는 다음으로 이어질 수 있습니다:

  • 느린 콘텐츠 목록
  • 큰 캐시 레코드
  • 더 높은 메모리 사용량
  • 동일한 참조의 반복적인 hydrate
  • 편집자가 작업을 시작하기 전 더 긴 대기 시간

실제 번역 모델이 아직 호출되지 않았더라도 인터페이스는 느리게 느껴집니다.

목적에 맞는 스냅샷 만들기

유용한 콘텐츠 스냅샷은 CMS의 복제본이 아닙니다. 그것은 특정 워크플로를 위해 구축된 로컬 표현입니다.

목록 및 검색의 경우, 여기에는 다음이 포함될 수 있습니다:

  • 엔트리 ID 및 콘텐츠 유형
  • 표시 필드 값
  • 구성된 검색 필드
  • 사용 가능한 로캘
  • 페이지 경로 입력값
  • 업데이트 및 게시 타임스탬프

사용자가 엔트리를 열거나 번역 요청을 생성할 때 시스템은 더 깊은 필드 데이터를 가져올 수 있습니다.

이 단계적 접근 방식은 중요한 순간에 세부 정보에 대한 접근을 유지하면서 일상적인 작업을 줄여줍니다.

제외 규칙은 구조적이어야 합니다

대규모 콘텐츠 모델에는 번역과 관련 없는 필드가 자주 포함됩니다. 에셋, 기술적 참조, 분석 구성, 내부 관계는 계속 표시되어야 할 수 있지만 재귀적으로 확장될 필요는 없을 수 있습니다.

제외 규칙은 직렬화된 페이로드 크기에 대한 취약한 가정이 아니라 필드 정체성과 콘텐츠 구조를 기준으로 작동해야 합니다. 깊은 hydration에서 제외된 필드는 캐시 새로 고침과 정리 작업 전반에서 일관되게 제외된 상태로 유지되어야 합니다.

그 예측 가능성은 하나의 응답에서 가능한 모든 바이트를 짜내는 것보다 더 중요합니다.

캐시 한계를 명시적으로 유지하세요

스냅샷도 여전히 커질 수 있습니다. 리치 텍스트, 긴 배열, 넓은 검색 필드는 비정상적으로 큰 엔트리를 만들 수 있습니다.

애플리케이션은 명확한 경계를 설정해야 합니다:

  1. 직렬화된 스냅샷 크기 측정
  2. 필수적이지 않은 캐시된 세부 정보 생략 또는 잘라내기
  3. 안정적인 식별자와 검색 메타데이터 보존
  4. 필요 시 전체 엔트리 가져오기
  5. 조용히 실패하는 대신 실제 구성 문제 드러내기

캐시는 가속 계층입니다. 작업 수행에 필요한 데이터의 유일한 사본이 되어서는 안 됩니다.

성능은 편집 흐름을 보호합니다

편집자는 지연을 불확실성으로 경험합니다. 지연된 필터는 고장 난 것처럼 보입니다. 깊은 hydration 이후 형태가 바뀌는 행은 신뢰할 수 없게 느껴집니다. 불필요한 콘텐츠 크롤링을 기다리는 일괄 작업은 범위를 불분명하게 만듭니다.

더 작은 스냅샷은 제품이 사용자가 눈앞에서 수행하는 작업에 반응할 수 있게 합니다. 상세한 CMS 데이터는 사용자가 세부 정보를 요청하는 시점에 도착하면 됩니다.

핵심 요점

로컬라이제이션 시스템은 현재의 의사결정에 필요한 만큼의 Contentful 데이터만 로드해야 합니다.

인덱스 스냅샷은 작게 유지하고, 깊은 콘텐츠는 필요 시 가져오며, 제외 규칙과 캐시 한계를 명시적으로 만드세요. 더 빠른 번역 작업은 종종 번역 이전, 즉 콘텐츠 데이터에 대한 더 절제된 접근 방식에서 시작됩니다.