X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass%2FManual%2FGlossary.pod;h=b245dc941c4019165ee01a01524a54370f417995;hb=51bec050485100ecaf8584325a7e9bce9d4fd6bc;hp=3e9d36a5846656b468f80ab961413d3e4fc04a19;hpb=880a1a0cc6a48a3165656fe5daf7ec288901c3e2;p=dbsrgits%2FDBIx-Class-Historic.git diff --git a/lib/DBIx/Class/Manual/Glossary.pod b/lib/DBIx/Class/Manual/Glossary.pod index 3e9d36a..b245dc9 100644 --- a/lib/DBIx/Class/Manual/Glossary.pod +++ b/lib/DBIx/Class/Manual/Glossary.pod @@ -4,12 +4,61 @@ DBIx::Class::Manual::Glossary - Clarification of terms used. =head1 INTRODUCTION -This document lists various terms used in DBIx::Class and attempts to explain them. +This document lists various terms used in DBIx::Class and attempts to +explain them. =head1 TERMS +=head2 DB schema + +Refers to a single physical schema within an RDBMS. Synonymous with the terms +'database', for MySQL; and 'schema', for most other RDBMS(s). + +In other words, it's the 'xyz' _thing_ you're connecting to when using any of +the following L(s): + + dbi:DriverName:xyz@hostname:port + dbi:DriverName:database=xyz;host=hostname;port=port + +=head2 Inflation + +The act of turning database row data into objects in +language-space. DBIx::Class further allows you to inflate your data +into perl objects which more usefully represent their contents. For +example: L for datetime or +timestamp column data. + +=head2 Join + +This is an SQL keyword that gets mentioned a lot. It is used to fetch +data from more than one table at once, by Cing the tables on +fields where they have common data. + +=head2 Normalisation + +A normalised database is a sane database. Each table contains only +data belonging to one concept, related tables refer to the key field +or fields of each other. Some links to webpages about normalisation +can be found in L. + =head2 ORM +Object-relational mapping, or Object-relationship modelling. Either +way it's a method of mapping the contents of database tables (rows), +to objects in programming-language-space. DBIx::Class is an ORM. + +=head2 Relationship + +In DBIx::Class a relationship defines the connection between exactly +two tables. The relationship condition lists the columns in each table +that contain the same values. It is used to output an SQL JOIN +condition between the tables. + +=head2 Relationship bridge + +A relationship bridge, such as C defines an accessor to +retrieve row contents across multiple relationships. + =head2 ResultSet This is an object representing a set of data. It can either be an