Table-Level Alterations - Teradata Vantage - Analytics Database

SQL Data Definition Language Syntax and Examples

Deployment
VantageCloud
VantageCore
Edition
VMware
Enterprise
IntelliFlex
Product
Analytics Database
Teradata Vantage
Release Number
17.20
Published
June 2022
ft:locale
en-US
ft:lastEdition
2025-11-06
dita:mapPath
jco1628111346878.ditamap
dita:ditavalPath
qkf1628213546010.ditaval
dita:id
mdr1472255012272
lifecycle
latest
Product Category
Teradata Vantageā„¢

Example: Update Map

ALTER FOREIGN TABLE ParquetTab1, MAP = TD_MAP2;

Example: Update Simplified Authorization

ALTER FOREIGN TABLE ParquetTab1, EXTERNAL SECURITY s3_auth1;

Example: Update Legacy Authorization

ALTER FOREIGN TABLE ParquetTab1, EXTERNAL SECURITY DEFINER TRUSTED TDAWSEDBS_AUTH2;

Example: Update FALLBACK Attribute and Authorization

ALTER FOREIGN TABLE JSONTab1, FALLBACK,
EXTERNAL SECURITY DEFINER TRUSTED TDAWSEDBS_AUTH2;

Example: Update LOCATION

ALTER FOREIGN TABLE ParquetTab1
UPDATE
LOCATION ('/s3/td-usgs-public.s3.amazonaws.com/PARQUETDATA/09394500');

Example: Update PATHPATTERN and ROWFORMAT

ALTER FOREIGN TABLE CSVTab1
UPDATE
PATHPATTERN ('$year/$month/$day')
ROWFORMAT ('{"record_delimiter":"\n","character_set":"UTF8"}')
;

Example: Alter Both Column-Level and Table-Level Attributes

DROP is a column-level alteration; UPDATE is a table-level alteration.

ALTER FOREIGN TABLE ParquetTab1
DROP Precipitation
UPDATE LOCATION  ('/s3/td-usgs-public.s3.amazonaws.com/PARQUETDATA/09394500')
       PATHPATTERN  ('$Var1/$Var2/$var3');

Example: Alter PARTITION BY Clause

This example does not use the Tables for Examples.

ALTER FOREIGN TABLE CRIMEDATA
  MODIFY PARTITION BY (
    COLUMN, CITY VARCHAR(3), ARREST_YEAR INT, ARREST_MONTH VARCHAR(10)
  );