doctor の診断項目と終了コード
手元のSQLiteを診断するコマンドです。DBの場所、更新の適用状況、ユーザー登録をどこで確かめるかと、結果の読み方をまとめます。
目次
手元のデータベースを開けるか、初期設定がどこまで済んでいるかを確かめたいときは、doctor を使います。練習サイトのSQLiteには、記事や入力欄、ユーザーなどが1個のファイルに保存されています。
いつものデータベースを確認する
練習用サイトの準備を済ませ、weekend-note フォルダーでコマンド入力画面を開きます。doctor は手元のファイルを直接調べるので、開発サーバーを停止していても使えます。
npx emdash doctor既定の診断先は、今いるフォルダーの data.db です。まず database の行に表示される場所を見てください。想定したファイルなら、続きの項目を読みます。
| 練習サイトで表示された項目 | 読み方 |
|---|---|
database | 指定した場所にDBファイルがあるか |
migrations | EmDash内部のDB構造を更新する処理がどこまで済んだか。none pending は適用待ちが0件という意味 |
collections | 記事などの入れ物がいくつ定義されているか。記事そのものの件数とは別 |
datetime storage | DBに保存されたコンテンツの日時が所定の形式か |
users | 管理画面の利用者が登録されているか。練習サイトでは1人 |
All checks passed と出たら、今回表示された診断項目はすべて通っています。記事の表示や画像の読み込みは、該当するページをブラウザーで開いて確認します。
診断先を指定して、結果を項目別に読む
npx emdash doctor --database ./data.db --json--database は調べるSQLiteファイルを指定します。./ は今いるフォルダーです。--json を付けると、診断結果を配列で受け取れます。各項目の name は検査名、status は結果、message はその説明です。
status | 実際に確認した例 | 次に見る場所 |
|---|---|---|
pass | 登録したユーザーが1人いて、users が通った | 続きの項目を読む |
warn | 入力欄だけを再現した別の練習用DBで、登録ユーザーが0人だった | 編集に使うサイトなら、管理画面の初期設定が済んでいるか確認する |
fail | 指定した場所にファイルがなく、database に not found が出た | 表示されたファイルの場所と名前を確認する |
終了コードは、処理が終わるときにコマンドが返す数字です。診断結果に fail があれば 1、すべて pass なら 0 でした。warn だけが残っている場合も 0 なので、自動チェックで警告を拾いたいときは、各項目の status も読んでください。
database で止まったとき
練習サイトなら、VS Codeで data.db が見えるフォルダーを開いているか確認します。ファイルが別の場所にある場合は、--database にその場所を指定し直します。
今回動かしたのは手元のSQLiteに対する診断です。Cloudflareなどに公開したサイトの応答は、表示・画像・接続の問題を切り分けるガイドで確認できます。