UltraLite-Synchronisationsdienstprogramm (ulsync)

ulsync -c [ options ]  [synchronization parameters]

Option

Beschreibung

@data

Liest Optionen aus der angegebenen Umgebungsvariablen oder Konfigurationsdatei ein. Wenn beide mit demselben Namen vorhanden sind, wird die Umgebungsvariable verwendet. Siehe Konfigurationsdateien.

-c "connection-string"

ODER

--connect="connection-string"

Erforderlich. Stellt eine Verbindung mit der Datenbank her, wie im Parameter DBF oder file_name der connection-string angegeben. Wenn Sie keine Benutzer-ID und kein Kennwort angeben, werden die Standardbenutzer-ID DBA und das Standardkennwort sql verwendet.

-p profile-name

ODER

--profile=profile

Führt eine Synchronisation unter Verwendung des angegebenen Synchronisationsprofils durch. Ist äquivalent mit:

SYNCHRONIZE profileName MERGE syncOptions

Hier werden die Synchronisationsoptionen von den nachgestellten ulsync-Optionen übernommen. Beispiel:

ulsync -p profileName "MobiLinkUid=ml;ScriptVersion=Version001...syncOptions"

Siehe Synchronisationsprofiloptionen.

-q

ODER

--quiet

Führt das Dienstprogramm im stillen Modus aus. Informative Banner, Versionsnummern und Statusmeldungen werden unterdrückt. Fehlermeldungen werden jedoch weiter angezeigt.

-r

ODER

--result

Zeigt die letzten Synchronisationsergebnisse an und beendet die Anwendung.

-v

ODER

--verbose

Zeigt Meldungen über den Synchronisationsfortschritt an. Dies legt auch fest, ob der Verarbeitungsfortschritt bei einer Synchronisation angezeigt wird, unabhängig davon, ob die C++ API oder die SQL-Anweisung für die Profilsynchronisierung verwendet wird. Siehe CREATE SYNCHRONIZATION PROFILE-Anweisung [UltraLite].

--log filename

Protokolliert Vorgänge in der festgelegten Datei.

-?

ODER

--help

Zeigt Informationen über die Verwendung des Dienstprogramms an und beendet das Programm.

Wenn eine Zertifikatdatei mit der Option trusted_certificate oder e2ee_public_key definiert ist, sucht die UltraLite-Laufzeitbibliothek nach diesen Dateien nur in dem Haupt-Ressourcen-Bundle, das Bestandteil jedes Anwendungs-Deployment-Packages für iPhone ist. Sie fügen diesem Bundle Elemente hinzu, indem Sie sie im /Resources-Ordner Ihres Xcode-Projekts speichern. Dies ist nicht anwendbar auf Zertifikate, die in der UltraLite-Datenbank gespeichert werden, und hat keinen Einfluss auf Mac OS-Clients (nur iPhone). Siehe trusted_certificates.

Die folgenden Optionen, die für die Versionen 10 und früher gültig waren, werden nicht mehr unterstützt: -a authenticate-parameters, -e sync-parms, -k stream-type, -n (keine Synchronisation) und -x protocol-options. -e <keyword=value ist nun Teil der Synchronisationsparameter-Zeichenfolge, -k und -x sind nun Teil der Synchronisationsparameter-Zeichenfolge Stream= stream{stream parms}.

ulsync kann als gleichwertig mit einer der folgenden SQL-Anweisungen angesehen werden, abhängig vom Verwendungszweck:

ulsync -p profile "parms"

Diese Anweisung ist gleichwertig mit folgender Anweisung:

 SYNCHRONIZE PROFILE profile MERGE
parms

und

ulsync "parms"

Diese Anweisung ist gleichwertig mit folgender Anweisung:

 SYNCHRONIZE USING <parms>

Bei einer sicheren Synchronisation muss die UltraLite-Anwendung Zugriff auf das öffentliche Zertifikat haben. Sie können ein Zertifikat folgendermaßen referenzieren:

Durch Aufnahme der Zertifikatsdaten in die UltraLite-Datenbank zum Erstellungszeitpunkt mit der Option -t file und ulinit oder ulload.
Durch Referenzierung einer externen Zertifikatdatei während der Synchronisation mit der Datenstromoption trusted_certificate=file.

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

Der folgende Befehl synchronisiert eine Datenbankdatei namens myuldb.udb für den MobiLink-Benutzer namens remoteA.

ulsync -c DBF=myuldb.udb "MobiLinkUid=remoteA;Stream=http;ScriptVersion=2"

Der folgende Befehl synchronisiert eine Datenbankdatei namens myuldb.udb über HTTPS unter Verwendung des Zertifikats C:\Users\Public\Documents\SQL Anywhere 16\Samples\Certificates\rsaroot.crt. Die Option trusted_certificate=file muss verwendet werden, weil die Datei mit dem vertrauenswürdigen Zertifikat nicht der Datenbank hinzugefügt wurde, als die Datenbank erstellt wurde. Der MobiLink-Benutzername lautet remoteB.

ulsync -c DBF=myuldb.udb "Stream=https{trusted_certificate=C:\Users\Public\Documents\SQL Anywhere 16\Samples\Certificates\rsaroot.crt};
MobiLinkUid=remoteB;ScriptVersion=2;UploadOnly=ON"

Der folgende Befehl zeigt die letzten Synchronisationsergebnisse für die Datenbankdatei synced.udb an.

ulsync -r -c dbf=synced.udb

Die vorherigen Synchronisationsergebnisse werden wie folgt aufgelistet:

SQL Anywhere UltraLite-Dienstprogramm zur Datenbanksynchronisation Version XX.X
    Ergebnisse der letzten Synchronisation:
    Erfolgreich
        Download-Zeitstempel: 2006-07-25 16:39:36.708000
         Upload OK 
         Keine ignorierten Zeilen 
         Teil-Download beibehalten 
         Authentifizierungswert: 1000 (0x3e8)

Das folgende Beispiel zeigt die Verwendung der Befehlszeile, um die CustDB-Datenbank mit dem Benutzernamen 50 über TCP/IP auf dem Port 2439 zu synchronisieren. Es werden ausführliche Meldungen zum Verarbeitungsfortschritt verwendet.

ulsync -c "dbf=C:\Users\Public\Documents\SQL Anywhere 16\Samples\UltraLite\custdb.udb" 
"MobiLinkUid=50;ScriptVersion=custdb 12.0;Stream=tcpip{port=2439}"

Der folgende Befehl veranschaulicht die Verwendung von TLS-Verschlüsselung mit E2EE:

ulsync -c "uid=dba;pwd=sql;dbf=myudb.db" "MobiLinkUid=rem1;MobiLinkPwd=password;ScriptVersion=v1;Stream=tls{host=myServer;port=2439;trusted_certificate=c:\clientcert.pem;e2ee_public_key=c:\e2eepublic.pem}"

UltraLite-Synchronisationsdienstprogramm (ulsync)

Syntax

Bemerkungen

Siehe auch

Beispiele