17.10 - Working with Logon Syntax Elements - Advanced SQL Engine - Teradata Database

Teradata Vantage™ - Advanced SQL Engine Security Administration

Advanced SQL Engine
Teradata Database
Release Number
July 2021
English (United States)
Last Update

Logon string information comprises three syntax elements. In interactive command line environments, such as Teradata Basic Query Utility (BTEQ), logon elements appear as discrete elements.

Syntax Element Description
.logmech Specifies the authentication mechanism.

If a .logmech statement is not present, the logon uses the default security mechanism.

.logdata Optionally specifies user credentials for external authentication mechanisms.
Use of the .logdata statement is required:
  • If the user is authorized in a directory and must specify user=username, profile=profile_name, or realm=realm_name to differentiate among user mappings.
  • For certain expressions of the user name and password, for example: diruser@@password.

For details, see the topics for specific logon methods that follow this one.

.logon Specifies the tdpid and user credentials for all authentication methods.

For TD2 authentication, logon can also include the user account.

Not usable for external authentication, where a user=username, profile=profile_name, or realm=realm_name specification is required. Instead, use .logdata.
For applications that do not use a command line interface, logon element syntax requirements and options still apply, but you must configure the elements as defaults, or specify them in a connection GUI, depending the application you use.

Also see Working with Logon Variations by Application.