어느 단계에서 실패했는지 확인
연결 전 실패인지 연결 후 작업 오류인지 구분하세요. 안내와 서버 오류 상세 내용을 열고 코드, DB/스키마, 테이블을 기록하세요. UI 번호는 앱 안내 번호이며 DB 오류 번호와 다릅니다. 작업을 곧바로 반복하지 말고 해당 증상을 확인하세요.
시간 초과·연결 거부·호스트를 찾을 수 없음
서비스 정보와 호스트·포트를 비교하고 서버, 네트워크, 필요한 VPN을 확인하세요. 관리자에게 방화벽과 허용된 접속 IP를 확인하세요. SSH는 PC–SSH와 SSH–DB 구간을 나누어 확인합니다. DB 대상의 127.0.0.1은 직접 연결에서는 내 PC, 터널에서는 SSH 서버입니다.
계정·암호·개인 키 오류
DB와 SSH 계정 정보를 구분하세요. SSH 인증 성공이 DB 인증 성공을 보장하지 않습니다. .pub가 아닌 개인 키를 선택하고 Windows·WSL·직접 경로 중 실제 위치를 사용하세요. 키 암호문은 SSH 로그인 암호와 다릅니다. DB를 찾지 못하면 정확한 이름을 확인하세요. PostgreSQL에는 스키마가 아닌 DB 이름이 필요합니다.
CA·호스트 이름·SSH 호스트 키 확인
서비스에서 제공한 CA 파일을 선택하고 URL을 파일 경로로 입력하지 마세요. 인증서 오류는 공식 호스트 이름, 만료일, PC 시간, CA를 확인하세요. 최초 SSH 호스트 키는 관리자의 지문과 비교하세요. 기존 키나 인증서 변경은 이유를 확인하고, 경고를 없애기 위해 검증을 끄거나 저장된 키를 삭제하지 마세요.
연결되지만 테이블이 없거나 작업이 거부됨
올바른 DB/스키마를 선택하고 새로 고침하세요. 인증과 권한은 별개입니다. 조회·검색·내보내기는 SELECT, 수정은 UPDATE, 추가는 INSERT, 삭제는 DELETE가 필요하며 구조 변경은 ALTER 등이 필요할 수 있습니다. 무조건 관리자 권한을 요청하지 말고 대상과 작업에 필요한 권한을 확인하세요.
셀 편집 불가 또는 저장 실패
기본 키가 없으면 행을 안전하게 식별하지 못할 수 있고 JOIN·집계 SQL 결과도 읽기 전용일 수 있습니다. 생성 열, 바이너리, 일부만 표시된 값은 편집이 제한됩니다. 저장 실패 시 형식, 길이, NOT NULL, 기본 키·UNIQUE 중복, 외래 키, UPDATE 권한을 확인하세요. 기본 키 추가 전에는 데이터와 설계를 검토하세요.
재시도 전 현재 상태 확인
변경 중 연결이 끊겨도 미실행이라고 단정하지 마세요. 다시 연결하고 새로 고침하세요. 여러 행 삭제가 일부 완료됐을 수 있습니다. 검색 결과가 없으면 조건, AND/OR, 값 형식을 확인하세요. 내보내기 실패는 SELECT, 공간, 쓰기 권한을 확인하세요. 해결되지 않으면 앱 버전, OS, DB 제품, 연결 방식, 단계와 오류를 전달하되 암호·개인 키·개인정보는 제외하세요.
처음 연결하기 →