jmdict_db_schema.rst

   1 ==================\r
   2  JMdict DB Schema\r
   3 ==================\r
   4 \r
   5 Original JMdict XML format (summarized)\r
   6 =======================================\r
   7 \r
   8 ::\r
   9 \r
  10   Entry\r
  11     - ent_seq\r
  12     * k_ele\r
  13       - keb\r
  14       * ke_inf\r
  15       * ke_pri\r
  16     + r_ele\r
  17       - reb\r
  18       ? re_nokanji\r
  19       * re_restr\r
  20       * re_inf\r
  21       * re_pri\r
  22     ? info\r
  23       * links\r
  24         - link_tag\r
  25         - link_desc\r
  26         - link_uri\r
  27       * bibl\r
  28         ? bib_tag\r
  29         ? bib_txt\r
  30       * etym (UNUSED)\r
  31       * audit\r
  32         - upd_date\r
  33         - upd_detl\r
  34     + sense\r
  35       * stagk\r
  36       * stagr\r
  37       * pos\r
  38       * xref*  # not sure why it's (#PCDATA)*...\r
  39       * ant*   # not sure why it's (#PCDATA)*...\r
  40       * field\r
  41       * misc\r
  42       * s_inf\r
  43       * lsource\r
  44       * dial\r
  45       * gloss\r
  46         * pri (UNUSED)\r
  47       * example\r
  48 \r
  49 Description of JMdict SQLite database design\r
  50 ============================================\r
  51 \r
  52 Basically, the table structure of the SQLite 3 database follows this\r
  53 very closely.  Here's generally how it's designed:\r
  54 \r
  55 1. All tables (except entry) have two integer keys, always named id\r
  56    and fk.  id is an auto-increment value, while fk is used for\r
  57    joining tables.  (fk is of course indexed.)\r
  58 \r
  59 2. Any data with a one-to-one relationship with a parent XML node was\r
  60    moved into a column for the parent node's table.  (Example: <keb>\r
  61    is now k_ele.value.)\r
  62 \r
  63 3. Attributes have similar but usually different names than in JMdict.\r
  64    Generally speaking, if an attribute had a prefix (like xml:lang or\r
  65    ls_wasei), it is stored without it (as lang or wasei).\r
  66 \r
  67 4. Info nodes have a one-to-one relationship with entries, so there's\r
  68    no table for them.  XML children of the <info> element are linked\r
  69    directly to the entry table rather than to a meaningless\r
  70    intermediate table.\r
  71 \r
  72 Examples\r
  73 ========\r
  74 \r
  75 Example 1: 魚 (entry 1578010)\r
  76 \r
  77 ::\r
  78 \r
  79   SELECT * FROM entry\r
  80   LEFT JOIN k_ele ON entry.id = k_ele.fk\r
  81   LEFT JOIN ke_inf ON k_ele.id = ke_inf.fk\r
  82   LEFT JOIN ke_pri ON k_ele.id = ke_pri.fk\r
  83   WHERE entry.ent_seq = 1578010\r
  84 \r
  85 Result:\r
  86 \r
  87 ========  =============  ========  ========  ===========  =========  =========  =============  =========  =========  ============\r
  88 entry.id  entry.ent_seq  k_ele.id  k_ele.fk  k_ele.value  ke_inf.id  ke_inf.fk  ke_inf.entity  ke_pri.id  ke_pri.fk  ke_pri.value\r
  89 ========  =============  ========  ========  ===========  =========  =========  =============  =========  =========  ============\r
  90 55777     1578010        48939     55777     魚           None       None       None           42889      48939      ichi1\r
  91 55777     1578010        48939     55777     魚           None       None       None           42890      48939      ichi2\r
  92 55777     1578010        48939     55777     魚           None       None       None           42891      48939      news1\r
  93 55777     1578010        48939     55777     魚           None       None       None           42892      48939      nf03\r
  94 ========  =============  ========  ========  ===========  =========  =========  =============  =========  =========  ============\r