Verwenden Sie diese Anweisung, um ein UltraLite- oder UltraLiteJ-Synchronisationsprofil zu erstellen oder zu ersetzen. Synchronisationsprofile legen fest, wie eine UltraLite-Datenbank mit dem MobiLink-Server synchronisiert wird.
SyntaxCREATE [OR REPLACE] SYNCHRONIZATION PROFILESynchronisationsprofilname Synchronisationsoption [;... ]
Synchronisationsoption :
Synchronisationsoptionsname = SynchronisationsoptionswertSynchronisationsoptionsname : Zeichenfolge
Synchronisationsoptionswert : Zeichenfolge
ParameterOR REPLACE-Klausel Wenn ein benanntes Synchronisationsprofil bereits vorhanden ist, wird es ersetzt. Wenn das Profil nicht existiert, wird es erstellt.
Synchronisationsprofilname Der Name des Synchronisationsprofils.
Synchronisationsoption
Eine Zeichenfolge mit mindestens einem Paar "Option=Wert", getrennt durch Semikola. Zum Beispiel, 'option1=value1;option2=value2'.
Synchronisationsoptionsname Der Name der Synchronisationsprofiloption
Synchronisationsoptionswert Der Wert der Synchronisationsprofiloption.
BemerkungenEs gibt zwei Möglichkeiten, um Änderungen an einem bestehenden Synchronisationsprofil durchzuführen. Die erste besteht darin, die REPLACE-Klausel zu verwenden. Dies ersetzt den Inhalt des Synchronisationsprofils mit dem, was in der neuen Synchronisationsoptions-Zeichenfolge enthalten ist. Dies entspricht einem Löschen des Synchronisationsprofils, um danach eines mit demselben Namen, aber unter Verwendung der neuen Zeichenfolge zu erstellen. Beachten Sie, dass ein Synchronisationsprofil nicht eine vollständige Synchronisationsdefinition enthalten muss, weil Parameter während der Synchronisation zusammengeführt (oder überschrieben) werden können.
Die zweite Möglichkeit, ein Synchronisationsprofil zu ändern, ist die Verwendung der MERGE-Klausel. Wenn diese Klausel verwendet
wird, werden nur die Synchronisationsoptionen geändert, die in der MERGE-Klausel angegeben sind. Um eine Synchronisationsoption
aus einem Synchronisationsprofil zu entfernen, sollte die Synchronisationsoptions-Zeichenfolge aussehen wie 'option1=;' (um die Option auf einen leeren Wert zu setzen).
Die Synchronisationsprofiloption STREAM unterscheidet sich von den anderen Optionen, weil ihr Wert eine Unterliste enthält.
Zum Beispiel: 'STREAM=TCPIP{host=192.168.1.1;port=1234}'. In diesem Fall ist 'host=192.168.1.1;port=1234' die Unterliste. Um einen Unterlistenwert hinzuzufügen oder zu entfernen, verwenden Sie einen Punkt zwischen dem STREAM-Synchronisationsoptionsnamen
und dem Unterlisten-Optionsnamen. Beispiel: MERGE 'stream.port=5678;stream.host=;compression=zlib' ergibt das Synchronisationsprofil stream=TCPIP{port=5678;compression=zlib}. Der Versuch, den Datenstrom auf einen neuen Wert zu setzen, ersetzt den gesamten Datenstromwert. Beispiel: MERGE 'stream=HTTPS' ergibt folgendes Synchronisationsprofil: stream=HTTPS{}.
Die nachstehende Tabelle enthält die Synchronisationsprofiloptionen, die von UltraLite und UltraLiteJ unterstützt werden.
| Synchronisationsprofiloption | Gültige Werte | Beschreibung |
|---|---|---|
| AllowDownloadDupRows (nur UltraLite) | Boolescher Wert | Diese Option verhindert die Meldung von Fehlern, wenn mehrere Zeilen heruntergeladen werden, die denselben Primärschlüssel haben. Damit kann zugelassen werden, dass inkonsistente Daten synchronisiert werden, ohne ein Fehlschlagen der Synchronisation zu bewirken. Der Standardwert ist "no". Siehe Synchronisationsparameter Additional Parameters. |
| AuthParms (UltraLite und UltraLiteJ) | Zeichenfolge (durch Kommas getrennt) | Gibt die Liste der Authentifizierungsparameter an, die an den MobiLink-Server gesendet werden. Sie können Authentifizierungsparameter verwenden, um angepasste Authentifizierungen in MobiLink-Skripten durchzuführen. Siehe Synchronisationsparameter Authentication Parameters. |
| CheckpointStore (nur UltraLite) | Boolescher Wert | Fügt während der Synchronisation in die Datenbank zusätzliche Checkpoints ein, um das Anwachsen der Datenbank während des Synchronisationsprozesses zu verhindern. Siehe Synchronisationsparameter Additional Parameters. |
| ContinueDownload (nur UltraLite) | Boolescher Wert | Startet einen fehlgeschlagenen Download erneut. Wenn ein Download fortgesetzt wird, werden nur die Änderungen empfangen, die für den Download mit der fehlgeschlagenen Synchronisation ausgewählt waren. Standardmäßig setzt UltraLite Downloads nicht fort. Siehe Fehlgeschlagene Downloads wieder aufnehmen. |
| DisableConcurrency (nur UltraLite) | Boolescher Wert | Unterbindet während der Synchronisation den Datenbankzugriff von anderen Threads. Siehe Synchronisationsparameter Additional Parameters. |
| DownloadOnly (UltraLite und UltraLiteJ) | Boolescher Wert | Führt eine reine Download-Synchronisation durch. Siehe Synchronisationsparameter Download Only. |
| KeepPartialDownload (nur UltraLite) | Boolescher Wert | Steuert, ob UltraLite einen teilweisen Download bewahrt, wenn ein Verbindungsfehler auftritt. Standardmäßig setzt UltraLite teilweise heruntergeladene Änderungen nicht zurück. Siehe Synchronisationsparameter Keep Partial Download. |
| MobiLinkPwd (UltraLite und UltraLiteJ) | Zeichenfolge | Gibt das bestehende MobiLink-Kennwort an, das dem Benutzernamen zugeordnet ist. Siehe Erweiterte Option MobiLinkPwd (mp). |
| MobiLinkUid (UltraLite und UltraLiteJ) | Zeichenfolge | Gibt den MobiLink-Benutzernamen an. Siehe dbmlsync-Option -u (nicht mehr empfohlen). Siehe dbmlsync-Option -mn. |
| NewMobiLinkPwd (UltraLite und UltraLiteJ) | Zeichenfolge | Übergibt ein neues Kennwort für den MobiLink-Benutzer. Benutzen Sie diese Option, wenn Sie ein bestehendes Kennwort ändern wollen. Siehe dbmlsync-Option -mn. |
| Ping (UltraLite und UltraLiteJ) | Boolescher Wert | Bestätigt nur die Kommunikation mit dem Server. Es findet keine Synchronisation statt. Siehe Synchronisationsparameter Ping. |
| Publikationen (UltraLite und UltraLiteJ) | Zeichenfolge (durch Kommas getrennt) | Gibt die zu synchronisierenden Publikationen an. Die Publikationen legen die Tabellen in der entfernten Datenbank fest, die an der Synchronisation teilnehmen. Wenn dieser Parameter leer ist (Standardwert), werden alle Tabellen synchronisiert. Wenn der Parameter ein Sternchen (*) ist, werden alle Publikationen synchronisiert. Siehe Publikationen in UltraLite. |
| ScriptVersion (UltraLite und UltraLiteJ) | Zeichenfolge | Gibt die MobiLink-Skriptversion an. Die Skriptversion legt fest, welche Skripten von MobiLink in der konsolidierten Datenbank während der Synchronisation ausgeführt werden. Wenn Sie keine Skriptversion angeben, wird 'default' verwendet. Siehe Erweiterte Option ScriptVersion (sv). |
| SendColumnNames (UltraLite und UltraLiteJ) | Zeichenfolge | Gibt an, dass Spaltennamen während der Synchronisation an den MobiLink-Server als Teil der Upload-Datei gesendet werden sollen. Standardmäßig werden Spaltennamen nicht gesendet. Siehe Synchronisationsparameter Send Column Names. |
| SendDownloadACK (UltraLite und UltraLiteJ) | Boolescher Wert | Legt fest, dass eine Downloadbestätigung vom Client an den Server gesendet werden soll. Standardmäßig sieht der MobiLink-Server keine Downloadbestätigung vor. Siehe Synchronisationsparameter Send Download Acknowledgement. |
| Stream (UltraLite und UltraLiteJ) | Zeichenfolge (mit Unterliste) | Gibt das MobiLink-Netzwerk-Synchronisationsprotokoll an. Siehe Synchronisationsparameter Stream Type. |
| TableOrder (UltraLite und UltraLiteJ) | Zeichenfolge (durch Kommas getrennt) | Legt die Reihenfolge der Tabellen im Upload fest. Standardmäßig wählen UltraLite und UltraLiteJ eine auf Fremdschlüsselbeziehungen basierende Reihenfolge aus. Siehe Synchronisationsparameter Additional Parameters. |
| UploadOnly (UltraLite und UltraLiteJ) | Zeichenfolge | Legt fest, dass die Synchronisation nur einen Upload umfasst und dass kein Download erfolgen wird. Siehe Synchronisationsparameter Upload Only. |
Die Booleschen Werte können als Yes/No, 1/0, True/False, On/Off angegeben werden. In allen Booleschen Fällen ist der Standardwert "No". Bei allen anderen Werten ist der Standardwert einfach 'unspecified'.
NebenwirkungenKeine.
Siehe auch BeispielDas folgende Beispiel erstellt ein Synchronisationsprofil namens Test1.
CREATE SYNCHRONIZATION PROFILE Test1 'MobiLinkUid=mary;Stream=TCPIP{host=192.168.1.1;port=1234}' |
Das folgende Beispiel zeigt die Änderungen, die auftreten, nachdem eine Sequenz von ALTER SYNCHRONIZATION PROFILE-Befehlen mit verschiedenen Optionen ausgeführt wurde.
Es gilt folgende Annahme: myProfile1='MobiLinkUID=mary;ScriptVersion=default'.
Nach der Ausführung von ALTER SYNCHRONIZATION PROFILE myProfile1 REPLACE 'MobiLinkPwd=sql;ScriptVersion=1' ist myProfile 'MobiLinkPwd=sql;ScriptVersion=1'.
Nach der Ausführung von ALTER SYNCHRONIZATION PROFILE myProfile1 MERGE 'MobiLinkUID=mary;STREAM=tcpip' ist myProfile 'MobiLinkPwd=sql;ScriptVersion=1;MobiLinkUID=mary;STREAM=tcpip'.
Nach der Ausführung von ALTER SYNCHRONIZATION PROFILE myProfile1 MERGE 'MobiLinkUID=;STREAM.host=192.168.1.1;STREAM.port=1234;ScriptVersion=;' ist myProfile 'MobiLinkPwd=sql;STREAM=tcpip{192.168.1.1;port=1234}'.
Nach der Ausführung von ALTER SYNCHRONIZATION PROFILE myProfile1 MERGE 'MobiLinkPwd=;Ping=yes;STREAM =HTTP' ist myProfile 'Ping=yes;STREAM=HTTP'.
Nach der Ausführung von ALTER SYNCHRONIZATION PROFILE myProfile1 MERGE 'STREAM=HTTP{host=192.168.1.1}' ist myProfile 'Ping=yes;STREAM=HTTP{host=192.168.1.1}'.
 |
Kommentieren Sie diese Seite in DocCommentXchange.
|
Copyright © 2010, iAnywhere Solutions, Inc. - SQL Anywhere 12.0.0 |