Difference between revisions of "Schema:titles"

From ISFDB
Jump to navigation Jump to search
(2016 update)
Line 17: Line 17:
 
  |                  |  'INTERIORART', 'EDITOR', 'ESSAY',    |      |    |        |                |
 
  |                  |  'INTERIORART', 'EDITOR', 'ESSAY',    |      |    |        |                |
 
  |                  |  'INTERVIEW', 'NOVEL', 'NONFICTION',  |      |    |        |                |
 
  |                  |  'INTERVIEW', 'NOVEL', 'NONFICTION',  |      |    |        |                |
  |                  |  'NONGENRE', 'OMNIBUS', 'POEM',       |      |    |        |                |
+
  |                  |  'OMNIBUS', 'POEM', 'REVIEW', 'SERIAL' |      |    |        |                |
  |                  |  'REVIEW','SERIAL', 'SHORTFICTION',    |      |    |         |                |
+
  |                  |  'SHORTFICTION', 'CHAPBOOK')          |      |    |         |                  |                             | YES  | MUL | NULL    |                |
|                  |   'CHAPTERBOOK')                        | YES  | MUL | NULL    |                |
 
 
  | title_wikipedia  | mediumtext                              | YES  |    | NULL    |                |
 
  | title_wikipedia  | mediumtext                              | YES  |    | NULL    |                |
 
  | title_views      | int(11)                                | NO  |    | 0      |                |
 
  | title_views      | int(11)                                | NO  |    | 0      |                |
Line 34: Line 33:
 
==Description==
 
==Description==
  
* '''title_id''' - This column is the unique record id for the titles table. A title may be referred to by this unique id.  
+
* '''title_id''' - Unique record id for the titles table.
  
* '''title_title''' - This column holds the work's title.  
+
* '''title_title''' - The work's title.  
  
* '''title_translator''' - NOT USED (This column was supposed to hold information concerning translations. The format was supposed to be Translation;Translation;Translation, where each translation was of the form Language,Year,Translator.)
+
* '''title_translator''' - '''Not Used''' (This column was supposed to hold information concerning translations. The format was supposed to be Translation;Translation;Translation, where each translation was of the form Language,Year,Translator.)
  
* '''title_synopsis''' - This column holds a pointer to a free-form note in the notes table. The note describes the basic synopsis of the work.  
+
* '''title_synopsis''' - A pointer to a free-form note in the notes table. The note describes the basic synopsis of the work.  
  
* '''note_id''' - This column contains pointer to free-form note found in the notes table.  
+
* '''note_id''' - A pointer to free-form note found in the notes table.  
  
* '''series_id''' - This column contains a pointer to the ID of a record found in the series table.  
+
* '''series_id''' - Series number associated with this title and stored in the series table.  
  
* '''title_seriesnum''' - This column contains the series number of this title.
+
* '''title_seriesnum''' - This title's number within its series
  
* '''title_copyright''' - This column contains the date of first publication. This is NOT necessarily the work's copyright year, despite the misleading name.
+
* '''title_copyright''' - The date of first publication. This is NOT necessarily the work's copyright year, despite the misleading name.
  
 
* '''title_storylen''' - This column has been overloaded to mean numerous things. For shortfiction, the valid values are nv=novella, nt=novelette, ss=shortstory, sf=shortfiction (unknown length). For novels, the valid values are jvn=juvenile, nvz=novelization. For omnibuses, valid values look like "/1,2+ss". This field will be changed in the future.  
 
* '''title_storylen''' - This column has been overloaded to mean numerous things. For shortfiction, the valid values are nv=novella, nt=novelette, ss=shortstory, sf=shortfiction (unknown length). For novels, the valid values are jvn=juvenile, nvz=novelization. For omnibuses, valid values look like "/1,2+ss". This field will be changed in the future.  
  
* '''title_ttype''' - This column identifies the title type. Allowable values are 'ANTHOLOGY', 'CHAPBOOK', 'COLLECTION', 'COVERART', 'INTERIORART', 'EDITOR', 'ESSAY', 'INTERVIEW', 'NOVEL', 'NONFICTION', 'OMNIBUS', 'POEM', 'REVIEW', 'SERIAL', 'SHORTFICTION', 'CHAPBOOK'. Another option 'BACKCOVERART' is allowed by the table definition, but not used by the software.
+
* '''title_ttype''' - The type of this title. Allowable values are listed in the field definition. Note that 'BACKCOVERART' is allowed by the table definition but not used by the software.
  
* '''title_wikipedia''' - NOT USED (This column was originally used hold the URL of a Wikipedia article, but is empty now.)
+
* '''title_wikipedia''' - '''Not Used'''. (This column was originally used to hold the URL of a Wikipedia article, but is empty now.)
  
* '''title_views''' - This column contains the number of times a particular title has been viewed.
+
* '''title_views''' - The number of times this title has been viewed.
  
* '''title_parent''' - This column is a pointer to a parent title. If zero, this title record is a canonical title; if non-zero, this title record is a variant title, and the column refers to the parent canonical title.
+
* '''title_parent''' - ID of this title's parent title. If zero, this title record is a canonical title; if non-zero, this title record is a variant title, and the column refers to the parent canonical title.
  
* '''title_rating''' - This column contains this title's average vote rating. This column is recalculated whenever a users posts a vote against this particular title. This column is set only when 5 or more votes exist for the title.
+
* '''title_rating''' - This title's average vote rating. This value is recalculated whenever a users posts a vote for this title. This column is set only when 5 or more votes exist for the title.
  
* '''title_annualviews''' - This column contains the number of times a particular title has been viewed in the current calendar year.
+
* '''title_annualviews''' - The number of times this title has been viewed in the current calendar year.
  
* '''title_ctl''' - NOT USED (Originally this column was supposed to contain exception bits which could be then used to control the title display under distinct unique conditions.)
+
* '''title_ctl''' - '''Not Used''' (Originally this column was supposed to contain exception bits which could be then used to control the title display under certain conditions.)
  
* '''title_language''' - This column may contain an integer value which refers to the ID of a record found in the languages table.
+
* '''title_language''' - ID of this title's language. Points to a record found in the "languages" table.
  
* '''title_seriesnum_2''' - This column contains the part of the series number to the right of the decimal point (if one is present.)
+
* '''title_seriesnum_2''' - The part of the series number to the right of the decimal point (if one is present.)
  
* '''title_non_genre''' - This column indicates whether this title non-genre. The valid vales are 'Yes' and 'No'.
+
* '''title_non_genre''' - Indicates whether this title non-genre. The valid vales are 'Yes' and 'No'.
  
* '''title_graphic''' - This column indicates whether this title is graphic in nature. The valid values are 'Yes' and 'No'. Note that COVERART and INTERIORART titles are not considered graphic.
+
* '''title_graphic''' - Indicates whether this title is graphic in nature. The valid values are 'Yes' and 'No'. Note that COVERART and INTERIORART titles are not considered graphic.

Revision as of 20:28, 3 September 2016

Schema Summary

+-------------------+-----------------------------------------+------+-----+---------+----------------+
| Field             | Type                                    | Null | Key | Default | Extra          |
+-------------------+-----------------------------------------+------+-----+---------+----------------+
| title_id          | int(11)                                 | NO   | PRI | NULL    | auto_increment |
| title_title       | mediumtext                              | YES  | MUL | NULL    |                |
| title_translator  | mediumtext                              | YES  |     | NULL    |                |
| title_synopsis    | int(11)                                 | YES  |     | NULL    |                |
| note_id           | int(11)                                 | YES  | MUL | NULL    |                |
| series_id         | int(11)                                 | YES  | MUL | NULL    |                |
| title_seriesnum   | int(11)                                 | YES  |     | NULL    |                |
| title_copyright   | date                                    | YES  |     | NULL    |                |
| title_storylen    | mediumtext                              | YES  |     | NULL    |                |
| title_ttype       | enum('ANTHOLOGY', 'BACKCOVERART',       |      |     |         |                |
|                   |   'COLLECTION', 'COVERART',             |      |     |         |                |
|                   |   'INTERIORART', 'EDITOR', 'ESSAY',     |      |     |         |                |
|                   |   'INTERVIEW', 'NOVEL', 'NONFICTION',   |      |     |         |                |
|                   |   'OMNIBUS', 'POEM', 'REVIEW', 'SERIAL' |      |     |         |                |
|                   |   'SHORTFICTION', 'CHAPBOOK')           |      |     |          |                   |                              | YES  | MUL | NULL    |                |
| title_wikipedia   | mediumtext                              | YES  |     | NULL    |                |
| title_views       | int(11)                                 | NO   |     | 0       |                |
| title_parent      | int(11)                                 | NO   | MUL | 0       |                |
| title_rating      | float                                   | YES  |     | NULL    |                |
| title_annualviews | int(11)                                 | NO   |     | 0       |                |
| title_ctl         | int(10) unsigned                        | NO   |     | 0       |                |
| title_language    | int(11)                                 | YES  |     | NULL    |                |
| title_seriesnum_2 | varchar(4)                              | YES  |     | NULL    |                |
| title_non_genre   | enum('Yes','No')                        | YES  |     | No      |                |
| title_graphic     | enum('Yes','No')                        | YES  |     | No      |                |
+-------------------+-----------------------------------------+------+-----+---------+----------------+

Description

  • title_id - Unique record id for the titles table.
  • title_title - The work's title.
  • title_translator - Not Used (This column was supposed to hold information concerning translations. The format was supposed to be Translation;Translation;Translation, where each translation was of the form Language,Year,Translator.)
  • title_synopsis - A pointer to a free-form note in the notes table. The note describes the basic synopsis of the work.
  • note_id - A pointer to free-form note found in the notes table.
  • series_id - Series number associated with this title and stored in the series table.
  • title_seriesnum - This title's number within its series
  • title_copyright - The date of first publication. This is NOT necessarily the work's copyright year, despite the misleading name.
  • title_storylen - This column has been overloaded to mean numerous things. For shortfiction, the valid values are nv=novella, nt=novelette, ss=shortstory, sf=shortfiction (unknown length). For novels, the valid values are jvn=juvenile, nvz=novelization. For omnibuses, valid values look like "/1,2+ss". This field will be changed in the future.
  • title_ttype - The type of this title. Allowable values are listed in the field definition. Note that 'BACKCOVERART' is allowed by the table definition but not used by the software.
  • title_wikipedia - Not Used. (This column was originally used to hold the URL of a Wikipedia article, but is empty now.)
  • title_views - The number of times this title has been viewed.
  • title_parent - ID of this title's parent title. If zero, this title record is a canonical title; if non-zero, this title record is a variant title, and the column refers to the parent canonical title.
  • title_rating - This title's average vote rating. This value is recalculated whenever a users posts a vote for this title. This column is set only when 5 or more votes exist for the title.
  • title_annualviews - The number of times this title has been viewed in the current calendar year.
  • title_ctl - Not Used (Originally this column was supposed to contain exception bits which could be then used to control the title display under certain conditions.)
  • title_language - ID of this title's language. Points to a record found in the "languages" table.
  • title_seriesnum_2 - The part of the series number to the right of the decimal point (if one is present.)
  • title_non_genre - Indicates whether this title non-genre. The valid vales are 'Yes' and 'No'.
  • title_graphic - Indicates whether this title is graphic in nature. The valid values are 'Yes' and 'No'. Note that COVERART and INTERIORART titles are not considered graphic.