知識マップ: PDB（プログラムデータベース）とは何か ── デバッグ情報・シンボル・Source Linkを理解する

記事「PDB（プログラムデータベース）とは何か ── デバッグ情報・シンボル・Source Linkを理解する」の主張を、概念と関係(エッジ)に分解した知識グラフの全体です。各関係には根拠・確認日・確度が付いています。

PDBはビルド後の.dll/.exeとソースコードを結びつけるデバッグ情報ファイルで、アプリケーションの実行そのものには不要だが、例外スタックトレースの行番号表示やダンプ解析にはPDBが必要になる。.NET Core以降はクロスプラットフォームなPortable PDBが中心になり、csprojのDebugTypeでportable・embedded・noneなどの生成方式を構成する。Source LinkはPDBに記録されたリポジトリ情報からビルド時点のコミットのソースを取得する仕組みで、シンボルサーバーや.snupkgはPDB自体を配布・保管する経路であり役割が異なる。外部配布ではローカル変数名まで含むprivate symbolsではなく関数名に絞ったpublic symbolsが推奨され、PDBを消してしまうと決定的ビルドでも完全な再現は難しいため、CI/CDでコミットIDやビルド番号と紐づけて必ず保管することが実務上の推奨である。

flowchart LR
    accTitle: PDBとデバッグ情報エコシステムの知識マップ
    accDescr: PDBがバイナリとソースを結びつけるデバッグ情報であること、Portable PDBとWindows PDBの違い、DebugTypeによる生成方式の切り替え、Source Link・シンボルサーバー・snupkgによるPDBの配布経路、ダンプ解析やスタックトレース表示にPDBが必要になること、CI/CDでの保管がPDB喪失を防ぐことを示す図
    pdb["PDB(プログラムデータベース)"]
    stack_trace_line_number["スタックトレースのファイル名・行番号表示"]
    dump_analysis["ダンプ解析"]
    windows_pdb["Windows PDB"]
    windbg["WinDbg"]
    snupkg[".snupkg(NuGetシンボルパッケージ)"]
    portable_pdb["Portable PDB"]
    symbol_server["シンボルサーバー"]
    debugtype_msbuild["DebugType(MSBuildプロパティ)"]
    embedded_pdb["embedded PDB"]
    source_link["Source Link"]
    just_my_code["Just My Code"]
    cicd_pdb_retention["CI/CDでのPDB保管"]
    pdb_loss["PDBの喪失"]
    deterministic_build["決定的ビルド(Deterministic Build)"]
    private_symbols["private symbols"]
    pdb_external_distribution["PDBの外部配布"]
    public_symbols["public symbols"]
    stack_trace_line_number -->|"前提とする"| pdb
    dump_analysis -->|"前提とする"| pdb
    dump_analysis -.->|"前提とする"| windows_pdb
    dump_analysis -.->|"利用する"| windbg
    windows_pdb -->|"両立しない"| snupkg
    snupkg -->|"前提とする"| portable_pdb
    snupkg -->|"に保存される"| symbol_server
    portable_pdb -.->|"の後継"| windows_pdb
    pdb -->|"で構成できる"| debugtype_msbuild
    embedded_pdb -->|"で構成できる"| debugtype_msbuild
    source_link -->|"前提とする"| pdb
    source_link -.->|"両立しない"| just_my_code
    pdb -.->|"に保存される"| symbol_server
    cicd_pdb_retention -.->|"利用する"| symbol_server
    cicd_pdb_retention -->|"推奨される対応"| pdb
    cicd_pdb_retention -->|"防止する"| pdb_loss
    deterministic_build -.->|"軽減する"| pdb_loss
    private_symbols -->|"用いるのは非推奨"| pdb_external_distribution
    public_symbols -->|"推奨される対応"| pdb_external_distribution
    symbol_server -.->|"推奨される対応"| pdb_external_distribution

概念間の関係(全20件)

図と同じ関係を文章でも列挙します。表示している文と機械可読な意味データ(RDFa)は同じ要素に載っています。確度が「確立した関係」のものは直接の関係として、「条件付きの関係」のものは成立条件つきの言明(rdf:Statement)として表現しています。

