JSON에서 관계형 데이터베이스로
데이터베이스가 모든 삽입을 받아들여도 구매 예산은 잘못 나올 수 있습니다. 잘못 배치된 가격이 제품 카탈로그를 어떻게 손상시키는지, 그리고 Entity Enricher가 검토된 아이덴티티와 관계 결정을 어떻게 반복 가능한 테이블과 업데이트로 바꾸는지 확인하세요.
에이전트가 JSON을 해석하고 SQL을 작성합니다. Supabase MCP는 해당 SQL을 apply_migration 및 execute_sql을 통해 실행합니다. 모델링, 식별자, 반복 가져오기 규칙은 에이전트나 애플리케이션이 제공해야 합니다.
키와 공유 또는 부모 소유 관계를 포함한 재사용 가능한 스키마를 검토합니다. 엔진은 테이블, 제약 조건, 구조적 인덱스를 도출한 뒤 이후의 데이터 변경을 동일한 모델을 통해 전달합니다. AI는 모델을 제안하는 데 도움을 주고, 규칙 적용은 코드가 수행합니다.
이 비교는 Supabase MCP를 통해 JSON에서 구축하는 에이전트를 다룹니다. 잘 설계된 Supabase 애플리케이션도 이러한 보호 장치를 구현할 수 있습니다. 아래의 잘못된 모델은 모델링 위험을 보여주는 예시일 뿐이며, Supabase의 기본 동작이나 실제 측정된 실패율이 아닙니다.
이 가상의 카탈로그에는 제품 샘플 두 개가 들어 있습니다. 공급업체 SUP-7은 램프를 €12에, 책상을 €85에 판매합니다. 공급업체는 공유되지만 가격과 리드 타임은 각 오퍼에 속합니다.
[
{
"sku": "LAMP-01",
"name": "Reading lamp",
"offers": [
{
"supplier": {
"supplier_id": "SUP-7",
"name": "Northstar Supply"
},
"unit_cost_eur": 12,
"lead_time_days": 3
}
]
},
{
"sku": "DESK-02",
"name": "Writing desk",
"offers": [
{
"supplier": {
"supplier_id": "SUP-7",
"name": "Northstar Supply"
},
"unit_cost_eur": 85,
"lead_time_days": 14
}
]
}
]Entity Enricher에서 이는 자동 데이터 가져오기가 아니라 스키마 예제입니다. 생성된 스키마를 검토해 공급업체는 공유로, 제안은 상위 소유로 표시한 다음, 게시하고 일치하는 레코드를 보강하거나 주입하세요. 이 예제에서는 안정적인 SKU와 공급업체 ID가 아이덴티티를 제공합니다.
잘못된 매핑 예시
| 컬럼과 키 | SQL 타입 |
|---|---|
| skuPK | text |
| name | text |
| supplier_idFK | text |
product.supplier_id → supplier.supplier_id
| 컬럼과 키 | SQL 타입 |
|---|---|
| supplier_idPK | text |
| name | text |
| unit_cost_eur | numeric |
| lead_time_days | integer |
SUP-7을 책상의 오퍼로 업데이트하면 램프의 가격과 배송 기간을 덮어씁니다. 외래 키는 유효하지만 데이터는 잘못되었습니다. 이 구조는 제품당 공급업체를 하나로 제한하기도 합니다.
검토된 모델을 적용한 Entity Enricher
| 컬럼과 키 | SQL 타입 |
|---|---|
| skuPK | text |
| name | text |
| 컬럼과 키 | SQL 타입 |
|---|---|
| supplier_idPK | text |
| name | text |
product 1 → N offer N ← 1 supplier
| 컬럼과 키 | SQL 타입 |
|---|---|
| product_skuPK / FK | text |
| supplier_idPK / FK | text |
| unit_cost_eur | numeric |
| lead_time_days | integer |
공급업체 행 하나를 재사용합니다. 제품–공급업체 쌍마다 고유한 가격과 리드 타임을 가집니다. 책상 오퍼를 추가해도 램프 오퍼는 그대로 유지됩니다.
테이블 이름과 자연 키는 단순화했으며 동기화 메타데이터는 생략했습니다. PK = 기본 키, FK = 외래 키. 두 오퍼 키가 하나의 복합 키를 구성합니다. 이 예시는 쌍마다 현재 오퍼가 하나라고 가정합니다. 가격 이력, 통화, 수량 구간을 다루려면 추가 모델링이 필요합니다.
구매자가 램프 100개를 필요로 합니다. 첫 번째와 두 번째 가져오기를 전환하며 각 모델이 무엇을 반환하는지 확인하세요.
잘못된 모델: 램프 100개 예산
€8,500
€7,300만큼 과다 계상되었습니다. 이제 마진 보고서와 구매 예측이 책상의 가격을 사용합니다.
검토된 EE 모델: 램프 100개 예산
€1,200
램프의 오퍼는 리드 타임 3일에 €12로 유지됩니다. 책상의 오퍼는 별도의 행입니다.
샘플 데이터를 기반으로 한 예시 계산이며, 실제 데이터베이스 호출이나 측정된 금전적 손실이 아닙니다.
가져올 때마다 새 공급업체 ID를 발급하면 구매 내역이 중복 프로필로 나뉩니다. 총지출과 공급업체 비교가 잘못된 정보를 주게 됩니다.
Entity Enricher
안정적인 키를 선언하면 반복되는 엔티티가 하나로 수렴합니다. 레이블이 다양할 때는 선택적 시맨틱 ID가 도움이 되지만, 일치 결과는 여전히 검토가 필요합니다.
product_sku로 시작하는 연결 키는 supplier_id로 시작하는 인덱스를 대체하지 않습니다. 카탈로그가 커질수록 역방향 조회 비용이 커질 수 있습니다.
Entity Enricher
EE는 역방향 연결 조회를 포함해 관계에 필요한 구조적 인덱스를 생성하며, 중복되는 선행 접두사 인덱스는 만들지 않습니다. 그 외 인덱스는 실제 쿼리에 맞게 조정하세요.
JSON에는 오퍼 필드가 추가되었지만 대상 테이블이나 가져오기 SQL에는 반영되지 않았습니다. 새 데이터가 로드되지 않거나, 필요한 보고서까지 전달되지 않습니다.
Entity Enricher
게시된 스키마가 테이블 구조와 데이터 투영을 모두 결정합니다. 게시하기 전에 지원되는 마이그레이션을 미리 확인하세요. 지원되지 않는 변환은 차단됩니다.
가져오기 후 연결이 끊깁니다. 재생 규칙이 없으면 재시도가 중복을 만들 수 있고, 오래된 업데이트가 더 최신 제안을 덮어쓸 수 있습니다.
Entity Enricher
EE는 순서가 보장된 전달, 아이덴티티 기반 upsert, 리비전 가드를 제공합니다. PostgreSQL 클라이언트는 배치를 트랜잭션으로 적용하고 커밋 후 확인 응답을 보냅니다.
모델이 JSON을 반환하지만 어떤 오퍼에 필수 키가 없거나 대상이 쓰기를 거부합니다. 성공 메시지만으로는 누락된 제품과 오퍼가 가려질 수 있습니다.
Entity Enricher
수용 정책은 엔티티를 거부하거나 불완전한 하위 항목을 생략할 수 있습니다. EE는 부분 결과를 보고하고 복제본 전달을 별도로 추적하므로 복구가 필요한 부분을 파악할 수 있습니다.
변경되지 않은 오퍼를 다시 기록하면 데이터베이스 작업이 낭비되고, 인덱스가 불필요하게 갱신되며, 이후 변경 처리에 잡음이 늘어납니다.
Entity Enricher
EE는 변경되지 않은 엔티티 상태를 감지하고 값이 그대로인 행의 업데이트를 방지합니다. 소비자는 델타 피드를 통해 삭제를 포함한 변경 사항을 추적할 수 있습니다.
게시하기 전에 각 필드의 식별자, 소유 관계, 의미를 검토하세요. EE는 그러한 결정을 실행 가능하게 만들 뿐, 비즈니스 모델이 올바른지는 증명할 수 없습니다. 의미 기반 매칭은 오류를 낼 수 있으며, 쿼리 성능은 여전히 워크로드와 데이터베이스 크기에 따라 달라집니다.
최신 보강이 현재 상태를 대체합니다. 값이 누락되면 이전 값이 지워질 수 있고, 소유 오퍼 목록이 짧아지면 빠진 오퍼가 삭제됩니다. 필요하다면 이력을 별도로 보관하세요. 부분 데이터나 거부된 데이터는 수정 후 다시 제출해야 하며, 전송 상태가 자동 복구를 뜻하지는 않습니다.
Supabase MCP는 에이전트가 데이터베이스를 살펴보고 맞춤 SQL을 작성하도록 할 때 유용합니다. EE는 동일한 데이터 계약이 일관된 관계형 업데이트를 계속 만들어내야 할 때 유용합니다. 연결 및 데이터베이스 권한이 허용된다면 Supabase PostgreSQL을 EE 동기화 클라이언트의 대상으로 사용할 수 있습니다. 애플리케이션 접근 정책은 여전히 직접 구성하셔야 합니다.
2026년 9월 10일 검토. Supabase는 마이그레이션과 누락된 인덱스를 표시해 주는 Advisors를 제공합니다. EE의 차별점은 검토된 보강 스키마에서 규칙을 생성하고 적용한다는 점입니다.