Module Documentation: eml-constraint
Back to EML Contents
The eml-constraint schema defines the integrity constraints between entities (e.g., dataTables) as would be maintained in a relational database. These constraints include primary key constraints, foreign key constraints, unique key constraints, check constraints, and not null constraints, among potential others.

Element Definitions:

primaryKey
Content of this field: Description of this field:
Elements: Required?: How many:
A sequence of (
keyOptionalMultiple Times
)
Attributes: Required?: Default Value:

Description:
The primaryKey element declares the primary key in the entity to which the defined constraint pertains.
Example:
date
key
Content of this field: Description of this field:
Elements: Required?: How many:
A sequence of (
attributeReferenceOptionalMultiple Times
)
Attributes: Required?: Default Value:

Description:
The key element defines the set of attributes to which this constraint applies. For a primary key or a unique key, the set of attributes must be identifying. For a foreign key, the set of attributes must match an identifying key in the referenced entity. For a 'not null' constraint, the key indicates the attribute which should not be null.
Example:
site
attributeReference
Content of this field: Description of this field:
Type: xs:string
Attributes: Required?: Default Value:

Description:
The attributeReference element is the name of an attribute that can be found in the identified entity. This name will be unique within an entity and specifies that the attribute participates in the key that is being defined.
Example:
site
uniqueKey
Content of this field: Description of this field:
Elements: Required?: How many:
A sequence of (
keyOptionalMultiple Times
)
Attributes: Required?: Default Value:

Description:
The uniqueKey element represents a unique key within the referenced entity. This is different from a primary key in that it does not form any implicit foriegn key relationships to other entities, however it is required to be unique within the entity.
Example:
date
key
Content of this field: Description of this field:
Elements: Required?: How many:
A sequence of (
attributeReferenceOptionalMultiple Times
)
Attributes: Required?: Default Value:

Description:
The key element defines the set of attributes to which this constraint applies. For a primary key or a unique key, the set of attributes must be identifying. For a foreign key, the set of attributes must match an identifying key in the referenced entity. For a 'not null' constraint, the key indicates the attribute which should not be null.
Example:
date, site, plot
attributeReference
Content of this field: Description of this field:
Type: xs:string
Attributes: Required?: Default Value:

Description:
The attributeReference element contains the name of an attribute that can be found in the identified entity. This name will be unique within an entity and specifies that the attribute participates in the key that is being defined.
Example:
site
checkConstraint
Content of this field: Description of this field:
Elements: Required?: How many:
A sequence of (
checkConditionOptionalMultiple Times
)
Attributes: Required?: Default Value:
languageoptional

Description:
The checkConstraint element defines a constraint which checks a conditional clause within an entity.
Example:
if site>1 then plot>10
checkCondition
Content of this field: Description of this field:
Type: xs:string
Attributes: Required?: Default Value:

Description:
The checkCondition element defines an SQL statement or other language implementation of the condition for a check constraint. Generally this provides a means for constraining the values within and among entities.
Example:
(year > 1900 and year < 1990)
foreignKey
Content of this field: Description of this field:
Elements: Required?: How many:
Attributes: Required?: Default Value:

Description:
The foreignKey element defines a foreign key relationship among entities which relates this entity to another's primary key.
joinCondition
Content of this field: Description of this field:
Elements: Required?: How many:
A sequence of (
referencedKeyOptionalMultiple Times
)
Attributes: Required?: Default Value:

Description:
The joinCondition element describes any join of two tables that is not done with a primary/foreign key relationship.
Example:
JOIN code
referencedKey
Content of this field: Description of this field:
Elements: Required?: How many:
A sequence of (
attributeReferenceOptionalMultiple Times
)
Attributes: Required?: Default Value:

Description:
The referencedKey element defines set of attributes to which a foreign key constraint refers. If the key refers to the primary key in the referenced entity, then the "referencedKey" is optional. For a foreign key, the set of attributes must match an identifying key in the referenced entity.
Example:
site, plot
attributeReference
Content of this field: Description of this field:
Type: xs:string
Attributes: Required?: Default Value:

Description:
The attributeReference element is the name of an attribute that can be found in the identified entity. This name will be unique within an entity and specifies that the attribute participates in the key that is being defined.
notNullConstraint
Content of this field: Description of this field:
Elements: Required?: How many:
A sequence of (
keyOptionalMultiple Times
)
Attributes: Required?: Default Value:

Description:
The notNullConstraint element defines a constraint that indicates that no null values should be present for an attribute in this entity.
key
Content of this field: Description of this field:
Elements: Required?: How many:
A sequence of (
attributeReferenceOptionalMultiple Times
)
Attributes: Required?: Default Value:

Description:
The key element defines the set of attributes to which this constraint applies. For a primary key or a unique key, the set of attributes must be identifying. For a foreign key, the set of attributes must match an identifying key in the referenced entity. For a 'not null' constraint, the key indicates the attribute which should not be null.
attributeReference
Content of this field: Description of this field:
Type: xs:string
Attributes: Required?: Default Value:

Description:
The attributeReference element is the name of an attribute that can be found in the identified entity. This name will be unique within an entity and specifies that the attribute participates in the key that is being defined.
constraintName
Content of this field: Description of this field:
Type: xs:string
Attributes: Required?: Default Value:

