Set Up Assume Role on the Database - Teradata VantageCloud Lake

Lake - Manage and Move Data

Deployment
VantageCloud
Edition
Lake
Product
Teradata VantageCloud Lake
Release Number
Published
February 2025
ft:locale
en-US
ft:lastEdition
2025-05-16
dita:mapPath
atx1683670417382.ditamap
dita:ditavalPath
pny1626732985837.ditaval
dita:id
atx1683670417382
The following is required to complete these steps:
  • ARN obtained from creating the IAM on AWS
  • Vantage Site ID obtained from your Teradata account team.
  1. First, complete the steps in Set Up Assume Role on AWS.
  2. On Analytics Database create an authorization object for access to the external object storage or ask your administrator to create it. For example:
    CREATE AUTHORIZATION AUTH_S3
    USING
    AUTHSERVICETYPE 'ASSUME_ROLE'
    ROLENAME 'arn:aws:iam::915556001112:role/teradata_role'
    EXTERNALID '915556001112'
    DURATION_SECONDS '7200';
    Where:
    • ROLENAME contains the ARN obtained from creating the IAM on AWS.
    • EXTERNALID is your Vantage Site ID.
    • [OPTIONAL] DURATION_SECONDS is the duration in seconds of the role session, used in the execution of CREATE FOREIGN TABLE, SELECT, READ_NOS, and WRITE_NOS.
      When you omit this clause, the default value is 3600 seconds.

    For more examples creating authorization objects, see CREATE AUTHORIZATION and REPLACE AUTHORIZATION Examples.

  3. Access the external object storage using READ_NOS, WRITE_NOS, or a foreign table. For example, the following query selects data from the S3 bucket using READ_NOS:
    SELECT * FROM (
      LOCATION = '/s3/sts-test.s3.amazonaws.com/csv_default.csv'
      AUTHORIZATION = S3_auth) as dt;