Oracle Cloud Infrastructure-Dokumentation

Variablen erstellen und verwenden

Eine Variable ist ein Objekt, das einen einzelnen Wert speichert, der eine Zeichenfolge, eine Zahl oder ein Datum sein kann.

Themen

  • Variable erstellen
    Sie können den Wert der Variablen angeben, wenn Sie die Variable erstellen oder den Wert mit einem Abfrageausdruck festlegen.
  • Variablen in einem Datenfluss verwenden
    Sie können Variablen in einem Datenfluss verwenden, indem Sie sie als Filterdefinition verwenden. Sie können Variablen in einem Datenfluss im Format #<variable_name> referenzieren. Während der Ausführung wird die Variable durch den Wert ersetzt.
  • Variablen in einem Workflow verwenden
    Im linken Bereich der Seite "Workflowdetails" werden die Variablen aufgeführt, die Sie als Schritte in einem Workflow verwenden können.

Übergeordnetes Thema: Seite "Datentransformationen"

Eine Variable erstellen

Sie können den Wert der Variablen angeben, wenn Sie die Variable erstellen oder den Wert mit einem Abfrageausdruck festlegen.

Auf der Seite "Variablen" werden alle vorhandenen Variablen aufgeführt. Klicken Sie auf das Symbol Aktionen (Symbol "Aktionen") einer Variablen, um sie zu bearbeiten, zu aktualisieren oder zu löschen. Alle verfügbaren Variablen werden auch im linken Bereich der Seite "Workflowdetails" aufgeführt. Sie können Variablen als Schritte in Datenflüssen und Workflows verwenden.

So erstellen Sie eine Variable:

  1. Klicken Sie auf der Homepage auf den gewünschten Projekttitel. Sie werden zur Seite Projektdetails geführt.
  2. Klicken Sie im linken Fensterbereich auf Variablen. Die Seite "Variable erstellen" wird angezeigt.
  3. Geben Sie einen Namen für die Variable ein.
  4. Wählen Sie in der Registerkarte Datentyp eine der folgenden Optionen aus:
    • Kurzer Text: Der Wert kann alphanumerisch sein, Sonderzeichen enthalten und darf nicht länger als 255 Zeichen sein.
    • Langer Text: Der Wert kann alphanumerisch sein, Sonderzeichen enthalten und darf nicht länger als 64000 Zeichen sein.
    • Numerisch: Der Wert kann ein numerischer Wert sein und mit einem Minuszeichen (-) vorangestellt werden. Der Wert darf maximal 10 Ziffern überschreiten. Mögliche Wertebereiche sind -999999999 bis 99999999999.
    • Datum: Der Wert ist ein Datumsformat.
  5. Geben Sie im Feld Standardwert den Wert ein, den Sie der Variable zuweisen möchten. Der zulässige Wert hängt vom ausgewählten Datentyp ab.
  6. Bei Variablen, die Sie ändern, können Sie auf das Menü "Aktionen" neben der Variablen klicken, um die Seite "Variable aktualisieren" zu öffnen und den Wert zu aktualisieren. Wählen Sie in der Dropdown-Liste Historie beibehalten aus, wie der Variablenwert auf der Seite "Variable aktualisieren" angezeigt werden soll:
    • Alle Werte: Die Historie aller Werte dieser Variablen wird angezeigt.
    • Letzter Wert: Sie können nur den letzten für die Variable angegebenen Wert anzeigen.
    • Keine Historie: Datentransformationen behalten nicht die Historie der Werte bei, die von dieser Variable gehalten werden.
    • Sicherer Wert: Dies ist nützlich, wenn die Variable ein Kennwort oder andere sensible Daten enthält. Der Wert wird nicht auf der Seite "Variable aktualisieren" angezeigt.
  7. Geben Sie eine Beschreibung für die Variable ein.
  8. Wenn der Variablenwert durch eine Abfrage festgelegt werden soll, klicken Sie auf die Registerkarte Aktualisieren. Wählen Sie den Verbindungstyp und das Schema, in dem Sie den Befehl ausführen möchten. Geben Sie die Abfrage ein, und klicken Sie auf Validieren, um die Syntax des Ausdrucks zu prüfen.
  9. Klicken Sie auf Speichern.

    Die neu erstellte Variable wird auf der Seite "Variablen" sowie im Knoten "Variablen" im linken Bereich der Seite "Workflowdetails" aufgeführt.

Übergeordnetes Thema: Variablen erstellen und verwenden

Variablen in einem Datenfluss verwenden

Sie können Variablen in einem Datenfluss verwenden, indem Sie sie als Filterdefinition verwenden. Sie können Variablen in einem Datenfluss im Format #<variable_name> referenzieren. Während der Ausführung wird die Variable durch den Wert ersetzt.

