ChemOffice.Com - CambridgeSoft

If the Cartridge does not raise an exception, then
the CsCartridge.__E
table will
contain the rowid-s of those records containing
invalid chemical data in their indexed fields.
The rid field of this table contains the rowid of the
indexed record, and the text field may contain
additional information. A SQL statement, which
joins this table with the indexed table lists the
erroneous records.
For example, if the following is true:
• the user's schema is ‘cs_notebook’
• the indexed table name is ‘eln_structures’
• the name of the index used by the cartridge is
'sx'
• the 'key' field is a good way of identify a record,
then:
SELECT eln_structures.key from
eln_structures,
CsCartridge.CS_NOTEBOOK_SX_E
where eln_structures.rowid =
CsCartridge.CS_NOTEBOOK_SX_E .rid
will retrieve the identifying fields of those records,
which are not indexed because of an error.
Performance
The MoleculeContains operator is implemented
both as an index scan, and as a function. The query
optimizer decides which implementation to use.
If the WHERE condition contains more selective
elements then the MoleculeContains operator,
like a reference to a unique key, then Oracle will
retrieve the only matching record, and then apply
the function implementation, which will perform
an atom-by-atom matching. When the index scan is
executed, the cartridge creates a complicated query
accessing different tables. The performance of that
query can be dramatically improved by occasionally
executing an ANALYZE INDEX statement on the
INDEX created by the cartridge:
ANALYZE INDEX mx;
Executing this statement will calculate statistics on
the tables created and maintained by the cartridge,
and these statistics are used by the Oracle query
optimizer. This command should be executed
periodically depending on the frequency of the
update of the table.
Troubleshooting
If there is a serious problem with the cartridge, it is
sometimes appropriate to rerun the
CsCartridge.sql script, which will re-install the
cartridge software. After running the script every
indexed table the cartridge index should be
dropped, and re-created again. In addition, update
every record in the table by executing the following
SQL statement:
UPDATE tab SET fld=fld;
COMMIT;
This is necessary for only those tables where the
index was created without the
PARAMETERS('CsCartridge') clause.
If the problem persists, then the problem should be
reported to CambridgeSoft.
Checking the presence of the
cartridge
If the following query returns no result, then the
cartridge is not present in the Oracle database.
SELECT username from all_users
where username = 'CSCARTRIDGE'
Checking the version of the
cartridge
This following statement yields a string containing
ChemOffice Enterprise Workgroup & Databases 2005 CS Oracle Cartridge • 197
Performance