ALTER SYNCHRONIZATION PROFILE-Anweisung [UltraLite]

Verwenden Sie diese Anweisung, um ein UltraLite-Synchronisationsprofil zu ändern. Synchronisationsprofile legen fest, wie eine UltraLite-Datenbank mit dem MobiLink-Server synchronisiert wird.

Syntax

ALTER SYNCHRONIZATION PROFILE sync-profile-name
MERGE  sync-option [; ... ]

sync-option :
sync-option-name = sync-option-value

sync-option-name : string

sync-option-value : string

Parameter

sync-profile-name Der Name des Synchronisationsprofils.
MERGE-Klausel Verwenden Sie diese Klausel, um bestehende Optionen in einem Synchronisationsprofil zu ändern oder ihm neue hinzuzufügen.
sync-option Eine Zeichenfolge mit mindestens einem Paar "Option=Wert", getrennt durch Semikola. z. B. 'option1=value1;option2=value2'.
sync-option-name Der Name der Synchronisationsprofiloption
sync-option-value Der Wert der Synchronisationsprofiloption.

Sie können die MERGE-Klausel verwenden, um Änderungen an einem bestehenden Synchronisationsprofil durchzuführen. 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{}.

Nebenwirkungen

Siehe auch

Beispiel

Das Folgende ist ein Beispiel für die Anweisung ALTER SYNCHRONIZATION PROFILE...REPLACE:

CREATE SYNCHRONIZATION PROFILE myProfile1;
ALTER SYNCHRONIZATION PROFILE myProfile1
   REPLACE 'publications=p1;uploadonly=on';

Das Folgende ist ein Beispiel für die Anweisung ALTER SYNCHRONIZATION PROFILE...MERGE:

CREATE SYNCHRONIZATION PROFILE myProfile2 'publications=p1;
ALTER SYNCHRONIZATION PROFILE myProfile2 
   MERGE 'publications=p2;uploadonly=on';

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.