15.10 - PERMANENT - Teradata Database

Teradata Database SQL Data Definition Language Syntax and Examples

prodname
Teradata Database
vrm_release
15.10
created_date
December 2015
category
Programming Reference
featnum
B035-1144-151K

A revised value for PERM space allocation for the specified user, in bytes.

n
You can enter the number of bytes as an integer, decimal, or floating point value or as a constant expression whose evaluation determines the number of bytes. You can also enter the value using exponential notation. For example, you can write one thousand as either 1000 or 1E3.
n cannot exceed the spool space parameter in the profile of the creator. If no spool space is defined for that profile, then Teradata Database uses the spool space limit defined for the individual user-creator.
constant_expression
A constant expression is any SQL expression that does not make any column references. Specifying an appropriate constant expression for the PERM space size of a database enables Teradata Database to assign an optimal quantity of PERM space that scales to the size of your system by allocating PERM space on a per AMP basis.
When you specify a PERM space size based on a constant expression, the assigned size does not automatically scale if, for example, you add more AMPs to your system.
BYTES
Optional keyword that redundantly specifies the unit for the amount of space allowed.

Example: Modifying the Permanent Space Allocation for a User

This statement changes the permanent space allocation for user peterson.

     MODIFY USER peterson AS
     PERMANENT = 6000000 BYTES;

Example: Modifying the PERM and SPOOL Space Using a Constant Expression

This example creates PERM space for a user with a size based on the constant expression 2,000,000 (HASHAMP()+1) and SPOOL with a size based on the same constant expression, 2,000,000 (HASHAMP()+1). The expressions calculate the number of AMPs in the current system and scales the PERM and SPOOL space for the sls120639 user to that size.

This is the original definition of user sls120639.

     CREATE USER sls120639 AS
       DEFAULT DATABASE = it_dev,
       PASSWORD = (EXPIRE = 0),
       PERM = 2000000*(HASHAMP()+1),
       SPOOL = 2000000*(HASHAMP()+1);

The following MODIFY USER request alters the PERM and SPOOL space allocations for this user as follows.

     MODIFY USER sls120639 AS
       DEFAULT DATABASE = it_dev,
       PASSWORD = (EXPIRE = 0),
       PERM = 3000000*(HASHAMP()+1),
       SPOOL = 3000000*(HASHAMP()+1);