문제 해결
대부분의 문제는 자격 증명, 인덱싱, 또는 라이선스 상태로 귀결됩니다. 이 페이지는 흔한 문제들과 앱이 스스로를 최신 상태로 유지하는 방식을 정리합니다.
자격 증명 & 연결
프로필 상태 점이 빨간색이고 Sign in / Enter MFA 동작이 표시됩니다. AWS 토큰이 만료되어 재인증이 필요합니다. 프로필 칩의 인라인 Sign in(SSO) 또는 Enter MFA(TOTP 역할) 동작을 클릭하거나, 그냥 쿼리를 다시 실행하세요 — DynoTable은 필요할 때 다시 인증합니다. 호박색/주황색 점은 다릅니다: 토큰이 곧 만료되지만 자동으로 갱신되므로 할 일이 없습니다. AWS 계정 연결을 참고하세요.
SSO 로그인이 아무 반응이 없거나 / 브라우저가 열리지 않습니다. DynoTable은
OAuth 디바이스 플로우를 프로세스 내에서 실행합니다. 브라우저 탭이 나타나지
않으면, 터미널에서 aws sso login을 한 번 실행해 ~/.aws/config SSO 프로필이
유효한지 확인하세요 — DynoTable은 동일한 ~/.aws/sso/cache에 기록하므로,
정상적으로 동작하는 CLI 로그인은 프로필이 유효함을 확인해 줍니다.
예상한 테이블이 목록에 없습니다. DynoTable은 활성 프로필과 리전의 모든 테이블을 나열합니다. 하나가 빠져 있다면, 잘못된 리전에 있거나(탭별로 전환) 또는 프로필의 Table Prefix Filter가 접두사로 시작하지 않는 테이블을 숨기고 있는 것입니다 — 프로필의 연결 설정에서 지우거나 조정하세요. ⌘K도 같은 필터링된 목록을 사용하므로, 접두사나 리전이 맞지 않으면 거기서도 테이블이 숨겨집니다.
데이터 & 쿼리
결과가 오래되어 보이거나 비어 있습니다. ⌘R로 쿼리를 다시 실행하세요. Smart Table과 Workbench는 DynamoDB를 실시간으로 쿼리하며, 로컬 인덱스가 스키마/필드 해석과 조인을 뒷받침합니다. Smart Table은 처음 볼 때 자동으로 인덱싱됩니다 — 테이블을 한 번 열고 나서 다시 실행하세요.
필터가 예상한 결과를 전혀 반환하지 않습니다. 올바른 쿼리 모드에 있는지 (⌘⇧M로 Visual / PartiQL 전환), 그리고 키 필터가 올바른 속성을 대상으로 하는지 확인하세요. 필터 & 쿼리 패턴을 참고하세요.
쓰기가 차단됨
항목 저장, 스테이징된 변경 커밋, 또는 PartiQL 쓰기 실행이 모두 실패한다면, 앱이 읽기 전용 상태입니다 — 라이선스가 만료된 것입니다. 읽기와 내보내기는 여전히 동작합니다. 배너의 Reconnect를 클릭하세요; 구독이 유효하면 즉시 Active 상태로 돌아갑니다. 활성화를 참고하세요.
AI가 동작하지 않음
프로필의 AI 섹션에서 Bedrock을 지원하는 AWS 프로필과 리전을 고르고 Test Connection을 클릭하기 전까지, 채팅은 작성기 대신 Configure AI 배너를 표시합니다. 또한 해당 계정과 리전에서 Bedrock 모델 액세스가 활성화되어 있어야 합니다. 전체 설정: AI 채팅.
업데이트
DynoTable이 새 버전을 받는 방식은 플랫폼에 따라 다릅니다.
| 플랫폼 | 업데이트 방식 |
|---|---|
| macOS | 끊김 없는 인앱 자동 업데이트. 실행 시와 주기적으로 확인하며, 백그라운드에서 다운로드합니다. |
| Windows | macOS와 동일하게, 끊김 없는 인앱 자동 업데이트. |
| **Linux | 시스템 패키지 관리자**(apt / dnf)를 통해 업데이트; 인앱 업데이터는 없습니다. |
macOS와 Windows에서는 새 빌드가 다운로드되면 "Update ready — restart" 배너가 나타납니다 — 재시작하여 적용하세요. 가끔 릴리스가 최소 지원 버전을 설정하는데, 여러분의 빌드가 그보다 낮으면 배너가 새 버전으로 재시작할 때까지 차단하는 "Update required"로 바뀝니다.