UltraLite-Dienstprogramm zum Laden von Daten aus XML-Dateien (ulload)

ulload  -c "Verbindungszeichenfolge" [ Optionen ] XML-Datei

Option	Beschreibung
-a ODER --append	Fügt Daten und Schemadefinitionen in eine vorhandene Datenbank ein.
-c "Schlüsselwort=Wert;..." ODER --connect "Schlüsselwort=Wert;..."	Gibt die Parameter für die Datenbankverbindung an.
-d ODER --dataonly	Lädt nur Daten. Alle Schema-Metadaten in der XML-Dateieingabe werden ignoriert. Die Parameter -d oder --dataonly können nur verwendet werden, wenn -a angegeben ist (weil nur Daten geladen werden, muss die UDB zum Laden der Daten vorhanden sein und ein Schema aufweisen, das die zu ladenden Daten unterstützt).
-e Wert ODER --fips= Wert	On oder Off, 1 oder 0 usw. Steuert die AES FIPS-kompatible Datenverschlüsselung mithilfe eines Certicom-zertifizierten Verschlüsselungsalgorithmus. Die FIPS-Kodierung ist eine Form der starken Verschlüsselung. Siehe UltraLite-Datenbanken sichern und UltraLite-Erstellungsparameter fips.
-E Verhalten ODER --onerror=Verhalten	Steuert, was passiert, wenn ein Fehler während des Lesens von Daten aus der XML-Datei auftritt. Geben Sie einen der folgenden unterstützten Werte für das Verhalten an: continue ulload ignoriert den Fehler und fährt fort, XML zu laden. prompt ulload fordert Sie auf anzugeben, ob fortgefahren werden soll. quit ulload stoppt das Laden des XML-Codes und wird mit einem Fehler beendet. Dieses Verhalten ist das Standardverhalten, falls kein Verhalten festgelegt wird. exit ulload wird beendet.
-f Verzeichnis ODER --filedir=Verzeichnis	Legt das Verzeichnis fest, das Dateien mit zusätzlich zu ladenden Daten enthält. Siehe UltraLite-Dienstprogramm zum Entladen von Datenbanken (ulunload).
-g ID ODER --databaseid=ID	Setzt die Ausgangsdatenbank-ID auf den angegebenen INTEGER-Wert. Dieser Ausgangswert wird mit einer Partitionsgröße für neue Zeilen verwendet, die global autoincrement-Spalten enthalten. Beim Deployment einer Anwendung müssen Sie jeder Datenbank für die Synchronisation mit dem MobiLink-Server einen anderen Bereich von Identifzierungsnummern zuweisen. Siehe UltraLite global_database_id-Option.
-i ODER --insertforsync	Eingefügte Zeilen in nächste Upload-Synchronisation einbeziehen. Standardmäßig werden die von diesem Dienstprogramm eingefügten Zeilen während der Synchronisation nicht gesendet.
-l Dateiname ODER --log=Dateiname	Protokolliert Vorgänge in der festgelegten Datei.
-n ODER --schemaonly	Lädt nur Schema-Metadaten. Alle Daten in der XML-Eingabedatei werden ignoriert.
-o Wert ODER --obfuscate=Wert	On oder Off, 1 oder 0 usw. Steuert, ob Daten in der Datenbank verschleiert werden. Die Verschleierung ist eine vereinfachte Form der Verschlüsselung. Siehe UltraLite-Datenbanken sichern und UltraLite-Erstellungsparameter obfuscate.
-p Seitengröße ODER --page_size=Seitengröße	Definiert die Seitengröße in der Datenbank. Siehe UltraLite-Erstellungsparameter page_size.
-q ODER --quiet	Führt das Dienstprogramm im stillen Modus aus. Informative Banner, Versionsnummern und Statusmeldungen werden unterdrückt. Fehlermeldungen werden jedoch weiter angezeigt.
-s Datei ODER --sql=Datei	Protokolliert die SQL-Anweisungen, die verwendet werden, um die Datenbank in die angegebene Datei zu laden.
-t Datei ODER --rootcert=Datei	Gibt die Datei an, die das vertrauenswürdige Stammzertifikat enthält. Dieses Zertifikat ist für die Serverauthentifizierung erforderlich.
--utf8_encoding=Wert	On oder Off, 1 oder 0 usw. Kodiert Daten im UTF-8-Format, der 8-Bit-Mehrbyte-Kodierung für Unicode. Siehe UltraLite-Zeichensätze und UltraLite-Erstellungsparameter utf8_encoding.
-v ODER --verbose	Gibt Meldungen ausführlich aus.
-y ODER --overwrite	Überschreibt die Datenbankdatei ohne Bestätigung. Dies gilt nur, wenn Sie ulload verwenden, um eine neue Datenbank zu erstellen.
-? ODER --help	Zeigt die Verwendung des Dienstprogramms an und beendet das Programm.

Das Dienstprogramm ulload akzeptiert eine XML-Eingabedatei, die von ulunload, ulunloadold (mit SQL Anywhere 10 bereitgestellt) oder ulxml (in UltraLite Versionen 8 und 9) generiert wurde. Wenn es zusammen mit ulunload verwendet wird, ermöglicht es Ihnen dieses Dienstprogramm, eine Datenbank neu aufzusetzen. Eine alternative Methode, um eine Datenbank neu aufzusetzen, ist die Verwendung von ulunload, um SQL-Anweisungen zu generieren, und dann DBISQL zu verwenden, um sie in eine neue Datenbank zu lesen.

Die XML-Datei kann Metadaten für das Schema bzw. Metadaten für die Datenbankdaten enthalten. -d ignoriert die Schema-Metadaten und fügt nur Daten in der .udb-Datei hinzu. -n ignoriert die Daten und die Metadaten und fügt nur das Schema in der .udb-Datei hinzu.

Die Angabe einer Option oder eines Zertifikats in der Befehlszeile hat Vorrang vor allen Einstellungen in der von ulload verarbeiteten XML_Datei.

Das Dienstprogramm ulload stellt etwaige Synchronisationsprofile in der Datenbank beim Lesens der XML wieder her.

Dieses Dienstprogramm gibt Fehlercodes zurück. Jeder andere Wert als 0 weist darauf hin, dass der Vorgang fehlgeschlagen ist.

So erstellen Sie die neue UltraLite-Datenbankdatei sample.udb und laden sie mit Daten in sample.xml:

ulload -c DBF=sample.udb sample.xml

So laden Sie die Daten aus sample.xml in die vorhandene Datenbank sample.udb und fordern den Benutzer im Falle eines Fehlers zu einer Aktion auf:

ulload -d -c DBF=sample.udb --onerror=prompt sample.xml

So erstellen Sie das Schema und die Daten, die in test_data.xml in der Datenbank sample.udb gespeichert werden. Da der Parameter -a angegeben ist, muss sample.udb vorhanden sein, bevor dieser Befehl ausgeführt wird. Zudem schlägt der ULLOAD-Befehl fehl, wenn ein Schema oder Daten mit dem Inhalt von sample.udb in Konflikt steht.

ulload -c DBF=sample.udb -a test_data.xml

UltraLite-Dienstprogramm zum Laden von Daten aus XML-Dateien (ulload)

Syntax

Bemerkungen

Siehe auch

Beispiel