doctor の診断項目と終了コード

手元のSQLiteを診断するコマンドです。DBの場所、更新の適用状況、ユーザー登録をどこで確かめるかと、結果の読み方をまとめます。

目次

手元のデータベースを開けるか、初期設定がどこまで済んでいるかを確かめたいときは、doctor を使います。練習サイトのSQLiteには、記事や入力欄、ユーザーなどが1個のファイルに保存されています。

いつものデータベースを確認する

練習用サイトの準備を済ませ、weekend-note フォルダーでコマンド入力画面を開きます。doctor は手元のファイルを直接調べるので、開発サーバーを停止していても使えます。

npx emdash doctor

既定の診断先は、今いるフォルダーの data.db です。まず database の行に表示される場所を見てください。想定したファイルなら、続きの項目を読みます。

練習サイトで表示された項目読み方
database指定した場所にDBファイルがあるか
migrationsEmDash内部のDB構造を更新する処理がどこまで済んだか。none pending は適用待ちが0件という意味
collections記事などの入れ物がいくつ定義されているか。記事そのものの件数とは別
datetime storageDBに保存されたコンテンツの日時が所定の形式か
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などに公開したサイトの応答は、表示・画像・接続の問題を切り分けるガイドで確認できます。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。