SESSION MOVE - Teradata Unity

Teradata® Unity™ User Guide

Product
Teradata Unity
Release Number
16.50
Published
January 2020
Language
English (United States)
Last Update
2020-02-04
dita:mapPath
frp1571162435023.ditamap
dita:ditavalPath
ft:empty
dita:id
B035-2520
lifecycle
previous
Product Category
Analytical Ecosystem

Purpose

For sessions associated with a managed routing rule, this command changes the Teradata system for the Preferred session routing rule to another system by specifying the TDPID of that system.

For sessions associated with passive routing rules, this command moves the sessions from the current system to the one specified. The TDPID specified must be part of the routing rule associated with the session.

Syntax

SESSION MOVE {sessionid | routing} TO tdpid ;

Parameters

sessionid
Unique session identifier (ID).
routing
Unique routing rule identifier.
tdpid
Unique identifier (TDPID) of a Teradata Database system.

Usage Considerations

On sessions tagged for move, the move only occurs on the next request. The audit log tracks session changes.

Examples

At the unityadmin prompt:

Input Description
SESSION MOVE 1001 TO sys2; The example demonstrates how to force a move of session 1001 to system sys2.
SESSION MOVE prefReadOnly TO sys2; The example demonstrates how to force a move of all sessions using the prefReadOnly routing rule to system sys2.