codeDB Lens

codeDB Lens

データベースが見せてくれないものを確認しましょう。
SQL Server と PostgreSQL 向けの無料の読み取り専用ヘルスチェックです。

ウェブサイト · 英語 · ポルトガル語（ブラジル）

_{テスト用 SQL Server に対する実際の実行結果です（ホスト名は変更済み）。デモレポートを開く。}

---

v0.8： check（エグゼクティブサマリーと、共有用の --redact を追加）、compare、および最大 24 時間にわたってインスタンスを監視する record + report（詳細）。ルールは 26 個、記録用ルールは 8 個です。FAQ などはウェブサイトをご覧ください。

codeDB Lens は読み取り専用のログインでインスタンスに接続し、根拠に基づくルール集を実行して、A～F の評価とカバレッジシール（実際に実行できたルールの割合）を含む、自己完結型の HTML + JSON レポートを作成します。データベースの情報がマシンの外に出ることはありません。

インストール

場所	方法
Windows	インストーラー（ユーザー単位、管理者権限不要） または ポータブル版 .zip
Windows（Scoop）	scoop bucket add codedb https://github.com/codedb-io/codedb-lens を実行し、続けて scoop install codedb/codedb-lens を実行
Linux	最新リリースの .deb / .rpm、または x64 / arm64 用の tarball
Docker	docker run --rm -e PG_DSN -v "$PWD:/out" ghcr.io/codedb-io/codedb-lens check --engine pg --dsn-env PG_DSN --out /out

Windows バイナリはオープンソースですが、まだコード署名されていないため、SmartScreen が警告を表示する場合があります。 理由とダウンロードの確認方法をご覧ください。

なぜ別のツールが必要なのか？

• 意見ではなく、根拠を示します。 各検出結果には、収集した値、その取得に使ったクエリ、取得時刻が表示されます。
• 信頼度を誠実に示します。 各検出結果は Confirmed、Hint、No data のいずれかです。権限が不足しているルールが誤って「OK」と表示されることはなく、代わりにカバレッジが下がります。
• 常に読み取り専用です。 DDL も DML も使わず、エージェントもサーバーへのインストールも必要ありません。
• ルールはデータです。 各ルールは YAML ファイルと SQL クエリで構成されます。コントリビューションでエンジンに手を加える必要はありません。
• アプリ、CLI、レポートは**英語とポルトガル語（ブラジル）**に対応しています。

チェック項目

SQL Server	PostgreSQL
バックアップがない、または古い	サポート対象外のバージョン
最近の DBCC CHECKDB が正常に完了していない	pg_stat_statements が利用できない
失敗している SQL Agent ジョブ	単一のクエリが実行時間の大半を占めている
ディスクまたはトランザクションログの空き容量が不足している	長時間にわたるアイドル状態のトランザクションセッション
支配的な待機状態の翻訳	ロックによってブロックされているセッション
現在ブロックされているセッション	トランザクション ID の周回リスク
単一のクエリが CPU を大半使用している	デッドタプルが増え、自動バキュームが追いついていない
インスタンス設定が既定値のまま	WAL を保持しているレプリケーションスロット、レプリカの遅延
TempDB のファイルレイアウト	接続数が上限に近い、コネクションプーラーがない
サポート対象外のバージョン	未使用、重複、無効なインデックス
影響の大きい不足インデックス	テーブルの推定肥大化
未使用および重複インデックス	最大サイズのテーブル

各ルールには、チェック内容、重要な理由、対処方法、制限事項を説明するドキュメントページがあります。

クイックスタート

Windows では、スタートメニューから codeDB Lens を開きます。エンジンを選択し、サーバーを入力して診断を実行します。 接続プロファイルは保存され、パスワードは Windows 資格情報マネージャーに保存されます。

コマンドライン（Windows および Linux）：

codedb-lens check --engine mssql --server prod01 --auth windows
codedb-lens check --engine pg --dsn-env PG_DSN

コマンドライン引数としてパスワードを受け取ることはありません。統合認証、環境変数、または保存済みのプロファイルを使用してください。

AI（MCP）での利用

_{テスト用データベースに対する実際の Claude Code セッション。回答は短縮されています。}

データベースについて Claude、GitHub Copilot、または Cursor に質問できます。codedb-lens mcp は、保存済みのプロファイルを使い、AI クライアントがお使いのコンピューター上で起動する読み取り専用の MCP サーバーです。

• 診断：Lens の最小限のログインを使って、AI がヘルスチェックを実行し、記録を読み取って、修正すべき内容を説明します。業務データは読み取りません。
• データ：選択したテーブルを読み取れるログインを使って、AI がテーブルを一覧表示して説明し、行数と時間の制限内で、一度に 1 つの SELECT を使って質問に回答します。

codedb-lens mcp install --client claude-desktop --profile prod   # or vscode, cursor, claude-code

アプリの AI（MCP） 画面には、コピーして使えるコマンドが用意されています。ガイド：lens.codedb.com.br/mcp。

最小限の権限

-- SQL Server
CREATE LOGIN codedb_lens WITH PASSWORD = '<strong password>';
GRANT VIEW SERVER STATE TO codedb_lens;
GRANT VIEW ANY DEFINITION TO codedb_lens;
GRANT CONNECT ANY DATABASE TO codedb_lens;   -- per-database rules (indexes); no data access
USE msdb;
CREATE USER codedb_lens FOR LOGIN codedb_lens;
ALTER ROLE db_datareader ADD MEMBER codedb_lens;
ALTER ROLE SQLAgentReaderRole ADD MEMBER codedb_lens;

-- PostgreSQL (repeat GRANT CONNECT for each database)
CREATE ROLE codedb_lens LOGIN PASSWORD '<strong password>';
GRANT pg_monitor TO codedb_lens;
GRANT CONNECT ON DATABASE app TO codedb_lens;

対応バージョン

エンジン	対応	ベストエフォート
SQL Server	2017、2019、2022、2025（Windows および Linux）、Azure SQL Managed Instance、Amazon RDS	2016 以前、Azure SQL Database（13 個のルールのうち 6 個が適用されます。権限を参照）
PostgreSQL	15、16、17、18、Amazon RDS、Aurora、Azure Flexible Server	14

プライバシー

テレメトリはありません。Lens は 2 種類のネットワーク通信を行います。GitHub Releases に対して 1 日 1 回、データを送信しない任意のバージョンチェック（--no-update-check または CODEDB_LENS_NO_UPDATE=1 で無効化できます）と、無料キーをリクエストした場合に限り、入力した名前とメールアドレスを送信する登録リクエスト 1 件（更新時は現在のキーのみを送信します）です。SECURITY.mdを参照してください。

継続的な監視が必要ですか？

Lens はその時点の状態を表示します。codeDBは SQL Server と PostgreSQL のインスタンスを 24 時間体制で監視し、履歴、ベースライン、Teams、Slack、メールによるアラートを提供します。

Windows のコード署名

Windows バイナリは、このリポジトリから GitHub Actions によってビルドされていますが、まだコード署名されていません（証明書は有料で、このプロジェクトは無料のためです）。詳細、ダウンロードの検証方法、警告を表示させない代替手段については、Windows で警告が表示される理由を参照してください。

コントリビューション

新しいルールを歓迎します。ルールは YAML ファイルと SQL クエリで構成されるため、Go コードを変更する必要はありません。CONTRIBUTING.mdを参照するか、ルールのアイデアを添えてイシューを作成してください。

ライセンス

Apache 2.0。codeDB SaaS とその API は、別個のクローズドソース製品です。