CREATE FOREIGN TABLE SQL Statement | VantageCloud Lake - CREATE FOREIGN TABLE - Teradata Vantage

Teradata® VantageCloud Lake

Deployment
VantageCloud
Edition
Lake
Product
Teradata Vantage
Published
January 2023
Language
English (United States)
Last Update
2024-04-03
dita:mapPath
phg1621910019905.ditamap
dita:ditavalPath
pny1626732985837.ditaval
dita:id
phg1621910019905

Foreign tables enable Teradata Vantage™ to access data in external object storage, such as semi-structured and unstructured data in Amazon S3, Azure Blob storage, and Google Cloud Storage. In-database integration of this data allows data scientists and analysts to read and process this data with Vantage, using standard SQL. You can join external data to relational data in Vantage, and process it using built-in Vantage analytics and functions.

The external data can be in standard data formats such as JSON, CSV, and Parquet.

Creating a foreign table requires specifying the location of the data. You must also specify the credentials, except if you are using AWS IAM.

CREATE FOREIGN TABLE creates a foreign table with a PARTITION BY clause even if you do not specify one. The PARTITION BY clause determines the virtual columns. HELP TABLE output identifies virtual columns.

ANSI Compliance

This statement is a Teradata extension to the ANSI SQL:2011 standard.

Required Privileges

You must have the CREATE TABLE privilege on the database or user in which the table is created.

Privileges Granted Automatically

The creator has the following privileges WITH GRANT OPTION on the newly created table:
  • DROP TABLE
  • SELECT
For more information about database privileges, see Database Privileges.