버전 7.3.5 - 드래그 앤 드롭 열 순서 변경과 Docker secrets

Published: 2026-11-16 | Stela Augustínová

DbGate 7.3.5는 테이블 열을 더 쉽게 배치할 수 있도록 하고, Docker secrets 지원을 추가하며, MySQL 스키마 처리를 개선합니다. 이번 릴리스는 같은 도메인에서 호스팅되는 웹 인스턴스의 브라우저 저장소도 분리하고, 활성 데이터베이스 연결이 예기치 않게 종료될 수 있는 문제를 수정합니다.

드래그 앤 드롭으로 테이블 열 순서 변경

이제 테이블 편집기에서 열의 핸들을 끌어 열 목록의 새 위치로 옮기는 방식으로 열 순서를 직접 변경할 수 있습니다. 놓기 표시기가 열이 배치될 위치를 보여 줍니다.

기존 테이블의 열 순서 변경은 MySQL, MariaDB, ClickHouse, Firebird에서 지원됩니다. 편집기에서 열을 배치한 다음 테이블 변경 사항을 적용하면 데이터베이스의 열 순서가 업데이트됩니다.

Docker secrets를 사용한 설정

DbGate는 이제 *_FILE 환경 변수를 지원하므로 마운트된 Docker secrets 등의 파일에서 설정 값을 불러올 수 있습니다. 예를 들면 다음과 같습니다.

STORAGE_PASSWORD_FILE=/run/secrets/db_password

DbGate는 파일을 읽고 그 내용을 STORAGE_PASSWORD로 사용합니다. 따라서 환경 변수에 비밀번호를 직접 넣는 대신 마운트된 시크릿 파일을 통해 비밀번호를 제공할 수 있습니다. 명시적으로 설정된 비어 있지 않은 STORAGE_PASSWORD가 파일보다 우선하며, 파일 내용 끝에 있는 줄바꿈 하나는 제거됩니다.

필요한 시크릿 파일을 읽을 수 없으면 API 시작이 중단되고 오류가 보고됩니다. 이를 통해 설정 값이 누락된 상태로 애플리케이션이 계속 실행되는 것을 방지합니다.

더 정확한 MySQL 열 변경

MySQL 열을 변경하거나 이동할 때 이제 열 정의의 세부 정보가 보존됩니다. 이전에는 CHANGE COLUMN 또는 MODIFY COLUMN 문을 생성하는 과정에서 이러한 정보가 손실될 수 있었습니다. 수정 사항에는 부동 소수점 수의 정밀도와 소수 자릿수 유지, 기본값 표현식과 문자열 리터럴의 올바른 구분이 포함됩니다. 예를 들어 uuid() 같은 기본값 표현식은 따옴표로 묶인 문자열로 변환되지 않고 SQL로 유지됩니다.

DbGate는 MySQL 스키마 분석과 생성된 열 정의에서 공간 열 SRID도 지원합니다. 지원되는 MySQL 버전에서는 열을 변경하거나 이동해도 POINT SRID 4326 같은 정의의 SRID가 유지됩니다.

웹 인스턴스별 브라우저 저장소 분리

웹 배포는 이제 각 WEB_ROOT에 대해 브라우저 저장소를 별도로 유지합니다. 예를 들어 https://example.com/dbgate-dev/와 https://example.com/dbgate-prod/의 인스턴스는 브라우저 저장소 키 충돌 없이 각각 저장된 탭과 인터페이스 설정을 유지할 수 있습니다.

기존 브라우저 데이터는 WEB_ROOT 아래의 인스턴스를 열 때 마이그레이션됩니다. 이전에 여러 인스턴스가 데이터를 공유했다면 가장 먼저 연 인스턴스가 기존 탭과 설정을 가져오고, 나머지 인스턴스는 별도 저장소로 시작합니다.

연결 안정성과 AWS 이미지 업데이트

이번 릴리스는 #1621에 보고된 연결 문제를 수정합니다. 동시 요청으로 같은 데이터베이스에 대한 백그라운드 프로세스가 중복 실행될 수 있었으며, 중복 프로세스가 종료되면 활성 연결이 닫힐 수 있었습니다. DbGate는 이제 중복 시작을 방지하고 종료되는 프로세스가 자신의 연결 항목만 닫도록 합니다.

Premium AWS 이미지는 이제 패치가 적용된 운영체제 패키지와 Node.js 24로 빌드됩니다.

이전 유지보수 릴리스인 DbGate 7.3.4에서는 #1610에 보고된, Excel 내보내기 및 가져오기가 “cannot save file” 오류로 실패하는 문제도 수정했습니다.

전체 변경 로그

7.3.5

  • ADDED: 테이블 편집기에서 드래그 앤 드롭으로 열 순서 변경 지원(MySQL, MariaDB, ClickHouse, Firebird)
  • ADDED: *_FILE 환경 변수 지원(Docker secrets). 시크릿 파일을 읽을 수 없으면 API 시작 중단
  • ADDED: MySQL 열 정의 및 스키마 분석에서 공간 열 SRID 지원
  • CHANGED: 여러 DbGate 인스턴스가 하나의 도메인을 공유할 수 있도록 WEB_ROOT별로 브라우저 저장소 분리
  • FIXED: MySQL 열 변경(CHANGE/MODIFY COLUMN) 시 열 정의 일부가 손실되고 기본값 표현식이 잘못 따옴표로 묶이던 문제 수정
  • FIXED: 중복 데이터베이스 연결 프로세스가 활성 연결을 닫을 수 있던 문제 수정 #1621
  • FIXED: 패치가 적용된 OS 패키지와 Node.js 24로 AWS 이미지 빌드(Premium)

7.3.4

  • FIXED: Excel 내보내기 및 가져오기가 “cannot save file” 오류로 실패하던 문제 수정 #1610