IBM PureData System for Analytics, Version 7.1

ALTER SESSION

Mit dem ALTER SESSION-Befehl können Sie die aktive Transaktion in einer Sitzung abbrechen, die Priorität einer Sitzung festlegen oder einer Sitzung einen Tag hinzufügen oder einen Tag daraus entfernen.

Syntax

Syntax für das Abbrechen einer Transaktion in einer Sitzung:

ALTER SESSION [<Sitzungs-ID>] ROLLBACK TRANSACTION

Syntax für das Festlegen der Priorität einer Sitzung:

ALTER SESSION [<Sitzungs-ID>] SET PRIORITY TO <Priorität>

Syntax für das Hinzufügen eines Tags zu einer Sitzung oder für das Entfernen eines Tags aus einer Sitzung:

ALTER SESSION [<Sitzungs-ID>] {ADD | REMOVE} TAG <Tag>

Eingaben

Der ALTER SESSION-Befehl akzeptiert folgende Eingaben:

Tabelle 1. Eingaben für ALTER SESSION
Eingabe	Beschreibung
<Sitzungs-ID>	Die ID einer aktiven Sitzung. Wenn keine Sitzungs-ID angegeben wird, gilt der Befehl für die aktuelle Sitzung.
<Priorität>	Die Prioritätsebene, auf die die Sitzung gesetzt werden soll (CRITICAL, HIGH, NORMAL oder LOW).
<Tag>	Der Tag soll der Sitzung hinzugefügt oder daraus entfernt werden.

Ausgaben

Der ALTER SESSION-Befehl erstellt die folgenden Ausgaben:

Tabelle 2. Ausgaben von ALTER SESSION
Ausgabe	Beschreibung
`ALTER SESSION`	Der Befehl war erfolgreich.
`ERROR: permission denied`	Der Benutzer verfügt nicht über die Berechtigung zum Absetzen des Befehls für die Sitzung.
`ERROR: request exceeds maximum priority limit.`	Der Benutzer hat versucht, die Sitzungspriorität über das maximale Prioritätslimit hinaus zu erhöhen.
`ERROR: id '<Sitzungs-ID>' does not correspond to an existing session.`	Eine Sitzung mit der angegebenen ID ist nicht vorhanden.
`ERROR: system session id '<Sitzungs-ID>' cannot be aborted`	Die angegebene Sitzungs-ID bezieht sich auf die Systemsitzung. Ein Benutzer kann kein Rollback für eine Transaktion einer Systemsitzung durchführen.
`ERROR: access denied. You must have ABORT privileges to perform this action`	Der Benutzer verfügt nicht über die Berechtigung zum Durchführen eines Rollbacks für die Transaktion der Sitzung.
`ERROR: session abort failed for session <Sitzungs-ID>; reason is '<Ursache>'`	Der Versuch, ein Rollback für die aktive Transaktion der angegebenen Sitzung durchzuführen, ist aus dem angegebenen Grund fehlgeschlagen.

Berechtigungen

Jede Sitzung gehört einem Benutzer:

Für eine Sitzung, deren Eigner Sie sind:
- Sie müssen über keine speziellen Berechtigungen verfügen, um ein Rollback für die aktive Transaktion durchzuführen, um ihre Priorität (bis zum Maximalwert) festzulegen oder um einen Tag hinzuzufügen oder zu entfernen.
- Um eine Prioritätsebene festzulegen, die den maximalen Wert überschreitet, müssen Sie der Benutzer mit Administratorberechtigung sein oder über Systemverwaltungsberechtigung verfügen.
Für eine Sitzung, deren Eigner ein anderer Benutzer ist:
- Zum Ändern der Priorität der Sitzung oder zum Hinzufügen oder Ändern eines Tags müssen Sie der Benutzer mit Administratorberechtigung sein oder über Systemverwaltungsberechtigung verfügen.
- Zur Durchführung eines Rollbacks für die aktive Transaktion müssen Sie über Abbruchberechtigung für den Eigner der Sitzung verfügen.

Verwendung

Die folgenden Beispiele verdeutlichen die Verwendung:

Priorität der aktuellen Sitzung in CRITICAL ändern:

system(admin)=> ALTER SESSION SET PRIORITY TO CRITICAL;

Rollback für die aktive Transaktion der Sitzung 16011 durchführen:
```
system(admin)=> ALTER SESSION 16011 ROLLBACK TRANSACTION;
```

Der Sitzung 16011 den Tag no_more_than_2 hinzufügen:

system(admin)=> ALTER SESSION 16011 ADD TAG no_more_than_2;

Feedback | Copyright IBM Corporation 2014 | Letzte Aktualisierung: 2014-02-28