2025년 9월 3일 공식 노션 API 업데이트 가이드에 대한 주요 내용을 소개한 글로, 실제 서비스에 적용되는 시기는 아직 미정이니 참고만 해줘.
슈크림들 안녕! 필버트 리포터야. 최근 노션 개발자 가이드에 데이터베이스 업그레이드 소식이 등장했어!
기존에 사용하던 데이터베이스 구조를 획기적으로 업그레이드하는 내용이라 얼른 꿀팁으로 정리해봤어.
데이터베이스 구조 변경: 컨테이너와 데이터 소스
2025년 9월 3일 업데이트 사항 중 가장 중요한 점은 데이터 구조가 변경된다는 점이야.
•
새로운 노션 데이터베이스의 개념은 컨테이너(Container)와 데이터 소스(Data Sources)로 나뉘어져
•
이전에는 하나의 데이터베이스는 단일 테이블로만 작동했지만,
이제는 하나의 데이터베이스가 여러 데이터 소스를 포함할 수 있게 됐어.
•
각 데이터 소스는 서로 다른 스키마(속성 구조)를 가질 수 있어서,
데이터 관리가 훨씬 유연해졌는데 어쩌면 관계형 데이터를 잘 활용할 수 있게 될 거 같아.
API 변경 사항
변경된 API 엔드포인트
•
데이터베이스 API: /v1/databases
◦
전체 데이터베이스 컨테이너를 관리
•
데이터 소스 API: /v1/data_sources
◦
새로운 API로 각 데이터 소스를 개별적으로 관리
•
검색 API: filter["value"] = "data_source"로 변경
◦
이전의 "database" 대신 사용
ID 관리의 변화
•
데이터베이스 ID: 컨테이너의 ID
•
데이터 소스 ID: 실제 테이블의 ID
•
페이지의 부모: 이제 data_source_id를 통해 관리
웹훅 변경 사항
•
웹훅에도 API 버전 관리가 도입되었어. 이제 웹훅 구독에 API 버전을 설정할 수 있어.
•
새로운 이벤트 타입: data_source.created, data_source.moved, data_source.deleted, data_source.undeleted
•
기존 database.content_updated가 data_source.content_updated로 변경됐어.
권장 마이그레이션 단계
1.
데이터 소스 ID 식별하기: 데이터베이스의 data_sources 배열에서 각 데이터 소스의 ID를 확인해야 해.
2.
데이터 소스 ID 사용하기: 페이지 생성이나 관계 속성 정의 시 data_source_id를 사용하도록 변경해.
3.
API 엔드포인트 마이그레이션: /v1/databases 엔드포인트를 /v1/data_sources로 마이그레이션해.
4.
SDK 업그레이드하기: TypeScript SDK v5로 업그레이드해서 notion.dataSources.* 메소드를 사용해.
이 업데이트는 이미 사용 가능하지만, 여러 데이터 소스 생성 기능은 9월 3일 이후부터 본격적으로 지원될 예정이야. 자세한 내용은 아래 문서를 참고해줘!
노션 데이터베이스 업그레이드 소식에 대해서 기술적인 문서 기반으로 소개해봤는데,
궁금한 점이 있다면 언제든 슬랙 스레드 댓글로 물어봐.
작성자: 슈크림 방송국 - 필버트 리포터 (@filbert.snoopy)
가장 빠르고 솔직한 노션 업데이트 소식!
안녕하세요. 노션 알려주는 슈니, 노슈니입니다.
본 콘텐츠는 노슈니와 슈크림이 직접 제작하는 노션 업데이트 정보 입니다.
위 자료에 대한 모든 권리는 슈크림마을에게 있으며
해당 템플릿을 무단으로 복제, 재수정, 도용, 배포 등
저작권을 침해하는 행위를 할 경우 법적처벌을 받을 수 있습니다.
ⓒ 2025 Shoocreamvillage all rights reserved.
