SQL을 작성하고 TypeScript를 유지하세요.
SQLBraid는 SQL 우선 TypeScript 데이터 액세스 도구입니다. 쿼리 빌더 변환 계층 없이 익숙한 SQL을 그대로 사용하면서, 프로덕션에 중요한 경계를 유지합니다.
- SQL이 그대로 보입니다. 태그된 템플릿은 일반 SQL과 데이터베이스별 기능을 보존합니다.
- 값은 계속 바인드됩니다. 일반 값 보간은 논리 값 parameter가 되고 선택된 드라이버가 placeholder/구체화 전송을 소유하며, 구조적 SQL에는 명시적 헬퍼가 필요합니다.
- 결과가 명시적입니다.
rows,command,call을 선언하면 런타임 검사가 불일치를 잡아냅니다. - 런타임 의미가 정직합니다. 직접 연결과 풀은 서로 다른 팩토리를 사용하며, 트랜잭션은 하나의 물리적 연결을 고정합니다.
- 도구는 선택 사항입니다. 메타데이터, 결정적 코드 생성, LSP, CLI 검사, VS Code 지원은 런타임 의존성 경로에 들어오지 않습니다.
설계 원칙 및 제한 사항
섹션 제목: “설계 원칙 및 제한 사항”SQLBraid는 SELECT 결과 타입을 자동으로 추론하거나 객체 그래프를 생성하지 않으며, 모델 DSL 뒤로 SQL을 숨기지 않습니다. 사용자가 작성한 SQL과 선언한 행 타입이 곧 계약이 됩니다.
데이터베이스에서 애플리케이션으로 값이 이동하는 경계는 데이터 표현과 숫자 정확도를 참고하세요. 각 driver 프로필에는 런타임이 실제로 받을 수 있는 정수, 10진수, JSON, temporal, binary 값이 기록되어 있습니다.
문서 출시 안내
섹션 제목: “문서 출시 안내”이 문서는 SQLBraid 1.0.0 GA 문서입니다. GA는 공개 contract의 안정화를 뜻하며 모든 driver에서 모든 capability를 보장하지 않습니다. 현재 tree에는 session/lease 소유권, 고정 transaction option, prepared input factory, capability 기반 cancellation, 명시적인 unsupported 오류가 포함됩니다. 이 API 변경의 영향을 받은 target의 지원 label과 증거는 런타임/드라이버 증거 매트릭스가 기록한 정확한 database, driver, profile, runtime, capability tuple과 revision별 실행 workflow에만 적용됩니다. 인접한 버전·runtime·profile·로컬 binding 또는 package 설치로 인증을 추론하지 마세요. 최종 exact-SHA Runtime, Docs, Release gate와 명시적인 release 승인은 별도 요구사항입니다. 통합을 선택하기 전에 릴리스 노트와 제한 사항 및 런타임/드라이버 증거 매트릭스를 확인하세요.