index - Analytics Database - Teradata Vantage

SQL Data Definition Language Syntax and Examples

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
VMware
Product
Analytics Database
Teradata Vantage
Release Number
17.20
Published
June 2022
Language
English (United States)
Last Update
2024-10-04
dita:mapPath
jco1628111346878.ditamap
dita:ditavalPath
qkf1628213546010.ditaval
dita:id
mdr1472255012272
lifecycle
latest
Product Category
Teradata Vantage™
MAP
You can specify an existing contiguous or sparse map for the hash index.
For a sparse map, you can specify a colocation name. A hash index can have different map or colocation name than the base tables.
map_name
Name of an existing contiguous or sparse map.
You cannot specify TD_DataDictonaryMap or TD_GlobalMap.
colocation_name
Name for colocating the hash index on the same AMPs with other tables, join indexes, or hash indexes. For example, you can colocate two tables, then join the tables on the primary index or primary AMP index columns.
You can only specify this option for a sparse map. For a contiguous map, the colocation_name is not needed for colocation and is set to NULL.
If you do not specify a colocation name, the name defaults to database_index, where database is the name of the database or user followed by an underscore (_) and index is the name of the hash index. If database exceeds 63 characters, database is truncated to 63 characters. If index exceeds 64 characters, index is truncated to 64 characters.
NO
The hash index does not use fallback protection.
You cannot use the NO FALLBACK option and the NO FALLBACK default on platforms optimized for fallback.
If a hash index is not fallback protected, an AMP failure prevents the following events from occurring:
  • Processing queries on the hash index
  • Updating the table on which the hash index is defined
FALLBACK
The hash index uses fallback protection.
The default is to use the fallback specification for the database in which the hash index is defined.
When a hardware read error occurs, the file system reads the fallback copy of the data and reconstructs the rows in memory on their home AMP. Support for Read From Fallback is limited to the following cases:
  • Requests that do not attempt to modify data in the bad data block
  • Primary subtable data blocks
  • Reading the fallback data in place of the primary data. In some cases, Active Fallback can repair the damage to the primary data dynamically. In situations where the bad data block cannot be repaired, Read From Fallback substitutes an error-free fallback copy of the corrupt rows each time the read error occurs.
PROTECTION

Optional keyword.

CHECKSUM
A table-specific disk I/O integrity checksum level. The checksum setting applies to primary and fallback data rows for the hash index.
If you do not specify a value, the system assumes the system-wide default value for this table type. The result is identical to specifying DEFAULT. If you are changing the checksum for this table to the system-wide default value, then specify DEFAULT.
ON
Calculate checksums using the entire disk block. Sample 100% of the disk blocks to generate a checksum.
DEFAULT
The default setting is the current DBS Control checksum setting specified for this table type.
OFF
Disables checksum disk I/O integrity checks.
BLOCKCOMPRESSION
Specifies whether the data in the hash index should be block-compressed based on the temperature of the cylinders on which it is stored.
You can specify the following settings for block_compression_option.
AUTOTEMP
The compressed state of the data in the hash index can be changed by Vantage at any time based on its temperature.
You can still issue query band options or Ferret commands, but if the compressed state of the data does not match its temperature, such changes might be undone by the system over time.
DEFAULT
The hash index uses the compression option (MANUAL, AUTOTEMP or NEVER) set in the DBS Control parameter DefaultTableMode. For details, see Teradata Vantage™ - Database Utilities, B035-1102. Note that value of DefaultTableMode is not saved in the hash index definition as part of a CREATE HASH INDEX request, so a hash index set to DEFAULT is affected by any future change to the DefaultTableMode parameter.
MANUAL
That block level compression is applied based on the default for the hash index at the time the hash index is created. Hash indexes can be compressed or uncompressed at any time after loading by using the Ferret COMPRESS and UNCOMPRESS commands. Data inserted into the existing hash index inherits the current compression status of the hash index at the time the data is inserted.
NEVER
The hash index is not compressed even if the DBS Control block compression settings indicate otherwise. Vantage rejects Ferret commands to manually compress the hash index, but Ferret commands to decompress the index are valid.