• スタックトレースのファイル名・行番号表示はPDB(プログラムデータベース)を前提とします。.NETの例外スタックトレースでファイル名・行番号まで表示させるには、対応するPDBが読み込まれている必要がある / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• ダンプ解析はPDB(プログラムデータベース)を前提とします。ダンプに写るスタックやモジュールを人間が読める名前やソース行へ変換するには、対応するPDBが必要になる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• ダンプ解析はWindows PDBを前提とします。ネイティブコードを含むダンプ解析では、アドレス・関数・型・ローカル変数を読むためにWindows PDBが重要になる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• ダンプ解析はWinDbgを利用します。ネイティブを含む場合のダンプ解析では、WinDbgのシンボル設定が重要になる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• Windows PDBは.snupkg(NuGetシンボルパッケージ)と両立しません。NuGet.orgのシンボルサーバーではPortable PDBのみサポートされ、C++などが生成するWindows PDBは.snupkgとして受け付けられない / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• .snupkg(NuGetシンボルパッケージ)はPortable PDBを前提とします。.snupkgは基本的に管理コードのPortable PDB向けの配布形式である / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• .snupkg(NuGetシンボルパッケージ)はシンボルサーバーに保存されます。.snupkgとして公開したシンボルパッケージはNuGet.orgのシンボルサーバーに保存され、デバッグ時に必要な分だけ取得される / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• Portable PDBはWindows PDBの後継に当たります。.NET Core以降のSDKスタイルプロジェクトでは、既定でPortable PDBが使われるようになり、Windows PDBは.NET Frameworkや従来のVisual C++開発で見る機会が中心になっている / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• PDB(プログラムデータベース)はDebugType(MSBuildプロパティ)で構成できます。PDBの生成有無・出力形式(portable/embedded/full/pdbonly/none)はcsprojのDebugTypeプロパティで構成する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• embedded PDBはDebugType(MSBuildプロパティ)で構成できます。DebugTypeをembeddedに指定すると、Portable PDB相当のデバッグ情報が別ファイルではなく.dll/.exeへ埋め込まれる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• Source LinkはPDB(プログラムデータベース)を前提とします。Source Linkは、PDBに記録されたリポジトリ情報とコミット参照があって初めて機能する仕組みである / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• Source LinkはJust My Codeと両立しません。Just My Codeが有効で外部コード扱いのままだと、Source Linkが設定されていても外部ライブラリへのステップインができない / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• PDB(プログラムデータベース)はシンボルサーバーに保存されます。シンボルサーバーで配布・保管する場合、PDBはファイル名ではなくバイナリとの一致情報に基づいて整理された形で保存・発行できる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• CI/CDでのPDB保管はシンボルサーバーを利用します。CI/CDでのPDB保管パターンの1つとして、ビルド時にPDBを社内シンボルサーバーへ発行する運用がある / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• CI/CDでのPDB保管はPDB(プログラムデータベース)に対する本記事の推奨です。本番障害調査に備えて、ビルドで生成されたPDBをコミットID・ビルド番号と紐づけてCI/CDの成果物として必ず保管することが本記事の一貫した推奨である / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• CI/CDでのPDB保管はPDBの喪失を防ぎます。コミットID・ビルド番号と紐づけてPDBをCI/CDの成果物として保管しておけば、PDBの喪失によって調査ができなくなる事態を防げる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 決定的ビルド(Deterministic Build)はPDBの喪失を軽減します。決定的ビルドを整えていれば、SDKバージョンやNuGet解決結果のズレによる再現性の低さは軽減されるが、それでも保管が最優先とされる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• private symbolsをPDBの外部配布に用いることは推奨されません。ローカル変数名や型情報などの詳細を含むprivate symbolsは、外部へ配布するシンボルとしては推奨されない / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• public symbolsはPDBの外部配布に対する本記事の推奨です。関数名やアドレスなど公開用に絞ったpublic symbolsは、外部へ配布する際に本記事が推奨する形である / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• シンボルサーバーはPDBの外部配布に対する本記事の推奨です。外部配布アプリケーションではPDBをそのまま同梱せず、public symbolsに絞る、またはシンボルサーバー経由で必要な分だけ取得させる、といった選択肢を取ることが本記事で推奨されている / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典

主要概念の定義

PDB(プログラムデータベース)

ビルド後の.dll/.exeと、ソースコード上の行・変数名を結びつけるデバッグ情報ファイル。アプリケーションの実行には通常不要だが、デバッグ・例外調査・ダンプ解析に使う。

スタックトレースのファイル名・行番号表示

.NETの例外スタックトレースで、対応するソースファイル名と行番号まで表示させる機能。PDBが読み込まれているときに有効になる。

ダンプ解析

クラッシュやハングなどで取得したプロセスのダンプファイルから、スタックや変数、型を人間が読める名前やソース行に変換して調べる作業。

Windows PDB

Visual C++や.NET Framework時代のプロジェクトなど、従来のWindowsネイティブ開発で使われるPDB形式。

.snupkg(NuGetシンボルパッケージ)

NuGetのシンボルパッケージ形式で、管理コードのPortable PDBを配布するために使う。NuGet.orgのシンボルサーバーではPortable PDBのみサポートされる。

Portable PDB

.NET/.NET Core以降で使われる、Windowsだけでなくクロスプラットフォームで扱えるPDB形式。

embedded PDB

DebugTypeをembeddedに指定し、Portable PDB相当のデバッグ情報を別ファイルにせず.dll/.exeへ埋め込む方式。

Source Link

PDBに記録されたリポジトリ情報とコミット参照を使って、デバッガーがGitHub等からそのバイナリをビルドしたコミット時点のソースファイルを取得できるようにする仕組み。

CI/CDでのPDB保管

コミットID・ビルド番号・成果物(.dll/.exe/.pdb)をセットで保管し、本番バイナリに対応するPDBを後から取り出せるようにするCI/CDの運用。

決定的ビルド(Deterministic Build)

同じソース・同じ設定からビルドすれば同一の成果物が得られるようにするビルドの性質。.NETコンパイラのDeterministicオプションや`ContinuousIntegrationBuild`プロパティで関わる。

private symbols

ローカル変数・型・引数などを含む、完全に近い内部情報を持つシンボル情報。

public symbols

関数名やアドレスなど、公開用に絞られたシンボル情報。

シンボルサーバー

PDBなどのシンボルファイルを、ファイル名ではなくバイナリとの一致情報に基づいて整理し、デバッガーが必要なときに取得できるようにする仕組み。

機械可読データ

• JSON-LD / Turtle ── この記事の知識グラフ全体
• 概念一覧 / 語彙(述語)の定義

このページはサイトの知識グラフ(_data/knowledge/)から自動生成されています。誤りの指摘はお問い合わせからお願いします。