Integration: Relational Databases

MySQL

Overview | Environments | Databases | Tables | Constraints | Datatypes | Queries | Updates | Example


Tables

The CREATE TABLE Statement

The CREATE TABLE statement is used to declare a MySQL table or view within an Omnidex Environment File. The Omnidex Environment File will contain a declaration for each MySQL table or view to be accessed, and will correlate all of the schema information between Omnidex and MySQL, including object names and datatypes. This statement can either be issued directly, or it can be extracted from MySQL using the EXTRACT statement as discussed in the previous section.

The following example compares the MySQL declarations with the Omnidex declarations.

MySQL CREATE TABLE Statement

create table STATES
       (STATE_CD                CHAR(2),
        DESCRIPTION             VARCHAR(31),
        STATE_NUM               CHAR(2),
        REGION_CD               CHAR(2),
        COUNTRY_CD              CHAR(2),
        TAX_RATE                DOUBLE);

Omnidex CREATE TABLE Statement

create table          "STATES"
 physical             "STATES"
 (
  "STATE"             CHARACTER(2)   physical "STATE_CD",
  "DESCRIPTION"       STRING(31),
  "STATE_CODE"        CHARACTER(2)   physical "STATE_NUM",
  "REGION"            CHARACTER(2)   physical "REGION_CD",
  "COUNTRY"           CHARACTER(2)   physical "COUNTRY_CD",
  "TAX_RATE"          FLOAT
 )
 in                   "simple.xml";

In the Omnidex declaration, note that the PHYSICAL clause for table points to the actual MySQL table name. Also note that the columns use the PHYSICAL clause to point to the underlying MySQL column name, and use Omnidex datatypes rather tha MySQL datatypes.

Modifying Omnidex's View of the MySQL Data Objects

When Omnidex accesses a table, it only knows about the data objects that are declared in the Omnidex Environment File. It does not have an independent understanding of the MySQL environment. This allows administrators to shape the Omnidex Environment the way they want. Some of the opportunities this provides are:

Referencing MySQL Views

Omnidex table declarations can reference MySQL Views. Omnidex will retrieve from the MySQL view just as though it is a table. MySQL Views can be used to provide different views of the data, appropriate for the application.

When referencing a MySQL view, it is necessary to declare a UNIQUE constraint. This requirement for the UNIQUE constraint is independent of any PRIMARY or FOREIGN constraints, discussed in the next page. The UNIQUE constraint tells Omnidex how to uniquely identify a row. When Omnidex retrieves individual rows, it will use this unique value; therefore, it is important that access to this column (or columns) be properly indexed in the underlying table.

MySQL CREATE VIEW Statement

create view STATES_VIEW 
 (
   CTRY_DESCRIPTION,
   CTRY_CAPITAL,
   STATE_CD,
   DESCRIPTION,
   STATE_NUM,
   REGION_CD,
   COUNTRY_CD,
   TAX_RATE
 ) as 
   select C.DESCRIPTION,
          C.CAPITAL,
          S.STATE_CD,
          S.DESCRIPTION,
          S.STATE_NUM,
          S.REGION_CD,
          S.COUNTRY_CD,
          S.TAX_RATE
   from   SIMPLE.STATES S, SIMPLE.COUNTRIES C
   where  S.COUNTRY_CD = C.COUNTRY_CD;

Omnidex CREATE TABLE Statement

create table          "STATES_VIEW"
 physical             "STATES_VIEW"
 (
  "CTRY_DESCRIPTION"  STRING(47),
  "CTRY_CAPITAL"      STRING(31),
  "STATE"             CHARACTER(2)   physical "STATE_CD",
  "DESCRIPTION"       STRING(31),
  "STATE_CODE"        CHARACTER(2)   physical "STATE_NUM",
  "REGION"            CHARACTER(2)   physical "REGION_CD",
  "COUNTRY"           CHARACTER(2)   physical "COUNTRY_CD",
  "TAX_RATE"          FLOAT,
  constraint STATES_STATE_UK unique  ("STATE")
 )
 in                   "simple.xml";

Prev | Next

Additional Resources

See also: