Shopify 마켓 관계 수집: 버전이 바뀌면 페이지 커서를 재시작해야 하는 이유
관계 ID가 유지되어도 재구축 중 커서는 달라질 수 있다. 수집 세대를 나누어 혼합 목록의 인수를 막는다.
같은 관계 ID가 같은 읽기 세대를 뜻하지는 않는다
관계 ID의 안정성과 페이지 커서의 안정성은 다르다. 관계 버전 변경을 확인한 뒤에는 페이지 수집을 처음부터 다시 시작해야 한다. 앞부분은 이전 계층에서, 뒷부분은 새 계층에서 모은 목록도 겉으로는 정상적인 부모·자식 쌍처럼 보일 수 있어 수집 경위를 함께 인계해야 한다. [1, 2, 3]
공지가 구분한 관계와 커서
Shopify는 2026년 9월 17일 공지에서 2026-10의 marketRelationships와 관계 상태 조회 기능을 소개했다. 직접 관계가 재구축 뒤에도 존재하면 관계 ID는 유지되지만 커서는 달라질 수 있다고 명시했다. 계층 관계는 비동기로 재구축되며, 루트 마켓의 parentMarket은 null일 수 있다. 부모가 없다는 이유만으로 모든 루트 행을 결측 오류로 처리해서도 안 된다. [1]
버전 확인과 페이지 읽기를 분리한다
인계 담당자는 변경 전 버전, 별도 요청에서 관측한 새 버전, 커서 재시작 기록을 묶고 서로 다른 수집 세대의 관계를 한 목록으로 승인하지 않는다. read_markets 권한과 적용 버전도 기록한다. 공지는 관계 목록과 같은 요청에서 얻은 version을 스냅샷 식별자로 취급하지 말라고 한다. 버전을 출력 열에 붙였다는 사실만으로 원자적인 읽기를 확보한 것은 아니다. [1, 3]
버전 문자열의 크기를 비교할 필요는 없다
설명용으로 변경 전 불투명 버전이 vA이고 별도 요청에서 vB를 받았다고 하자. 둘이 달라졌으므로 기대 재시작 상태는 true다. 실제 수집 로그도 true이면 새 세대의 시작이라는 행동 조건을 충족한다. false라면 옛 커서를 이어 쓴 경로이므로 해당 혼합 목록을 인수하지 않는다. vB가 vA보다 크다는 계산은 필요 없다. 이 예는 행동 계약을 설명하며 서버 재구축을 실행한 기록이 아니다. [1, 3]
검사는 수집 로그를 대신 만들지 않는다
Truthound Core 3.3.2의 ExpressionValidator에는 filter_expr로 준비한 버전 변경·재시작 상태표의 승인 조건을 전달할 수 있다. 조건에 맞지 않는 행은 수집 담당자가 재조회할 대상으로 남긴다. Truthound가 재구축을 완료시키거나 커서를 검증하는 것은 아니다. 버전 변화가 없다면 무조건 재시작시키기보다 대기·재조회 정책을 따르고, 로그가 없다면 먼저 그 증거를 확보해야 한다. [1, 2, 3]
적용 조건
2026-10 이상과 read_markets 권한을 사용하며, 버전은 계층 변경 전과 변경 후 별도 요청에서 관측한다. 해당 표의 재시작 상태는 실제 수집 로그에서 가져온다.
대안
버전이 바뀌지 않으면 대기·재조회 정책에 따라 수집을 보류하고, 바뀐 뒤 새 세대로 전체 페이지를 다시 모은다.
한계
같은 요청에서 받은 버전을 관계 목록의 원자적 스냅샷 ID로 취급할 수 없다. Truthound는 비동기 재구축을 완료시키거나 커서의 유효성을 직접 확인하지 않는다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
