Session functions

These functions return information about the current SurrealDB session.

session::ac

The session::ac function returns the current user's access method.

session::ac() -> string

The following example shows this function, and its output, when used in a RETURN statement:

RETURN session::ac();

"user"

session::db

The session::db function returns the currently selected database.

session::db() -> string

The following example shows this function, and its output, when used in a RETURN statement:

RETURN session::db();

"my_db"

session::id

The session::id function returns the current user's session ID.

session::id() -> string

The following example shows this function, and its output, when used in a RETURN statement:

RETURN session::id();

"I895rKuixHwCNIduyBIYH2M0Pga7oUmWnng5exEE4a7EB942GVElGrnRhE5scF5d"

session::ip

The session::ip function returns the current user's session IP address.

session::ip() -> string

The following example shows this function, and its output, when used in a RETURN statement:

RETURN session::ip();

"2001:db8:3333:4444:CCCC:DDDD:EEEE:FFFF"

session::ns

The session::ns function returns the currently selected namespace.

session::ns() -> string

The following example shows this function, and its output, when used in a RETURN statement:

RETURN session::ns();

"my_ns"

session::origin

The session::origin function returns the current user's HTTP origin.

session::origin() -> string

The following example shows this function, and its output, when used in a RETURN statement:

RETURN session::origin();

"http://localhost:3000"

session::rd

The session::rd function returns the current user's record authentication.

session::rd() -> string

session::token

The session::token function returns the current authentication token.

session::token() -> string