DF_DATABASE_IGNORE_UCASE_SUPPORT

Indicates if uppercase support used for case insensitive index segments should be ignored.

Level

Database

Supported by

The DataFlex SQL Drivers (SQL Server, DB2 and ODBC), revision 5 and higher

Type

Boolean, temporary

Access

Read/Write

Values

True, False

Syntax

Use cli.pkg

Get_Attribute DF_DATABASE_IGNORE_UCASE_SUPPORT of {driverNumber} {databaseHandle} to {BooleanVariable}

Set_Attribute DF_DATABASE_IGNORE_UCASE_SUPPORT of {driverNumber} {databaseHandle} to {True|False}

Driver Configuration Keyword

Ignore_Ucase_Support

Remarks

The Embedded Database supports case insensitive index segments. This is a feature that other databases do not support. Some databases support case insensitive columns (by using a case insensitive collating sequence for a column). When converting a table that uses case insensitive index segments, extra columns will be created that store the uppercased value of the original column. This extra column is used in index definitions as a segment to achieve the case insensitive index segment functionality. In order to be able to generate the correct find statements, the driver uses the back end’s uppercase scalar function in the WHERE clause of the SELECT statement generated to implement a find.

This attribute will switch the case insensitive index segment logic on or off. When ignored (true) it is switched off, when not ignored (false) it is switched on.

Procedure ShowDBAttribute Integer iDriver Handle hDatabase

    Boolean bAttribValue

    Get_Attribute DF_DATABASE_IGNORE_UCASE_SUPPORT of iDriver hDatabase to bAttribValue      

    Showln "Ignore uppercase support: " (If(bAttribValue, "YES", "NO"))

End_Procedure                                                          

The sample code above shows the current setting for a given database. The database handle can be obtained via the DF_DATABASE_ID attribute.