ALTER TABLE Statement (Map and Colocation Form) | Teradata Vantage - ALTER TABLE (Map and Colocation Form) - 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™

Moves a table from one map to another. You can also change the colocation name for a sparse map.

Tables that have the same sparse map and colocation name can be joined using the same primary index or primary AMP index columns without redistributing or duplicating rows. For example, you can colocate two tables, then join the tables on the primary index or primary AMP index columns.

You can also use SQL procedures provided in the TDMaps system database to move tables from one map to another. See Teradata Vantage™ - Database Administration, B035-1093.

Required Privileges

You must have the DROP TABLE privilege for the table and you must have been granted the specified map, except when the map you specify is the current map for the table or you specify the same map determined to be the default map according to the following order of precedence:
  • If the immediate owner is not the creator:
    • Default map, if defined, for the profile of the immediate owner.
    • Default map, if defined, for the immediate owner.
    • System-default map.
  • Default map, if defined, for the profile of the creator.
  • Default map, if defined, for the creator.
  • System-default map.

See the CREATE USER DEFAULT MAP option, CREATE DATABASE DEFAULT MAP option, or CREATE PROFILE DEFAULT MAP option.

See GRANT MAP in Teradata Vantage™ - SQL Data Control Language, B035-1149.