Command Reference > pmrep-Befehlsreferenz > MassUpdate
  

MassUpdate

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.
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:
Option
Argument
Beschreibung
-t
session_property_type
Erforderlich. Zu aktualisierender Sitzungseigenschaftstyp. Es gibt folgende Typen von Sitzungseigenschaften:
  • - session_property
  • - session_config_property
  • - transformation_instance_attribute
  • - session_instance_runtime_option
-n
session_property_name
Erforderlich. Name des zu aktualisierenden Attributs oder der zu aktualisierenden Eigenschaft.
-v
session_property_value
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;"
HINWEIS: Setzen Sie den Sitzungseigenschaftswert in doppelte Anführungszeichen.
-w
transformation_type
Erforderlich, wenn Sie ein Umwandlungsinstanzattribut aktualisieren. Zu aktualisierender Umwandlungstyp. Sie können die folgenden Umwandlungstypen aktualisieren: Aggregat, Joiner, Lookup, Rang, Sortierer, Quelldefinition und Zieldefinition.
-i
persistent_input_file
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.
-f
folder_name
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.
-o
condition_operator
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.
-l
condition_value
Erforderlich, wenn Sie einen Bedingungsoperator verwenden. Teil der Bedingung. Die Bedingung wird wie folgt angezeigt:
<session_property_value> <condition operator> <condition_value>
-g
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.
-m
test_mode
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:
  • - Sitzungsname
  • - 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.
-u
output_log_file_name
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:

Sitzungseigenschafts-Typen

Wenn Sie MassUpdate ausführen, geben Sie den Sitzungseigenschafts-Typ und den Namen an. Sie legen folgende Sitzungseigenschafts-Typen fest:
In der folgenden Tabelle werden die aktualisierbaren Sitzungseigenschaften und die Sitzungseigenschafts-Typen aufgelistet:
Sitzungseigenschaft
Sitzungseigenschafts-Typ
$Quellenverbindungswert
session_property
$Target-Verbindungswert
session_property
Zusätzliche gleichzeitige Pipelines für die Erstellung des Lookup-Cache
session_config_property
Größe des Aggregator-Datencaches
transformation_instance_attribute
Das Argument transformation_type muss Aggregator sein.
Aggregator-Index - Cache-Größe
transformation_instance_attribute
Das Argument transformation_type muss Aggregator sein.
Temporäre Sequenz für Pushdown zulassen
session_property
Temporäre Ansicht für Pushdown zulassen
session_property
Cache-Verzeichnis
transformation_instance_attribute
Das Argument transformation_type muss Aggregator, Joiner oder Rang sein.
Cache-LOOKUP()-Funktion
session_config_property
Leistungsdaten erfassen
session_property
Commit-Intervall
session_property
Commit-Typ
session_property
Constraintbasierte Lastreihenfolge
session_config_property
Benutzerdefinierte Eigenschaften
session_config_property
DateTime-Format-String
session_config_property
Standard-Pufferblockgröße
session_config_property
Diese Aufgabe deaktivieren
session_instance_runtime_option
DTM-Puffergröße
session_property
Hohe Präzision aktivieren
session_property
Prüflast aktivieren
session_property
Übergeordnetes Objekt schlägt fehl, wenn diese Aufgabe nicht ausgeführt wird
session_instance_runtime_option
Übergeordnetes Objekt schlägt fehl, wenn diese Aufgabe fehlschlägt
session_instance_runtime_option
Inkrementelle Aggregation
session_property
Ist aktiviert
session_config_property
Java Klassenpfad
session_property
Joiner-Daten-Cachegröße
transformation_instance_attribute
Das Argument transformation_type muss Joiner sein.
Joiner-Index-Cachegröße
transformation_instance_attribute
Das Argument transformation_type muss Joiner sein.
Zeilensequenzielle Pufferlänge
session_config_property
Lookup-Cache-Verzeichnisname
transformation_instance_attribute
Das Argument transformation_type muss Lookup-Prozedur sein.
Lookup-Daten-Cachegröße
transformation_instance_attribute
Das Argument transformation_type muss Lookup-Prozedur sein.
Lookup-Index-Cachegröße
transformation_instance_attribute
Das Argument transformation_type muss Lookup-Prozedur sein.
Maximal zulässige Speicherkapazität für automatische Speicherattribute
session_config_property
Maximaler Prozentsatz der zulässigen Gesamtspeicherkapazität für automatische Speicherattribute
session_config_property
Bei Fehler vor oder nach SQL
session_config_property
Bei Befehlsaufgabenfehler vor Sitzung
session_config_property
Bei Fehler in gespeicherter Prozedur
session_config_property
Ausgabedateiverzeichnis
transformation_instance_attribute
Das Argument transformation_type muss Target-Definition sein.
Tracing überschreiben
session_config_property
Name der Parameterdatei
session_property
Zeitstempel für Kompatibilität vor 85
session_config_property
Zuvor erstellter Lookup-Cache
session_config_property
Pushdown-Optimierung
session_property
Rang-Daten-Cachegröße
transformation_instance_attribute
Das Argument transformation_type muss Rang sein.
Rang-Index-Cachegröße
transformation_instance_attribute
Das Argument transformation_type muss Rang sein.
Wiederherstellungsstrategie
session_property
Ablehnungsdateiverzeichnis
transformation_instance_attribute
Das Argument transformation_type muss Target-Definition sein.
Transaktionen bei Fehlern rückgängig machen
session_property
Sitzungsprotokoll speichern nach
session_config_property
Sitzungsprotokolldatei-Verzeichnis
session_property
Erneuter Sitzungsversuch bei Deadlock
session_property
Sitzungs-Sortier-Reihenfolge
session_property
Wenn der Integration Service im Unicode-Modus ausgeführt wird, können Sie die Sortierreihenfolge für das Sortieren von Zeichendaten in der Sitzung auswählen. Sie können die folgenden Werte für die Sortierreihenfolge konfigurieren:
  • - 0. BINARY
  • - 2. SPANISH
  • - 3. TRADITIONAL_SPANISH
  • - 4. DANISH
  • - 5. SWEDISH
  • - 6. FINNISH
