Project

General

Profile

« Previous | Next » 

Revision 5666

schemas/vegbien.sql: taxonlabel, taxonverbatim: Updated comments for new taxonlabel/taxonverbatim split

View differences:

schemas/vegbien.my.sql
1099 1099

  
1100 1100

  
1101 1101
--
1102
-- Name: COLUMN taxonverbatim.morphospecies; Type: COMMENT; Schema: public; Owner: -
1103
--
1104

  
1105

  
1106

  
1107

  
1108
--
1102 1109
-- Name: analytical_db_view; Type: VIEW; Schema: public; Owner: -
1103 1110
--
1104 1111

  
schemas/vegbien.sql
564 564

  
565 565
Note that taxonepithet stores only one rank (e.g. family) of the full taxonomic name. The higher-level ranks are stored in the taxon label''s chain of parent_id ancestors.
566 566

  
567
To include a taxon name at a rank with no explicit column, create a parent taxonlabel for it and point to it using parent_id. To include multiple such names, chain the taxonlabels together using parent_id. Note that lower-level taxa should point to higher-level taxa.
568

  
569 567
Equivalent to VegBank''s plantConcept and plantName tables, plus plantParent_ID and plantLevel from plantStatus.';
570 568

  
571 569

  
......
619 617
-- Name: COLUMN taxonlabel.parent_id; Type: COMMENT; Schema: public; Owner: -
620 618
--
621 619

  
622
COMMENT ON COLUMN taxonlabel.parent_id IS 'The parent taxonlabel. Note that while a taxon *name* may have multiple parents, a taxon *label* has only one, based on the creator''s opinion of where that taxonlabel goes in the taxonomic hierarchy.';
620
COMMENT ON COLUMN taxonlabel.parent_id IS 'The parent taxonlabel. Note that while a taxon *name* may have multiple parents, a taxonlabel *instance* has only one, based on the creator''s opinion of where that taxonlabel goes in the taxonomic hierarchy.';
623 621

  
624 622

  
625 623
--
626 624
-- Name: COLUMN taxonlabel.taxonepithet; Type: COMMENT; Schema: public; Owner: -
627 625
--
628 626

  
629
COMMENT ON COLUMN taxonlabel.taxonepithet IS 'The epithet of the taxon within its parent taxon. This is the lowest-rank portion of this taxonlabel''s full taxonomic name, if it has one.
627
COMMENT ON COLUMN taxonlabel.taxonepithet IS 'The epithet of the taxon within its parent taxon. This is the lowest-rank portion of this taxonlabel''s full taxonomic name, if it has one.';
630 628

  
631
The morphospecies suffix goes in this field.';
632 629

  
633

  
634 630
--
635 631
-- Name: COLUMN taxonlabel.rank; Type: COMMENT; Schema: public; Owner: -
636 632
--
637 633

  
638
COMMENT ON COLUMN taxonlabel.rank IS 'The taxonlabel''s level in the taxonomic hierarchy, standardized to a closed list. Even if you specify a custom verbatimrank, you should also specify a closest-match rank from the taxonrank closed list.';
634
COMMENT ON COLUMN taxonlabel.rank IS 'The taxon''s level in the taxonomic hierarchy, standardized to a closed list. Even if you specify a custom verbatimrank in taxonverbatim, you should also specify a closest-match rank from the taxonrank closed list.';
639 635

  
640 636

  
641 637
--
642 638
-- Name: COLUMN taxonlabel.taxonomicname; Type: COMMENT; Schema: public; Owner: -
643 639
--
644 640

  
645
COMMENT ON COLUMN taxonlabel.taxonomicname IS 'The taxonomic name that uniquely identifies this taxonlabel. If set, the other fields will not be used in duplicate elimination.';
641
COMMENT ON COLUMN taxonlabel.taxonomicname IS 'The concatenated taxonomic name which uniquely identifies this taxon, including the author of that name. Must be unique within the datasource.
646 642

  
643
Equivalent to Darwin Core''s scientificName.';
647 644

  
645

  
648 646
--
649 647
-- Name: taxonlabel_update_ancestors(taxonlabel, integer); Type: FUNCTION; Schema: public; Owner: -
650 648
--
......
1516 1514
-- Name: COLUMN taxonverbatim.verbatimrank; Type: COMMENT; Schema: public; Owner: -
1517 1515
--
1518 1516

  
1519
COMMENT ON COLUMN taxonverbatim.verbatimrank IS 'The taxonlabel''s verbatim level in the taxonomic hierarchy. Does not need to be in the taxonrank closed list.';
1517
COMMENT ON COLUMN taxonverbatim.verbatimrank IS 'The taxon''s verbatim level in the taxonomic hierarchy. Does not need to be in the taxonrank closed list.';
1520 1518

  
1521 1519

  
1522 1520
--
......
1548 1546
-- Name: COLUMN taxonverbatim.family; Type: COMMENT; Schema: public; Owner: -
1549 1547
--
1550 1548

  
1551
COMMENT ON COLUMN taxonverbatim.family IS 'The family of the taxonomic name. This is a cached field for easy querying; the identifying version of this field is stored in the chain of parent_id ancestors.';
1549
COMMENT ON COLUMN taxonverbatim.family IS 'The family of the taxonomic name. This is a cached field for easy querying; this should also be stored in taxonlabel at the appropriate rank.';
1552 1550

  
1553 1551

  
1554 1552
--
1555 1553
-- Name: COLUMN taxonverbatim.genus; Type: COMMENT; Schema: public; Owner: -
1556 1554
--
1557 1555

  
1558
COMMENT ON COLUMN taxonverbatim.genus IS 'The genus portion of the taxonomic name. This is a cached field for easy querying; the identifying version of this field is stored in the chain of parent_id ancestors.';
1556
COMMENT ON COLUMN taxonverbatim.genus IS 'The genus portion of the taxonomic name. This is a cached field for easy querying; this should also be stored in taxonlabel at the appropriate rank.';
1559 1557

  
1560 1558

  
1561 1559
--
1562 1560
-- Name: COLUMN taxonverbatim.species; Type: COMMENT; Schema: public; Owner: -
1563 1561
--
1564 1562

  
1565
COMMENT ON COLUMN taxonverbatim.species IS 'The species portion of the taxonomic name. This is a cached field for easy querying; the identifying version of this field is stored in the chain of parent_id ancestors.';
1563
COMMENT ON COLUMN taxonverbatim.species IS 'The species portion of the taxonomic name. This is a cached field for easy querying; this should also be stored in taxonlabel at the appropriate rank.';
1566 1564

  
1567 1565

  
1568 1566
--
1567
-- Name: COLUMN taxonverbatim.morphospecies; Type: COMMENT; Schema: public; Owner: -
1568
--
1569

  
1570
COMMENT ON COLUMN taxonverbatim.morphospecies IS 'The morphospecies suffix.';
1571

  
1572

  
1573
--
1569 1574
-- Name: analytical_db_view; Type: VIEW; Schema: public; Owner: -
1570 1575
--
1571 1576

  

Also available in: Unified diff