Wenn Sie den Datenfluss ausführen, wird die Seite Variablenwerte angezeigt, auf der die Liste der Variablen angezeigt wird, die Sie dem Datenfluss hinzugefügt haben. Sie können den aktuellen Wert, den Standardwert oder einen benutzerdefinierten Wert für jede Variable verwenden. Beachten Sie, dass der benutzerdefinierte Wert nur auf die aktuelle Ausführung des Datenflusses angewendet wird. Der benutzerdefinierte Wert wird für nachfolgende Sessions nicht beibehalten.

Im Folgenden finden Sie ein Beispiel für die Verwendung einer Variablen in einem Datenfluss:


Beschreibung von variables_in_data_flows.png folgt
Beschreibung der Abbildung variables_in_data_flows.png

In diesem Beispiel verwendet der Datenfluss die Variable DEVICE_TYPE als Schritt, wobei die Filterbedingung wie folgt festgelegt ist:

MOVIESALES_CA.DEVICE = '#DEVICE_TYPE'

Die Variable wird in Anführungszeichen gesetzt, weil der ersetzte Wert angegeben werden muss. Da der Variablenwert während der Ausführung ersetzt wird, können Sie ihn für viele Anwendungsfälle verwenden, z.B. im Transformationsausdruck im Mapping.

Übergeordnetes Thema: Variablen erstellen und verwenden

Variablen in einem Workflow verwenden

Im linken Bereich der Seite "Workflowdetails" werden die Variablen aufgeführt, die Sie als Schritte in einem Workflow verwenden können.

Sie können die Variablen, die Sie im Workflow verwenden möchten, per Drag-and-Drop auf der Designleinwand verschieben. Im Bereich "Eigenschaften" auf der rechten Seite der Designleinwand werden verschiedene Details zum Schritt angezeigt, z.B. die folgenden.
  • Name, Typ und die Schritt-Sequenznummer. Dies sind nicht bearbeitbare Werte.
  • Klicken Sie auf den Link unter Verknüpftes Objekt, um die Details zur Variablen anzuzeigen und zu aktualisieren.
  • Vorgang: Wählen Sie eine der folgenden Optionen aus:
    • Variable festlegen: Für diesen Schritt gibt es zwei Funktionen:

      Aktualisieren legt den aktuellen Wert einer Variable fest.

      Inkrement erhöht bzw. senkt einen numerischen Wert um den angegebenen Betrag.

    • Variable aktualisieren: Mit diesem Variablenschritt wird die Variable durch Ausführen der in der Variablendefinition angegebenen Abfrage aktualisiert.
    • Variable bewerten: Dieser variable Schritttyp vergleicht den Wert der Variablen mit einem bestimmten Wert entsprechend einem Operator. Wird die Bedingung erfüllt, ist der Auswertungsschritt "true", andernfalls ist er "false".
  • Anzahl der Versuche bei Fehler
  • Zeit zwischen Versuchen in Sekunden
  • Schritte im Journal anmelden: Sie können zwischen "Immer", "Nie" oder "Fehler" wählen.

Wenn Sie den Workflow ausführen, wird die Seite Variablenwerte angezeigt, auf der die Liste der Variablen angezeigt wird, die Sie dem Workflow hinzugefügt haben. Sie können den aktuellen Wert, den Standardwert oder einen benutzerdefinierten Wert für jede Variable verwenden. Beachten Sie, dass der benutzerdefinierte Wert nur auf die aktuelle Ausführung des Workflows angewendet wird. Der benutzerdefinierte Wert wird für nachfolgende Sessions nicht beibehalten.

Beispiel für die Verwendung einer Variablen in einem Workflow:


Beschreibung von variables_in_workflows.png folgt
Beschreibung der Abbildung variables_in_workflows.png

In diesem Beispiel wird eine Variable namens DEVICE _TYPE mit dem Wert "iphone" als Schritt im Workflow verwendet. Der Workflow führt folgende Aktionen aus:

  1. Führen Sie den Datenfluss "REFRESH_DEVICE" aus.
  2. Wenn die Ausführung des Datenflusses "REFRESH_DEVICE" erfolgreich war, führen Sie den Datenfluss "Load_movies_for_device" aus.
  3. Wenn die Ausführung des Datenflusses "Load_movies_for_device" erfolgreich war, führen Sie den Auswerteschritt der Variablen "IF_IPHONE" aus.
  4. Wenn der Variablenwert "iphone" entspricht, führen Sie den Pfad für "true" aus.
  5. Wenn der Variablenwert nicht "iphone" entspricht, führen Sie den Pfad für "false" aus.

Übergeordnetes Thema: Variablen erstellen und verwenden