데이터베이스 레코드 (Record)

데이터베이스 레코드(Record)는 관계형 데이터베이스의 테이블에서 한 대상에 관한 여러 컬럼 값을 묶어 놓은 한 행입니다. 상품 테이블이라면 상품 번호, 이름, 가격이 한 레코드에 들어갈 수 있습니다. 컬럼이 어떤 종류의 값을 담는지 정한다면 레코드는 그 구조에 맞춘 개별 데이터이며, 행의 식별 방법은 별도의 키와 제약 조건으로 정합니다.

컬럼 값을 묶어 저장하는 행

PostgreSQL의 테이블 기초 문서는 관계형 테이블을 행과 열로 설명합니다. 각 열에는 이름과 자료형이 있고 행 수는 저장한 데이터에 따라 달라집니다. 상품 이름 컬럼은 모든 상품에서 공통으로 쓰는 속성이고, 특정 상품의 이름과 가격을 함께 가진 행이 한 레코드입니다. 테이블 전체와 개별 행을 구별하면 저장하거나 수정할 대상이 분명해집니다.

같은 대상도 설계에 따라 여러 테이블로 나눠 표현할 수 있습니다. 주문 한 건의 기본 정보와 그 주문에 포함된 상품 목록을 나눈다면, 주문 한 건이라는 업무 개념이 언제나 데이터베이스의 한 행과 일치하지는 않습니다. 레코드는 저장 구조의 단위이고 실제 업무의 대상은 그 구조를 해석하는 기준입니다. 어떤 테이블의 행을 말하는지 함께 확인해야 데이터 수를 올바르게 읽을 수 있습니다.

API가 돌려주는 JSON 객체도 테이블의 레코드와 일대일로 대응한다고 보장되지 않습니다. 여러 테이블을 합친 결과나 계산한 값을 하나의 객체로 만들 수 있고, 권한에 따라 일부 컬럼만 내보낼 수도 있습니다. 응답의 모양을 보고 저장소 구조를 추정하기보다 조회 쿼리와 API 계약을 확인하는 것이 정확합니다. 구조화 출력의 형식 검사와 실제 저장 레코드의 검증도 대상이 다릅니다.

행의 식별자와 중복 조건

PostgreSQL의 제약 조건 문서는 기본 키가 한 행을 유일하게 식별하는 하나 이상의 컬럼으로 구성된다고 설명합니다. 기본 키에는 고유성과 비어 있지 않아야 한다는 조건이 적용됩니다. 상품 이름처럼 바뀌거나 중복될 수 있는 값과, 레코드를 식별하기 위해 정한 키는 역할이 다릅니다. 두 레코드의 이름이 같아도 키가 다르면 별개 행일 수 있습니다.

반대로 SQL은 모든 테이블의 행에 자동으로 고유 식별자를 붙인다는 보장을 하지 않습니다. 테이블 기초 문서는 제약이 없으면 완전히 같은 값의 행이 여러 개 존재할 수 있다고 설명합니다. 중복을 막으려면 어떤 컬럼 조합이 유일해야 하는지 설계에 반영합니다. 화면에서 행을 한 번만 보여 준다는 사실과 데이터베이스가 중복 저장을 거부한다는 사실은 서로 다릅니다.

값이 없음을 나타내는 NULL과 빈 문자열도 구별합니다. NOT NULL은 해당 컬럼에 NULL을 저장하지 못하게 하지만 빈 문자열이나 업무상 의미 없는 값까지 모두 막는 규칙은 아닙니다. 이메일이 비어 있지 않은지와 올바른 형식인지, 실제로 사용할 수 있는 주소인지는 다른 검사입니다. 레코드의 유효성은 자료형과 제약 조건, 애플리케이션의 업무 규칙을 함께 적용해 판단합니다.

조회 결과와 저장 상태의 구분

테이블 기초 문서의 행 순서 설명은 정렬을 명시하지 않으면 읽은 행의 순서를 보장하지 않는다고 밝힙니다. 목록에서 맨 위에 보인 레코드를 언제나 가장 최근에 저장한 레코드로 해석할 수 없는 이유입니다. 생성 시각이나 정렬용 키를 기준으로 순서를 정했다면 그 기준도 조회 계약에 포함됩니다. 화면의 순번과 저장된 식별자는 별개로 다룹니다.

레코드를 수정하는 요청에서는 어떤 행을 선택하는지와 어떤 컬럼을 바꾸는지를 나눕니다. 이름이 같은 상품을 이름만으로 찾으면 여러 행이 대상이 될 수 있으므로 선택 조건이 중요합니다. SDK의 성공 응답을 받았더라도 수정 대상과 결과 값이 의도한 것인지 확인하는 과정이 필요합니다. 조회한 시점 이후 다른 작업이 값을 바꿀 수 있다는 점도 저장과 읽기 사이의 조건입니다.

벡터 데이터베이스에서 말하는 레코드는 벡터, 식별자, 메타데이터를 함께 가리키는 등 제품별 데이터 모델을 따를 수 있습니다. 관계형 테이블의 행 설명을 모든 저장소의 내부 형식으로 옮기지 않습니다. 데이터가 이동할 때는 식별자, 자료형, 빈 값, 중복 처리 규칙이 보존되는지 살핍니다. 수가 같다는 확인만으로 각 레코드의 내용과 관계가 그대로 옮겨졌다고 판단하지 않습니다.