Sortierer-Cachegröße
transformation_instance_attribute
Das Argument transformation_type muss Sortierer sein.
Quelldateiverzeichnis
transformation_instance_attribute
Das Argument transformation_type muss Quelldefinition sein.
Stoppen bei Fehlern
session_config_property
Quellzeilen behandeln als
session_property
Eingabe-Link behandeln als AND
session_instance_runtime_option
Rückwärtskompatible Sitzungsprotokolldatei schreiben
session_property

Regeln und Richtlinien für MassUpdate

Verwenden Sie die folgenden Regeln und Richtlinien, wenn Sie MassUpdate ausführen:

Beispiel-Protokolldatei

Der folgende Text zeigt ein Beispiel einer Protokolldatei, die vonpmrep MassUpdate generiert wurde:
cases_auto,s_test_ff,reusable,0
s_test_ff was successfully checked out.

------------------------------------------------------------------------------
11/10/2008 11:12:55 ** Saving... Repository test_ver_MU, Folder cases_auto
------------------------------------------------------------------------------
Session s_test_ff updated.
Checking-in saved objects...done
------------------------------------------------------------------------------

cases_auto,wf_non_reusable_test_ff.s_test_ff_non_reusable,non-reusable,0
wf_non_reusable_test_ff was successfully checked out.

------------------------------------------------------------------------------
11/10/2008 11:12:57 ** Saving... Repository test_ver_MU, Folder cases_auto
------------------------------------------------------------------------------
Validating the flow semantics of Workflow wf_non_reusable_test_ff...
...flow semantics validation completed with no errors.

Validating tasks of Workflow wf_non_reusable_test_ff...
...Workflow wf_non_reusable_test_ff tasks validation completed with no errors.

Workflow wf_non_reusable_test_ff updated.
Checking-in saved objects...done
------------------------------------------------------------------------------

Massupdate Summary:
Number of reusable sessions that are successfully updated: 1.
Number of non-reusable sessions that are successfully updated: 1.
Number of session instances that are successfully updated: 0.
Number of reusable sessions that fail to be updated: 0.
Number of non-reusable sessions that fail to be updated: 0.
Number of session instances that fail to be updated: 0.
------------------------------------------------------------------------------