トラブルシューティング
ほとんどの問題は、認証情報、インデックス作成、またはライセンスの状態に行き着きます。このページでは、よくあるものと、アプリが自身を最新の状態に保つ仕組みをまとめています。
認証情報と接続
プロファイルのステータスドットが赤で、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 の書き込みがすべて失敗する場合、アプリは Read-only の状態です — ライセンスが失効しています。読み取りとエクスポートは引き続き利用できます。バナーの Reconnect をクリックしてください。サブスクリプションが有効であれば、すぐに Active に戻ります。アクティベーションを参照してください。
AI が動かない
チャットには、プロファイルの AI セクションで Bedrock 対応の AWS プロファイルとリージョンを選んで Test Connection をクリックするまで、コンポーザーの代わりに Configure AI バナーが表示されます。さらに、そのアカウントとリージョンで Bedrock のモデルアクセスを有効にしておく必要があります。詳しいセットアップ: AI チャット。
アップデート
DynoTable が新しいバージョンを取得する方法は、プラットフォームによって異なります。
| Platform | How it updates |
|---|---|
| macOS | アプリ内でシームレスに自動更新。起動時と定期的にチェックし、バックグラウンドでダウンロードします。 |
| Windows | macOS と同様に、アプリ内でシームレスに自動更新。 |
| **Linux | システムのパッケージマネージャー**(apt / dnf)で更新します。アプリ内アップデーターはありません。 |
macOS と Windows では、新しいビルドのダウンロードが完了すると 「Update ready — restart」 バナーが表示されます — 再起動して適用してください。まれに、リリースで最低サポートバージョンが設定されることがあります。お使いのビルドがそれを下回る場合、バナーは、新しいバージョンで再起動するまで操作をブロックする 「Update required」 に変わります。