Purpose

The Alter Session statement changes various attributes of a database session or a remote session. A database session maintains the state of the overall connection. A remote session maintains the state that pertains to a particular remote data source connection.

Syntax

ALTER SESSION SET attribute_name=value

where:

attribute_name
specifies the name of the attribute to be changed. Attributes apply to either database sessions or remote sessions.
value
refers to the specific value setting for that attribute.

The following table lists the database and remote session attributes, and provides their descriptions.

Table 1. Alter Session Attributes
Attribute Name Session Type Description
Current_Schema Database Sets the current schema for the database session. The current schema is the schema used when an identifier in a SQL statement is unqualified. The string value must be the name of a schema visible in the database session. For example:

ALTER SESSION SET CURRENT_SCHEMA=sforce
Stmt_Call_Limit Database Sets the maximum number of Web service calls the driver can make in executing a statement. Setting the Stmt_Call_Limit attribute has the same effect as setting the StmtCallLimit connection option. It sets the default Web service call limit used by any statement on the connection. Executing this command on a statement overrides the previously set StmtCallLimit for the connection. The value specified must be a positive integer or 0. The value 0 means that no call limit exists. For example:

ALTER SESSION SET STMT_CALL_LIMIT=10
Ws_Call_Count Remote Resets the Web service call count of a remote session to the value specified. The value must be zero or a positive integer. WS_Call_Count represents the total number of Web service calls made to the remote data source instance for the current session. For example:

ALTER SESSION SET sforce.WS_CALL_COUNT=0

The current value of WS_Call_Count can be obtained by referring to the System_Remote_Sessions system table (see "SYSTEM_REMOTE_SESSIONS catalog table" for details). For example:

SELECT * FROM information_schema.system_remote_sessions WHERE session_id = cursessionid()