SQLly 임베디드
자체 웹 앱에서 SQLly 호스팅하기: 패키지에 무엇이 들어 있는지, 브리지와 앱, sqlly.app이 어떻게 맞물리는지, 어디서부터 시작할지.
SQLly Embedded는 SQLly의 브라우저 빌드를 여러분의 웹 앱 안에 넣습니다. 사용자는 사이트의 한 페이지에서 전체 워크벤치를 쓸 수 있습니다: IntelliSense가 있는 SQL 에디터, 객체 탐색기, 결과 그리드, 차트, 실행 계획. 모든 데이터베이스 비밀번호는 여러분의 서버가 보관합니다. 어떤 사용자 그룹이 어떤 연결을 볼지는 여러분이 정하고, SQLly 브리지가 라이선스를 지킵니다.
실행하는 것
| 조각 | 기능 | 어디에서 실행되는지 |
|---|---|---|
| 내 웹 앱 | 사용자의 로그인을 처리하고 각 사용자에게 어떤 프로필 (연결 집합)을 각자 받으며, 브리지에 실행 토큰을 요청하고, SQLly를 로드하는 페이지를 제공합니다. | 내 서버 |
SQLly 브리지 (sqlly-bridge embedded) | 프로필과 자격 증명을 보관하고, 실행 토큰을 발급하고, 브라우저 WebSocket을 받아들이고, 세션당 엔진 하나를 실행하고, 좌석 수를 세고, sqlly.app에서 라이선스를 확인합니다. | 내 서버, 앱 바로 옆에 |
SQLly 엔진 (sqlly-cli) | 하나의 브라우저 세션 동안 데이터베이스에 연결해 쿼리를 실행합니다. 시작과 중지는 브리지가 담당하고, 그 외에는 아무것도 여기와 통신하지 않습니다. | 내 서버(브리지의 자식 프로세스) |
SQLly 웹 번들 (web/) | WebAssembly로 컴파일된 SQLly 앱. 앱이 제공하는 정적 파일. | 사용자들의 브라우저 |
| sqlly.app | 브릿지가 체크인할 때마다(20분마다) 라이선스를 발급하고 수명이 짧은 권한 부여에 서명합니다. 오프라인 라이선스는 이 서버에 접속하지 않습니다. | 이 제품 |
패키지에는 또한 샘플 관리자 앱 (Node.js, 종속성 없음)으로, 이 샘플 앱은 여러분의 앱이 할 일을 모두 합니다: 프로필, 라벨, 사용자를 관리하는 관리 화면과 각 사용자별로 SQLly를 열어 주는 로그인 페이지가 있습니다. 전체 흐름을 보려면 실행해 보고, 그다음에는 자신만의 앱으로 바꾸거나 이 코드에서 시작하세요.
이 섹션에서
- 작동 방식
- 동작 원리: 브리지, 세션별 엔진, 실행 토큰, 서명된 라이선스 승인, 체크인, 좌석, Origin 규칙, 그리고 자격 증명이 어디에 담기는지.
- 빠른 시작
- 5분 만에 로컬호스트에서 SQLly Embedded 패키지 실행하기: 브리지와 샘플 앱을 시작하고, 라이선스를 연결하고, 프로필을 추가하고, 사용자처럼 SQLly를 열어 봅니다.
- 샘플 앱 둘러보기
- SQLly Embedded에 포함된 샘플 관리자 앱의 화면별 안내: 상태 및 라이선싱, 프로필과 연결, 레이블, 사용자, 그리고 SQLly 실행.
- 직접 앱 만들기
- 단계별 안내: 자체 웹 앱에서 SQLly Embedded 브리지를 구동하기 - 프로필 저장, 실행 토큰 발급, 브라우저 빌드 제공, 좌석 회수, 설치 연결.
- 쿼리와 함께 SQLly 열기
- SQLly를 바로 쿼리 탭으로 실행하세요: 스크립트, 연결 및 데이터베이스, 매개변수 값과 커서를 'SQLly에서 열기' 버튼용 실행 토큰과 함께 전송합니다.
- API 참조
- SQLly Embedded 브리지 관리 API의 모든 엔드포인트(OpenAPI(swagger.json) 문서에서 생성됨)와 sqlly.app 링크 엔드포인트.
- 라이선스
- 플랜, 좌석, 세션, 인스턴스, 도메인, 체크인, 유예 기간, 오프라인 라이선스 파일, 브리지가 가질 수 있는 모든 라이선스 상태와 각 상태를 해결하는 방법.
- 프로덕션에 배포하기
- TLS, 리버스 프록시, 라이선스 도메인, 서비스 관리자, 백업, Content-Security-Policy와 격리 헤더, 그리고 SQLly Embedded 프로덕션 체크리스트.
경로 선택
- 도입을 검토 중이신가요? 읽기 작동 방식, 이어서 다음을 따르세요 빠른 시작. 모든 sqlly.app 계정에는 3개월 무료 체험(사용자 1명, 브리지 1개)이 포함되어 있으니, 써 보려고 무언가를 살 필요는 없습니다.
- 연동하시나요? 먼저 샘플 앱 투어 를 통해 앱이 제공해야 하는 것을 확인한 후, 직접 앱 만들기 해당 API 참조 (또는 불러오거나 swagger.json API 도구에 가져가면 됩니다).
- 배포 중이신가요? 읽기 라이선스 좌석, 도메인, 라이선스 상태별 의미는 여기서 확인하고, 이어서 프로덕션에 배포하기.
짧게 말하면
- 자격 증명은 절대 브라우저에 도달하지 않습니다. 프로필의 비밀번호는 브리지의 상태 디렉토리에 저장됩니다. 브라우저는 연결 목록(이름, 엔진, 레이블)만 받으며 브리지의 WebSocket을 통해 쿼리를 전송합니다.
- 좌석은 동시 사용자입니다. 사용자는 SQLly를 열어 둔 동안, 또는 만료되지 않은 실행 토큰을 쥐고 있는 동안 좌석을 점유합니다. 다 쓰는 즉시 좌석은 풀립니다. 유료 플랜은 사용자당 탭 네 개를 허용합니다.
- 라이선스당 하나의 도메인 - 모든 하위 도메인이 포함됩니다. 브리지는 다음의 브라우저만 허용합니다
Origin이(가) 그 도메인에 묶여 있습니다(추가로localhost개발하는 동안). - SQLly가 지원하는 모든 엔진 브리지를 통해 작동: SQL Server, Azure SQL, PostgreSQL, MySQL, MariaDB, SQLite, DuckDB, ClickHouse, Oracle, libSQL/Turso, Redis 및 Valkey, 그리고 클라우드 버전.
- 연결형 또는 오프라인. 연결된 라이선스는 20분마다 sqlly.app에 체크인합니다. 오프라인 라이선스는 브리지가 로컬에서 검증하는 서명된 파일이며, 외부 서버에 연락하지 않습니다.
플랜과 가격이 안내된 곳은 SQLly Embedded 페이지플랫폼용 패키지는 다음에서 내려받고 다운로드, 그리고 라이선스, 키, 연결된 설치는 다음에서 관리합니다 Embedded 관리 페이지.