Example: Altering LOCATION Alters PARTITION BY - 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ā„¢

This example does not use the Tables for Examples.

Show Table before Alteration

SHOW TABLE t2;
CREATE MULTISET FOREIGN TABLE PQ.t2 ,FALLBACK ,
     EXTERNAL SECURITY DEFINER TRUSTED S3_AUTH ,
     MAP = TD_MAP1
     (
      Location VARCHAR(2048) CHARACTER SET UNICODE CASESPECIFIC,
      i1 BYTEINT,
      i2 BYTEINT,
      c1 CHAR(1) CHARACTER SET LATIN NOT CASESPECIFIC,
      c2 CHAR(1) CHARACTER SET LATIN NOT CASESPECIFIC)
USING
(
      LOCATION  ('/s3/s3.amazonaws.com/nos-opt-csv/PartitionBy/')
      MANIFEST  ('FALSE')
      PATHPATTERN  ('$var1/$year_a/$month_a/$var4')
      ROWFORMAT  ('{"field_delimiter":",","record_delimiter":"\r\n","character_set":"LATIN"}')
      STOREDAS  ('TEXTFILE')
      HEADER  ('TRUE')
      STRIP_EXTERIOR_SPACES  ('FALSE')
      STRIP_ENCLOSING_CHAR  ('NONE')
)
NO PRIMARY INDEX
PARTITION BY ( year_a SMALLINT,month_a BYTEINT );

Alter LOCATION

ALTER FOREIGN TABLE t2 UPDATE LOCATION ('/S3/s3.amazonaws.com/nos-opt-csv/PartitionBy/year_a=2021/');

Show Table after Alteration

SHOW TABLE t2;
CREATE MULTISET FOREIGN TABLE PQ.t2 ,FALLBACK ,
     EXTERNAL SECURITY DEFINER TRUSTED S3_AUTH ,
     MAP = TD_MAP1
     (
      Location VARCHAR(2048) CHARACTER SET UNICODE CASESPECIFIC,
      i1 BYTEINT,
      i2 BYTEINT,
      c1 CHAR(1) CHARACTER SET LATIN NOT CASESPECIFIC,
      c2 CHAR(1) CHARACTER SET LATIN NOT CASESPECIFIC)
USING
(
      MANIFEST  ('FALSE')
      ROWFORMAT  ('{"field_delimiter":",","record_delimiter":"\r\n","character_set":"LATIN"}')
      STOREDAS  ('TEXTFILE')
      HEADER  ('TRUE')
      STRIP_EXTERIOR_SPACES  ('FALSE')
      STRIP_ENCLOSING_CHAR  ('NONE')
      location  ('/S3/s3.amazonaws.com/nos-opt-csv/PartitionBy/year_a=2021/')
      PATHPATTERN  ('$var1/$year_a/$month_a/$var4')
)
NO PRIMARY INDEX
PARTITION BY ( month_a BYTEINT );