Show TOC

FP_NBIT_ENFORCE_LIMITS OptionLocate this document in the navigation structure

Enforces sizing limits for explicit and implicit NBit columns.

Allowed Values

ON, OFF

Default

OFF

Scope

Option can be set at the database (PUBLIC) or user level. At the database level, the value becomes the default for any new user, but has no impact on existing users. At the user level, overrides the PUBLIC value for that user only. No system privilege is required to set option for self. System privilege is required to set at database level or at user level for any user other than self.

Requires the SET ANY PUBLIC OPTION system privilege to set this option. Can be set temporary for an individual connection or for the PUBLIC role. Takes effect immediately.

Dependencies

FP_NBIT_ENFORCE_LIMITS applies to databases running where FP_NBIT_IQ15_COMPATIBILITY='OFF'. If FP_NBIT_IQ15_COMPATIBILITY='ON', the database engine ignores this option.

Remarks

DML operations check the FP_NBIT_ENFORCE_LIMITS option when the number of distinct values in a column exceeds the explicit limit set in an IQ UNIQUE constraint, which is above the FP_NBIT_AUTOSIZE value, or when the dictionary size for an implicit NBit rollover exceeds the FP_NBIT_ROLLOVER_MAX_MB limit.

  • If FP_NBIT_ENFORCE_LIMITS='ON', the DML operation throws an error and rolls back

  • If FP_NBIT_ENFORCE_LIMITS='OFF', the DML operation continues and the NBit dictionary limits are ignored

sp_iqindexmetadata returns details about Flat FP or NBit FP columns. sp_iqrebuildindex can change explicit or implicit NBit FP column limits, or reformat the default column index as Flat FP or NBit FP.

Using sp_iqrebuildindex to increase the number of distinct values beyond current limits for a Flat FP column when FP_NBIT_ENFORCE_LIMITS='ON', returns an error. If FP_NBIT_ENFORCE_LIMITS='OFF', sp_iqrebuildindex rebuilds the index to the maximum token, which is the largest distinct value.

Additional Information
  • Reference: Building Blocks, Tables, and Procedures > System Procedures > Alphabetical List of System Stored Procedures > sp_iqrebuildindex
  • Reference: Building Blocks, Tables, and Procedures > System Procedures ยป Alphabetical List of System Stored Procedures > sp_iqindexmetadata