Description:
The constraintName element is a name which represents a human readible and meaningful name for the constraint.
Example:
PrimaryKey_birdSurvey
constraintDescription
Content of this field: Description of this field:
Elements: Required?: How many:
Attributes: Required?: Default Value:

Description:
The constraintDescription element describes the nature of the constraint. It might be a description of a check condition, or a statement about the composition of a primary key or the nature of the relationship between two database tables or two ascii files.
Example:
1.Must be greater than 0 but less than 100 2. "The primary key of the table BIRD_SURVEY is composed of two attributes:speciesCode and observationDate 3. The species name associated with the species code in survey.txt can be found in the file speciesList.txt
key
Content of this field: Description of this field:
Elements: Required?: How many:
A sequence of (
attributeReferenceOptionalMultiple Times
)
Attributes: Required?: Default Value:

Description:
The key element defines the set of attributes to which this constraint applies. For a primary key or a unique key, the set of attributes must be identifying. For a foreign key, the set of attributes must match an identifying key in the referenced entity. For a 'not null' constraint, the key indicates the attribute which should not be null.
attributeReference
Content of this field: Description of this field:
Type: xs:string
Attributes: Required?: Default Value:

Description:
The attributeReference element is the name of an attribute that can be found in the identified entity. This name will be unique within an entity and specifies that the attribute participates in the key that is being defined.
entityReference
Content of this field: Description of this field:
Type: xs:string
Attributes: Required?: Default Value:

Description:
The entityReference element contains the id of the entity to which a foreign key refers, otherwise known as the parent-entity or parent-table. This should be an identifer that matches one of the "identifier" elements for an entity.
Example:
knb.79.4
relationshipType
Content of this field: Description of this field:
Elements: Required?: How many:
Attributes: Required?: Default Value:

Description:
The relationshipType element defines identifying relationships that propagate from the parent entity's primary key to the child's primary key. Non-identifying relationships propagate the parent's primary key as a non-key attribute of the child entity.
Example:
felationshipType code
cardinality
Content of this field: Description of this field:
Elements: Required?: How many:
A sequence of (
parentOccurencesOptionalMultiple Times
childOccurencesOptionalMultiple Times
)
Attributes: Required?: Default Value:

Description:
The cardinality element represents a statement of the relationship between parent and child entities. Cardinality is expressed as the ratio of related parent and child entities. Cardinality 1 to N is a specific form of cardinalty in which zero or one parent records are related to a specified number of child records. The cardinality ratio for the parent entity depends on whether the "existence" is mandatory (one or more) or optional (zero to ...).
Example:
One to many
parentOccurences
Content of this field: Description of this field:
Elements: Required?: How many:
Attributes: Required?: Default Value:

Description:
The parentOccurences element describes the Parent portion of a 1 to exactly N cardinality. May have a value of either 0 or 1. Value of 0 implies that the "existence" of a child record is optional. Value of 1 implies that the "existence" of a child record is mandatory.
Example:
One to 10, Zero or One to Many
childOccurences
Content of this field: Description of this field:
Type: CardinalityChildOccurancesType
Attributes: Required?: Default Value:

Description:
The childOccurences element describes the child portion of a cardinality expression Allowed values are positive integers including zero or the string value "many"
Example:
2, 15, many

Attribute Definitions:

language

Type: xs:string

Use: optional


Description:
The language element declares the language that is used to implement the check constraint. This is typically the name and version of a programming language such as Java, C, Perl, Basic, or other. Sometime it is the name and version of a scriptable analysis system such as SAS, Matlab, R, or SPlus.
Example:
perl 5.6.1
id

Type: xs:string

Use: optional

system

Type: xs:string

Use: optional

scope

Type: res:ScopeType

Use: optional

Complex Type Definitions:

ConstraintType
Content of this field: Description of this field:
Elements: Required?: How many:
A choice of (
primaryKeyOptionalMultiple Times
OR
uniqueKeyOptionalMultiple Times
OR
checkConstraintOptionalMultiple Times
OR
foreignKeyOptionalMultiple Times
OR
joinConditionOptionalMultiple Times
OR
notNullConstraintOptionalMultiple Times
)
Attributes: Required?: Default Value:
idoptional
systemoptional
scopeoptional

Description:
The ConstraintType type describes the relational integrity constraints of a relational database. This includes primary keys, foreign keys, unique keys, etc. When an eml-constraint module is created, it should be linked into a dataset using the "triple" element, and all of the entities that are referenced in the constraints should be accessible within that same package.

Simple Type Definitions:

CardinalityChildOccurancesType


Description:
The CardinalityChildOccurancesType element defines the child portion of a cardinality expression. Allowed values are positive integers including zero or the string value "many".
Example:
0,1, 2, 15,many

Derived from: xs:string (by xs:restriction)

Allowed values:

  • many

Derived from: xs:string (by xs:restriction)

Allowed values:

  • identifying
  • non-identifying

Derived from: xs:integer (by xs:restriction)

Allowed values:

  • 0
  • 1

Web Contact: jones@nceas.ucsb.edu