묶음과 필드 종류
자주 쓰는 묶음은 셋입니다. 첫 줄은 쪽을 처음 열 때의 씨앗으로 뽑은 값입니다.
| 묶음 | 필드 | 첫 줄 |
|---|---|---|
| 사용자 | id(번호), name(이름), email(이메일), phone(전화번호), createdAt(날짜+시각) | {"id":1,"name":"홍길동","email":"honggildong@example.com","phone":"010-XXXX-XXXX","createdAt":"2025-07-03T00:09:51Z"} |
| 상품 | id(번호), name(낱말), price(금액), inStock(참/거짓), imageUrl(이미지 주소) | {"id":1,"name":"책상","price":99800,"inStock":true,"imageUrl":"https://picsum.photos/seed/0f35c2/400/300"} |
| 게시글 | id(번호), title(문장), author(이름), status(고른 값 중 하나), publishedAt(날짜) | {"id":1,"title":"아마도 흔들린다 종이 나무 피어난다 아침이었다.","author":"홍길동","status":"취소","publishedAt":null} |
필드 종류는 21가지이고, 값은 아래 규칙으로 정해집니다.
| 종류 | 값 보기 | 규칙 |
|---|---|---|
| 번호 | 1 | 1부터 줄 번호. 씨앗과 무관 |
| UUID | f40f35c2-c01e-4d1d-af5f-62062369bea4 | v4 모양. 씨앗에서 뽑아 암호학적으로 안전하지 않음 |
| 이름 | 홍길동 | 언제나 같은 값 |
| 이메일 | honggildong@example.com | 언제나 같은 값 |
| 전화번호 | 010-XXXX-XXXX | 010-1000~9999-1000~9999 |
| 주소 | 인천광역시 서귀포시 월드컵북로 3 | 시 · 도 7개, 시 · 구 8개, 도로 7개, 번지 1~300을 따로 뽑음 |
| 회사 | 온길파트너스 | 앞말 8개 × 뒷말 6개, 48가지 |
| 직함 | 기획자 | 직함 7가지 |
| 낱말 | 책상 | 이름씨 하나 |
| 문장 | 아마도 흔들린다 종이 나무 피어난다 아침이었다. | 6낱말 문장 |
| 문단 | 아마도 흔들린다 종이 나무 피어난다 새벽 우산 걸음이었다. 자리를 빗방울 숲길 머… | 8낱말 문장 3개 |
| 정수 | 57 | 0~100 정수 |
| 실수 | 56.95 | 0~100, 소수 둘째 자리까지 |
| 금액 | 57400 | 1,000~100,000, 100 단위 |
| 참/거짓 | false | 반반 |
| 날짜 | 2026-02-21 | 2026-01-01 앞뒤 365일 |
| 날짜+시각 | 2026-02-21T23:55:54Z | 2026-01-01 앞뒤 365일, UTC, 초 단위 |
| 주소(URL) | https://example.net/users/252 | example.com · .net · .org 뒤에 경로 3가지와 1~999 |
| 이미지 주소 | https://picsum.photos/seed/9f40f3/400/300 | picsum.photos 주소, 400×300 |
| 색 | #9f40f3 | #과 16진수 여섯 자리 |
| 고른 값 중 하나 | 완료 | 쉼표로 적은 값 중 하나. 비우면 대기 · 진행 · 완료 · 취소 |
주소는 시 · 도와 시 · 구, 도로를 따로 뽑습니다. 그래서 인천광역시 서귀포시 월드컵북로 3처럼 실제로 없는 주소가 나오며, 주소 검증이나 지도 시험에는 쓸 수 없습니다. 낱말 · 문장 · 문단은 한글 더미 글 생성기로 만듭니다.
빈 값 비율은 줄마다 던지는 확률
비율을 정해도 그만큼 정확히 비지는 않습니다. 줄마다 따로 확률을 던지기 때문입니다. 게시글 묶음의 publishedAt(빈 값 20%)을 처음 씨앗으로 만들면 이렇게 됩니다.
| 줄 수 | 빈 줄 | 실제 비율 |
|---|---|---|
| 10 | 3개 (1 · 5 · 8번째) | 30% |
| 100 | 18개 | 18% |
| 1,000 | 215개 | 21.5% |
칸에는 0~100을 적습니다. 범위를 넘으면 끝값을 쓰고, 칸을 벗어날 때 쓴 값으로 돌아옵니다.
같은 결과 유지가 하는 일
| 한 일 | 켰을 때 | 껐을 때 |
|---|---|---|
| 형식 · 이름 바꾸기 | 자료 그대로 | 자료 그대로 |
| 개수 · 필드 바꾸기 | 같은 씨앗으로 다시 만듦 | 새 씨앗으로 만듦 |
| 새로 만들기 | 새 씨앗으로 만듦 | 새 씨앗으로 만듦 |
| 쪽 다시 열기 | 처음 씨앗으로 돌아감 | 처음 씨앗으로, 켠 상태로 돌아감 |
처음 씨앗은 20260923입니다. 씨앗이 같아도 설정을 바꾸면 값이 달라질 수 있습니다. 난수를 앞 필드부터 차례로 꺼내 쓰므로, 앞 필드가 난수를 더 쓰거나 덜 쓰면 뒤 값이 밀립니다. 사용자 묶음 10줄에서 하나만 바꾸고 맨 뒤 createdAt을 견준 결과입니다.
| 바꾼 것 | createdAt이 그대로인 줄 |
|---|---|
| 개수 10 → 20 | 10 / 10 |
| name 이름을 fullName으로 | 10 / 10 |
| phone 종류를 UUID로 | 0 / 10 |
| phone 빈 값 0% → 20% | 0 / 10 |
| 맨 뒤에 색 필드 추가 | 1 / 10 |
맨 뒤에 필드를 더해도 첫 줄만 같은 까닭은 둘째 줄부터 앞 줄의 새 필드가 난수를 쓴 만큼 밀리기 때문입니다. UUID도 이 씨앗에서 뽑습니다. 모양만 v4이고 암호학적으로 안전하지 않으니 실제 식별자로 쓰지 마세요.
형식별 파일 이름과 값 표기
자원 이름이 users일 때입니다.
| 형식 | 파일 이름 | 빈 값 |
|---|---|---|
| JSON 배열 | users.json | null |
| JSON Lines | users.jsonl | null |
| CSV | users.csv | 빈 칸 |
| SQL INSERT | users.sql | NULL |
| json-server db.json | db.json | null |
| MSW 핸들러 | handlers.ts | null |
BOM은 CSV를 저장할 때만 붙고, 복사한 글에는 붙지 않습니다. 같은 값이 형식마다 이렇게 적힙니다.
| JSON | CSV | SQL |
|---|---|---|
null | (빈 칸) | NULL |
true | true | TRUE |
12900 | 12900 | 12900 |
"서울, 강남구" | "서울, 강남구" | '서울, 강남구' |
"O'Brien" | O'Brien | 'O''Brien' |
"\"큰따옴표\"" | """큰따옴표""" | '"큰따옴표"' |
SQL은 INSERT 문만 만듭니다. 표는 먼저 만들어 두어야 합니다.
이름이 바뀌는 경우
이름 칸의 글은 형식마다 쓸 수 있는 모양으로 바뀝니다. 한글만 있는 이름은 items가 됩니다.
| 이름 칸 | MSW 주소 | MSW 변수 | SQL 표 | 파일 |
|---|---|---|---|---|
| users | /api/users | users | users | users.json |
| blog-posts | /api/blog-posts | blogPosts | blog_posts | blog-posts.json |
| 2024users | /api/2024users | _2024users | t_2024users | 2024users.json |
| class | /api/class | classData | class | class.json |
| 사용자 목록 | /api/items | items | items | mock.json |
| my table | /api/mytable | mytable | my_table | mytable.json |
필드 이름도 마찬가지입니다. 한글 필드는 자료에서 그대로이지만 SQL 열에서는 밑줄만 남으니, SQL로 넣을 자료는 영문 이름을 쓰세요.
| 경우 | 자료의 키 | SQL 열 | MSW 단건 조회 |
|---|---|---|---|
| 같은 이름 셋 | name, name2, name3 | name, name2, name3 | item.name |
| 빈 칸 둘 | field, field2 | field, field2 | item.field |
| 한글 둘 | 이름, 성명 | __, ___2 | item["이름"] |
| 띄어쓰기 | public id | public_id | item["public id"] |
| 숫자로 시작 | 2024 | t_2024 | item["2024"] |
SQL의 표 이름과 열 이름은 따옴표로 감싸지 않습니다. order 같은 예약어를 이름으로 쓰면 실행 전에 직접 고쳐야 합니다.
json-server로 열 때
json-server db.json 형식으로 저장한 뒤 그 폴더에서 npx json-server db.json을 실행하면 http://localhost:3000/users가 열립니다. 2026년 10월 31일에 읽은 최신판은 1.0.0-beta.15이고 Node 22.12 이상이 필요합니다. 베타라 주소 모양이 바뀔 수 있습니다.
- 2026년에 만든 줄:
/users?createdAt:startsWith=2026 - 최근 순:
/users?_sort=-createdAt - 쪽 나누기:
/users?_page=1&_per_page=10
POST · PUT · PATCH · DELETE는 db.json 파일을 직접 고치니 사본으로 띄우세요. 숫자 id는 읽을 때 문자열로 바뀌고, id 필드가 없는 줄에는 무작위 id가 붙습니다.
MSW 핸들러를 쓸 때
만들어지는 handlers.ts는 목록(/api/users)과 단건(/api/users/:id) 둘을 답합니다. 단건은 첫 필드 값으로 찾고, 없으면 404와 { "message": "Not found" }를 돌려줍니다. 첫 필드가 이름처럼 줄마다 같으면 언제나 첫 줄을 찾으니, 첫 필드는 id나 UUID로 두세요.
- 브라우저:
npx msw init <공개 폴더> --save로 워커 파일을 놓은 뒤setupWorker(...handlers)와await worker.start() - Node 검사:
setupServer(...handlers)와server.listen()
핸들러의 주소가 상대 주소라 브라우저에서는 지금 문서를 기준으로 맞춰지지만, Node 검사에서는 기준 주소를 따로 정해야 합니다. msw 3.0.3 기준입니다.
이 도구로 확인할 수 없는 것
- 이름이 언제나 석 자라 긴 이름이나 영문 이름에서 화면이 깨지는지는 볼 수 없습니다.
- 날짜는 2026-01-01 앞뒤 365일이고, 정수와 금액의 범위를 정하는 칸이 없습니다. 먼 옛날 날짜나 아주 큰 금액은 직접 넣어야 합니다.
- 개수는 1,000개, 필드는 20개까지입니다.