Database schema / Database schema extractor options |
The fglcomp and fglform compilers expect known language data types (FGL types) in the schema file. While most data types correspond to IBM® Informix® SQL data types, some databases (including Informix) can use specific types that do not map to an FGL type. Therefore, data types in the schema file are generated from the system catalog tables according to some conversion rules.
Type conversion can be controlled with the -cv option. Each character position of the string passed by this option represents a line in the conversion table of the corresponding source database. Give a conversion code for each data type (for example: -cv AABAAAB).
When using X as conversion code, the columns using the corresponding data types will be ignored and not written to the .sch file. This is particularly useful in the case of auto-generated columns like SQL Server's uniqueidentifier data type, when using a DEFAULT NEWID() clause.
Run the tool with the -ct option to see all the data type conversion tables, or use the -cx dbtype option to display the conversion table for a given database type (dbtype must be ifx, ora, db2, msv, pgs, mys, ...).
fgldbsch -cx ifx ... ------------------------------------------------------------------ Informix Informix A Informix B ------------------------------------------------------------------ 1 BOOLEAN BOOLEAN (t=45) CHAR(1) 2 INT8 INT8 DECIMAL(19,0) 3 SERIAL8 SERIAL8 DECIMAL(19,0) 4 LVARCHAR(m) VARCHAR2(m) VARCHAR2(m) 5 BIGINT BIGINT DECIMAL(19,0) 6 BIGSERIAL BIGSERIAL DECIMAL(19,0) ------------------------------------------------------------------ (ns) = Not supported in 4gl. ... fgldbsch -db test1 -cv BAAABB 123456
In the above example, the -cv option instructs fgldbsch to use the types of the "Informix A" column for all original column types except for BOOLEAN, BIGINT and BIGSERIAL, which must be converted to a VARCHAR2(m) FGL type.
The IBM Informix LVARCHAR(m) type can be converted by default to a VARCHAR2(m) pseudo type (code 201), which will be identified as a VARCHAR(m) by compilers.
In schema files, VARCHAR2(m) (type code 201) is equivalent to VARCHAR(m) (type code 13), without the 255 bytes limitation of the original Informix VARCHAR type.
Not all native data types can be converted to FGL types. For example, user-defined types or spatial types are not supported by the language. When a table column with such unsupported data type is found, fgldbsch stops and displays an error to bring the problem to your eyes. Use the -ie option of fgldbsch to ignore the database tables having columns with unsupported types. When this option is used, none of the table columns definition will be written to the schema file.