ILM

Steuern Sie mithilfe der Script-Funktion ILM die Information Lifecycle Management-Funktion (ILM). Sie können verschiedene Aktionen abhängig davon ausführen, was Sie erreichen möchten. Sie können abfragen, ob die AE-Datenbank mit ILM partitioniert oder ob ILM aktiv ist. Sie können ILM starten oder stoppen, eine Partition auswechseln oder eine Partition löschen.

Diese Seite beinhaltet Folgendes:

Allgemeine Syntax

ILM (Aktion [,Parameter [, Parameter]] )

Parameter

  • ILM
    Steuert die ILM-Funktionalität
  • Action
    Aktion, die abhängig davon, was Sie erreichen möchten, durchgeführt werden soll. Weitere Informationen finden Sie unten.
  • Parameter
    (Optional) Definitionen, die mit dem entsprechenden Parameter „Action“ einhergehen
  • Parameter
    (Optional) Definitionen, die mit dem entsprechenden Parameter „Action“ einhergehen

Installation

Syntax

ILM (INSTALLED)

Parameter

  • INSTALLED
    Fragt ab, ob die AE-Datenbank mit ILM partitioniert wurde.

Rückgabewerte:

  • Y
    Partitionierung mit ILM ist installiert
  • N
    Die AE-Datenbank ist nicht partitioniert

Beispiel

: SET &ILM# = ILM (INSTALLED )

Status

Syntax

ILM (ACTIVE)

Parameter

  • ACTIVE
    (nur MS SQL SERVER ) Fragt ab, ob ILM aktiv ist

Rückgabewerte:

  • Y
    ILM ist aktiv, neue Partitionen werden erstellt und die Daten ausgelagert
  • N
    ILM ist nicht aktiv, die Partition wird nicht geändert, und es werden keine Daten ausgelagert

Beispiel

: SET &ILM# = ILM (ACTIVE )

Start und Stopp

Syntax

ILM (START)
ILM (STOP)

Parameter

  • START
    Aktiviert ILM
    (nur MS SQL Server):

    • Falls ILM aktiv ist, werden neue Partitionen erstellt und die Daten ausgelagert.
    • Falls ILM nicht aktiv ist, wird die Partition nicht geändert, und es werden keine Daten ausgelagert.
  • STOP
    Deaktiviert ILM

Rückgabewert: Diese Script-Funktion gibt nach einem erfolgreichen Start oder Stopp den Wert „0“ oder die entsprechende Fehlernummer zurück, falls ein Fehler aufgetreten ist.

Beispiel

ILM soll deaktiviert werden.

: SET &ILM# = ILM (STOP )

Switch-Out

Syntax

ILM (SWITCHOUT [, check])

Parameter

  • SWITCHOUT
    (Nur MS SQL Server) Lagert die älteste Partition aus.

  • Check
    (Optional) Diese Einstellung gibt an, ob vor dem Auslagern der Daten eine Prüfung erfolgen soll
    Zulässige Werte:

    • CHECK (Standard)
      Das System prüft, ob die betreffende Partition Datensätze aktiver Aufgaben enthält, bevor mit dem Auslagern von Daten begonnen wird. Es findet kein Switch-Out statt, wenn es sich um aktive Aufgaben handelt.

    • NOCHECK
      Daten werden ohne vorherige Prüfung ausgelagert.

Rückgabewert: Diese Script-Funktion gibt den Wert „0“, falls die Daten erfolgreich ausgelagert wurden, oder die entsprechende Fehlernummer zurück, falls ein Fehler aufgetreten ist.

Wichtig!

  • Durch diese Script-Funktion wird eine Datenauslagerung ausgelöst, ohne dass auf ihren Abschluss gewartet wird.
  • Die Anzahl der Online-Partitionen, die der Administrator in ONLINE_PARTITIONS der Variablen UC_ILM_SETTINGS angegeben hat, ist irrelevant, beispielsweise falls vier Partitionen online sind. Durch mehrmaliges Aufrufen der Script-Funktion können Sie erreichen, dass nur drei, zwei oder eine Partition(en) online sind bzw. ist.
  • Sie können die Daten der aktuellen Partition nicht ausschalten. Mindestens eine Partition muss online sein.
  • Das Auslagern einer Partition mit Datensätzen von aktiven Aufgaben führt zu Datenverlusten.
  • Wenden Sie sich an das Support-Team, wenn Sie erzwungene Switch-Outs durchführen möchten, die aktive Aufgaben beinhalten.

Beispiel

Bevor Sie Daten auslagern, sollten Sie prüfen, ob es aktive Aufgaben gibt. Daher verwenden Sie den Standardwert des Parameters SWITCHOUT.

: SET &ILM# = ILM (SWITCHOUT )

Check

Syntax

ILM (CHECK, Partitionsnummer)

Parameter

  • CHECK
    Überprüft, ob die angegebene Partition aktive Objekte enthält.

  • Partition number
    Nummer der Partition
    Format: Script-Literal oder Script-Variable

Rückgabewert: Diese Script-Funktion gibt den Wert „0“ zurück, falls in der angegebenen Partition keine aktiven Objekte enthalten sind.

Beispiel

Die Partition "25" ist aktiviert.

: SET &ILM# = ILM (CHECK, "25")

Löschen einer Partition

Syntax

ILM (DROP, Partition [, Check])

Parameter

  • DROP
    Löscht die angegebene Partition
    Hinweis: Sie können eine Partition nur dann ohne Datenverlust löschen, falls sie keine Datensätze aktiver Aufgaben enthält.

  • Partition
    Name oder Nummer der Partition
    Format: Script-Literal oder Script-Variable
    Wichtig! Wenn Sie den Namen einer einzelnen Staging-Tabelle (MS SQL Server) angeben, wird der ILM-Datenbankbenutzer nicht für den Löschvorgang verwendet. Stattdessen wird der im Automation Engine-INI-Dateibereich [ODBC] angegebene Datenbankbenutzer verwendet. Dieser Benutzer benötigt die entsprechenden Autorisierungen für diesen Zweck.

  • Check
    (Optional, nur Oracle-Datenbanken) Diese Einstellung gibt an, ob vor dem Löschen der Partition eine Prüfung durchgeführt werden soll
    Zulässige Werte:

    • CHECK (Standard)
      Das System prüft, ob die betreffende Partition aktive Aufgaben enthält, bevor es mit dem Löschen der Partition beginnt. Es findet keine Löschung statt, wenn die Partition aktive Aufgaben enthält.
      Hinweis: Dieser Parameter ist für MS SQL Server nicht relevant, da Sie in MS SQL Server nur Staging-Tabellen löschen können. Die Prüfung für diese Tabellen erfolgte bereits beim Switch-Out.

    • NOCHECK
      Die Partition wird ohne vorherige Prüfung gelöscht

Rückgabewert: Diese Script-Funktion gibt den Wert „0“ zurück, falls die angegebene Partition bereits erfolgreich gelöscht wurde.

Beispiel

Im folgenden Beispiel wird die Partitionsnummer 25 gelöscht:

: SET &ILM# = ILM (DROP, "25")

Siehe auch: