자연 키와 룩업

자연 키

자연 키는 레코드를 가리키는 선택적이고 사람이 읽을 수 있는 주소이며, 필드 _naturalKey로 반환됩니다. 글자, 숫자, 하이픈, 밑줄, 마침표, 물결표로 이루어진 URL 안전 세그먼트 하나입니다. GraphQL, SDK, CLI에서 키로 레코드를 읽을 수 있고, 일치하는 것이 없는 읽기는 null을 반환합니다. 키는 언제나 필터링과 정렬에 사용할 수 있습니다.

충돌과 이름 변경

레코드를 만들 때 키를 설정합니다. 모델의 다른 레코드가 이미 그 키를 가지고 있어도 생성은 성공하며 Fóir가 접미사(about-1, about-2)를 붙이므로, 응답에서 키를 다시 읽어야 합니다. 이름 변경은 별도의 뮤테이션입니다. 다른 레코드가 새 키를 가지고 있으면 거부되며, 레코드의 id는 바뀌지 않습니다.

룩업

룩업은 모델에 추가하는 이름 붙은 키이며, 여러분의 설정 파일에서 keyBy로 선언합니다. 각 룩업은 레코드 하나 또는 null을 반환하는 타입 지정 쿼리를 생성합니다. 제품의 SKU에 대한 룩업은 productBySku를 제공합니다. 룩업은 최대 네 개의 필드를 조합할 수 있고, 모델은 최대 네 개의 룩업을 가질 수 있습니다. 필드는 최상위 text, integer, decimal, boolean 또는 enum 필드여야 합니다.

룩업 쿼리는 호출자에게 제공되는 변형 값과 일치하는 레코드를 찾으며, locale 인수를 받습니다.

고유성과 백필

룩업은 고유하며 인덱싱됩니다. 룩업 값이 다른 레코드와 충돌하는 레코드를 저장하면 거부되고, 오류에 모델, 룩업, 해당 필드가 표시됩니다. 콘솔은 충돌을 인라인으로 표시합니다.

이미 레코드가 있는 모델에 룩업을 추가하면 푸시할 때 백필됩니다. 기존 레코드에 중복된 값이 있으면 푸시가 중단되고 룩업은 추가되지 않습니다.