유틸리티

문제 해결

다음은 자주 발생할 수 있는 문제들과 해결 방법입니다.

연결 창이 숨겨져 있습니다

문제: 새 창이 열리고 미션 컨트롤에서 보이지만 화면에는 표시되지 않습니다.

다음 단계: TablePlus 를 종료하고 터미널을 열어 아래 명령을 실행하여 앱의 설정 파일을 삭제합니다. 이 작업은 일부 앱 설정을 초기화하지만, 연결 정보는 별도의 파일에 저장되어 영향을 받지 않습니다.

rm ~/Library/Preferences/com.tinyapp.TablePlus.plist

SSH 연결에 실패했습니다

문제: 연결 설정은 정확하지만, SSH 터널을 통해 연결할 수 없습니다.

해야 할 일: SSH 로그를 활성화하고 저희에게 보내주시면 문제 해결을 더 빠르게 진행할 수 있습니다.

  1. Help > Enable SSH & Bash Script Log를 선택하세요.

  2. TablePlus 를 종료하세요.

  3. 터미널을 열고 Terminal에서 TablePlus를 시작하여 로그를 확인하세요.

    /Applications/TablePlus.app/Contents/MacOS/TablePlus
    
  4. 다시 연결한 후 로그 출력을 [email protected]으로 보내주세요.

패키지가 손상되었습니다

문제: macOS 에서 앱을 설치할 때 "패키지가 손상됨" 오류가 표시됩니다.

대처 방법: 사용 중인 macOS 버전이 지원되지 않을 가능성이 높습니다. TablePlus 는 macOS 12 또는 그 이상 버전이 필요하므로, 먼저 macOS 를 업데이트하세요.

표 데이터 표시 오류

문제: 테이블을 열 때 일부 문자가 제대로 표시되지 않습니다.

무엇을 해야 할까요? 올바른 인코딩을 사용하세요. Connection > View Using Encoding을 선택한 후 테이블과 일치하는 인코딩을 선택하세요.

쿼리 결과는 숨겨졌습니다

문제: SQL 편집기에서 쿼리를 실행했지만 결과 창이 표시되지 않습니다.

무엇을 해야 할까요?: ⌃ + `를 누르거나 View > Toggle sidebars > Toggle Query Results Pane을 선택할 수 있습니다. 또한, 쿼리 편집기의 하단 테두리를 위로 드래그할 수도 있습니다.

쿼리 결과 패널이 아래로 접힌 SQL 편집기
결과 영역이 축소되었습니다.

CSV 파일을 가져올 수 없습니다

문제: CSV 파일에서 데이터를 가져오려 했지만, 오류로 인해 가져오기가 중단됩니다.

대처 방법: 일반적으로 두 가지 원인이 있습니다.

  • 인코딩 오류: 임포트 CSV 마법사의 다른 Encoding을 선택하고 다시 시도해 보세요.
  • 데이터 유형 불일치: 가져오기 전에 데이터를 확인하여 테이블 열의 데이터 유형과 일치하는지 확인하세요.

더 쉽게 하려면 거의 항상 작동하는 모든 열이 텍스트인 새 테이블로 가져오기를 수행할 수 있습니다. Import CSV Wizard에서 Create new table을 선택하고 Create table with all text Columns을 선택하세요.

CSV 가져오기 마법사의 "새 테이블 생성" 옵션이 선택되고, "모든 텍스트 열을 포함한 테이블 생성" 옵션이 선택되었습니다.
표에 모든 텍스트 열을 가져오기

유효하지 않은 라이선스

문제: 유효한 라이선스 키를 보유하고 있음에도 활성화 시 "Invalid license key:" 메시지와 키가 표시됩니다.

What to do: 키를 여러 번 붙여넣을 때 종종 발생합니다. 필드를 지우고, 이메일에서 정확한 라이선스 키를 복사한 후 한 번만 붙여넣으세요.

AI 어시스턴트가 응답하지 않습니다

문제: 어시스턴트 탭에서 메시지를 보냈으나 오류가 발생하거나 답변을 받지 못했습니다.

다음 단계:

  • 제공업체가 Settings > AI Agent에서 API 키를 설정했는지 확인하세요. Ollama 는 API Key 필드에 값을 입력해야 하지만, 실제로는 사용하지 않습니다.
  • Codex CLI 에 대해 Settings > AI Agent > Codex CLI 의 Status 를 확인하세요. Codex 가 발견되지 않는 경우 Path 에 codex 실행 파일의 전체 경로를 입력하세요.
  • 사용자 정의 에이전트의 경우 Test Agent를 클릭하여 TablePlus 가 이를 시작할 수 있는지 확인하세요.
  • 제공업체를 차단하지 않도록 네트워크 설정을 확인하세요.

LLM 플러그인에 대한 자세한 내용은 확인하세요.