Aktualisiert Sitzungseigenschaften für eine Reihe von Sitzungen, die angegebene Bedingungen erfüllen. Sie können alle Sitzungen in einem Ordner oder einer Liste von Sitzungen aktualisieren. Um eine Liste von Sitzungen zu aktualisieren, erstellen Sie eine persistente Eingabedatei. Die Liste kann eine bestimmte Liste von Sitzungen oder Bedingungen wie Namensmuster oder Eigenschaftswert enthalten. Verwenden Sie ExecuteQuery, um eine persistente Eingabedatei zu generieren.
Wenn Sie MassUpdate ausführen, können Sie Informationen wie den Ordnernamen, die Anzahl der Sitzungen, die erfolgreich aktualisiert wurden oder fehlgeschlagen sind, und die Namen der aktualisierten Sitzungen anzeigen. Sie können den Status der Aktualisierung im Befehlszeilenfenster oder in einer vom Befehl generierten Protokolldatei anzeigen. Geben Sie den Namen und Pfad für die Protokolldatei ein, wenn Sie den Befehl ausführen. Standardmäßig wird die Protokolldatei in dem Verzeichnis gespeichert, in dem Sie den Befehl ausführen.
Verwenden Sie MassUpdate zum Aktualisieren einer Sitzungseigenschaft über mehrere Sitzungen, wenn eine PowerCenter Version einen Standardwert ändert.
Abhängige Sitzungseigenschaften können nicht aktualisiert werden.
Bevor Sie die Sitzungen aktualisieren, können Sie MassUpdate auch in einem Testmodus ausführen, um Änderungen anzuzeigen. Ein Beispiel einer Protokolldatei finden Sie auf
Beispiel-Protokolldatei.
Der MassUpdate-Befehl verwendet die folgende Syntax:
pmrep massupdate
-t <session_property_type (session_property, session_config_property, transformation_instance_attribute, session_instance_runtime_option)>
-n <session_property_name>
-v <session_property_value>
[-w <transformation_type>]
{-i <persistent_input_file> | -f <folder_name> }
[-o <condition_operator (equal, unequal, less, greater)>]
[-l <condition_value>]
[-g <update_session_instance_flag>]
[-m <test_mode>]
[-u <output_log_file_name>]
In der folgenden Tabelle werden die
pmrep
MassUpdate-Optionen und -Argumente beschrieben:
| |
Erforderlich. Zu aktualisierender Sitzungseigenschaftstyp. Es gibt folgende Typen von Sitzungseigenschaften:
transformation_instance_attribute
session_instance_runtime_option
|
| |
Erforderlich. Name des zu aktualisierenden Attributs oder der zu aktualisierenden Eigenschaft.
|
| |
Erforderlich. Wert (gefolgt von einem Semikolon), den Sie der Eigenschaft zuweisen möchten.
Verwenden Sie zum Zuweisen eines Werts zur Eigenschaft beispielsweise folgende Syntax: -v "IgnoreNULLInExpressionComparison=Yes;"
Setzen Sie den Sitzungseigenschaftswert in doppelte Anführungszeichen.
|
| |
Erforderlich, wenn Sie ein Umwandlungsinstanzattribut aktualisieren. Zu aktualisierender Umwandlungstyp. Sie können die folgenden Umwandlungstypen aktualisieren: Aggregat, Joiner, Lookup, Rang, Sortierer, Quelldefinition und Zieldefinition.
|
| |
Erforderlich, wenn Sie die Option -f nicht verwenden. Name der Datei, die die ausgewählte Liste der zu aktualisierenden Sitzungen enthält. Sie können mit dem pmrep ExecuteQuery-Befehl eine Abfrage ausführen und diese Datei generieren. MassUpdate gibt einen Fehler zurück, wenn Sie ein Objekt angeben, das keine Sitzung ist. Sie müssen die Option -i oder die Option -f verwenden, aber nicht beide.
|
| |
Erforderlich, wenn Sie nicht die Option -i verwenden. Name des Ordners. Verwenden Sie diesen, um alle Sitzungen in einem Ordner zu aktualisieren. Sie müssen die Option -i oder die Option -f verwenden, aber nicht beide.
|
| |
Erforderlich, wenn Sie condition_value verwenden. Teil der Bedingung, die den Sitzungssatz definiert.
Das Attribut einer Sitzung oder Sitzungsinstanz wird aktualisiert, wenn die Bedingung erfüllt ist.
Sie können die folgenden Bedingungsoperatoren verwenden, um eine Zeichenfolge zu aktualisieren: gleich oder ungleich.
Sie können die folgenden Bedingungsoperatoren verwenden, um eine Ganzzahl zu aktualisieren: gleich, ungleich, kleiner oder größer.
|
| |
Erforderlich, wenn Sie einen Bedingungsoperator verwenden. Teil der Bedingung. Die Bedingung wird wie folgt angezeigt:
<session_property_value> <condition operator> <condition_value>
|
|
update_session_instance_flag
|
Erforderlich, wenn Sie die Laufzeitoption einer Sitzungsinstanz aktualisieren.
Optional bei folgenden Sitzungseigenschaftstypen: Sitzungseigenschaft, Sitzungskonfigurationsattribut und Umwandlungsinstanzattribut.
Aktualisiert Sitzungsinstanzen.
Sie können ein Attribut in einer Sitzungsinstanz aktualisieren, wenn die Sitzungsinstanz das Attribut überschreibt.
|
| |
Optional. Führt MassUpdate im Testmodus aus. Zeigen Sie Sitzungen an, auf die sich der Befehl auswirkt, bevor Sie Änderungen vornehmen. Sie können die folgenden Details im Befehlszeilenfenster anzeigen:
Sitzungstyp: wiederverwendbar oder nicht wiederverwendbar
Aktueller Wert der Sitzungseigenschaft
Sitzungen, bei denen das Attribut den gleichen Wert hat und auf die der Befehl keine Auswirkung hat.
|
| |
Optional. Name der Protokolldatei, die den Status der Aktualisierung und Basisinformationen zu Sitzungen und Sitzungsinstanzen speichert. Vorherige Attributwerte werden ebenfalls in diese Datei geschrieben. Wenn Sie diese Option nicht verwenden, werden die Details im Befehlszeilenfenster angezeigt.
|
Der MassUpdate-Befehl gibt die Meldung "massupdate erfolgreich abgeschlossen" oder "Ausführen von massupdate fehlgeschlagen" zurück. Die Aktualisierung kann aus folgenden Gründen fehlschlagen:
Sie haben keinen für den Attributnamen gültigen Attributwert angegeben.
Sie haben den korrekten Namen der Sitzungseigenschaft zusammen mit dem falschen Sitzungseigenschafts-Typ angegeben.
Sie haben die Option -v, die mit einem Semikolon endet, beim Aktualisieren eines Sitzungseigenschaftswert nicht angegeben.
Sie haben während der Aktualisierung eines Transformationsinstanz-Attributs die Option -w nicht angegeben.
Sie haben während der Aktualisierung einer Sitzungsinstanz-Laufzeitoption die Option -g nicht angegeben.
Sie verfügen nicht über die Repository Services-Administratorrolle.
