ChemOffice.Com - CambridgeSoft

act accordingly. A full list of the tables and fields
maintained by the cartridge can be found in the
heading Data Structures.
The AUX package of the cartridge can be used to
avoid compatibility problems with later versions.
The AUX package contains trivial functions, which
return the names of the tables and fields to be used
to access the tables in the cartridge schema. With
this extra care, future incompatibility can be
avoided. The functions in that package will be
explained later in the chapter. Generally, using these
functions is more complicated than using operators
returning the same value.
The best way to use data stored by the cartridge is
to create synonyms for the tables stored in the
CsCartridge schema.
CREATE SYNONYM MyWeight FOR
CsCartridge.sch_ix_W; for accessing
molecular weight
CREATE SYNONYM MyCode FOR
CsCartridge.sch_ix_A; for accessing
formula and canonical code
This way, the fields of MyMol and MyCode tables
can be used simply as if they were defined in the
user's schema. Both of these tables have a field
called RID. It contains the ROWID of the original
table. The original table and the table maintained by
the cartridge can be joined by an inner join by an
original_table.ROWID = MyCode.rid condition in
the WHERE clause. When the tables are joined, the
data fields maintained can be used. Among them
are:
• MyMol.MolWeight which stores the molecular
weight of the structure.
• MyCode.Formula contains the formula of the
structure
• MyCode.CText contains the canonical code of
the structure
These fields are indexed, so using them in the
WHERE clause of a SELECT statement may yield
enormous speed improvement compared to nonindexed
fields.
Example:
CREATE TABLE mx(id, NUMBER, m CLOB);
CREATE INDEX mxix ON mx(m) INDEXTYPE IS
CsCartridge.MoleculeIndexType;
CREATE SYNONYM MxWeight FOR
CsCartridge.schemaname_mxix_W; -
- replace schemaname with the name of your
schema
CREATE SYNONYM MxCode FOR
CsCartridge.schemaname_mxix_A; --
replace schemaname with the name of your
schema
SELECT mx.id, MxWeight.MolWeight FROM
mx, MxWeight WHERE mx.rowid =
MxWeight.rid; -- to list the identifiers and
molweights for the table
SELECT mx.id, MxCode.CText FROM mx,
MxCode WHERE mx.rowid = MxCode.rid; -
- to list the identifiers and canonical codes for the
table
SELECT mx.id, MxCode.Formula FROM mx,
MxCode WHERE mx.rowid = MxCode.rod; --
to list the identifiers and formula for the table
If two tables are to be joined by chemical identity,
then there is no better way to join them than the
CText field maintained by the cartridge. The CText
field is an index field, join by that this field saves one
table scan.
The functions of the AUX package:
• MWTabName(SchemaName VARCHAR2,
IndexName VARCHAR2)
• MWRidNameMWFldName
• FMTabName(SchemaName VARCHAR2,
IndexName VARCHAR2)
• FMRidName
ChemOffice Enterprise Workgroup & Databases 2005 CS Oracle Cartridge • 195
Using data maintained by the cartridge