In der folgenden Tabelle stellt die Beschreibung den SQL-Datentyp bereit. Wenn Sie Ihr Skript in Java oder .NET schreiben, müssen Sie den entsprechenden Datentyp benutzen. Siehe SQL-Java-Datentypen und SQL-.NET-Datentypen.

In SQL-Skripten können Sie Ereignisparameter mit ihrem Namen oder mit einem Fragezeichen angeben. Die Verwendung von Fragezeichen ist veraltet und es wird empfohlen, benannte Parameter zu verwenden. Sie können nicht Namen und Fragezeichen in einem Skript mischen. Wenn Sie Fragezeichen verwenden, müssen die Parameter in der nachfolgend gezeigten Reihenfolge stehen und sind nur dann optional, wenn keine nachfolgenden Parameter angegeben wurden (z.B. müssen Sie Parameter 1 verwenden, wenn Sie Parameter 2 verwenden möchten). Wenn Sie benannte Parameter verwenden, können Sie beliebige Teilmengen der Parameter in beliebiger Reihenfolge angeben.

Keine.

Der MobiLink-Server öffnet mithilfe des Skripts einen schreibgeschützten Cursor, mit dem eine Liste von Zeilen abgerufen wird, die in die entfernte Datenbank heruntergeladen werden sollen.

Sie können für jede Tabelle in der entfernten Datenbank ein download_cursor-Skript benutzen.

Um die Performance bei der Downloadphase der Synchronisation auf UltraLite-Clients zu optimieren, wenn der Bereich der Primärschlüsselwerte außerhalb der aktuellen Zeilen auf dem Device liegt, sollten Sie die Zeilen im Download-Cursor nach dem Primärschlüssel sortieren. Von dieser Optimierung können z.B. Download-Vorgänge von großen Referenztabellen profitieren.

Jedes download_cursor-Skript muss eine SELECT-Anweisung oder einen Aufruf einer Prozedur enthalten, die eine Ergebnismenge zurückgibt. Der MobiLink-Server verwendet diese Anweisung, um einen Cursor in der konsolidierten Datenbank zu definieren.

Das Skript muss alle Spalten auswählen, die mit den Spalten in der entsprechenden Tabelle der entfernten Datenbank übereinstimmen. Die Spalten in der konsolidierten Datenbank können andere Namen haben als die entsprechenden Spalten in der entfernten Datenbank. Ihre Datentypen müssen jedoch kompatibel sein.

Die Spalten müssen in der Reihenfolge ausgewählt werden, in der die entsprechenden Spalten in der entfernten Datenbank definiert sind.

Um den Download unnötiger Zeilen zu vermeiden, sollten Sie zeitstempelbasierte Downloads in Betracht ziehen. Wenn Sie zeitstempelbasierte Downloads verwenden, fügen Sie eine Zeile ähnlich der folgenden in die WHERE-Klausel Ihres download_cursor-Skripts ein:

AND last_modified >= {ml s.last_table_download}

Dieses Skript muss in SQL implementiert werden. Hinweise zur Java- oder .NET-Verarbeitung von Zeilen finden Sie unter Direkte Zeilenbehandlung.

Wenn Sie READPAST-Tabellen-Hints in download_cursor-Skripten verwenden möchten, da Sie viele Aktualisierungen ausführen, die die Download-Leistung beeinträchtigen, sollten Sie für Downloads stattdessen die Snapshot-Isolation verwenden. Der READPAST-Tabellen-Hint kann Probleme verursachen, wenn er in download_cursor-Skripten verwendet wird. Bei der Verwendung von zeitstempelbasierten Downloads kann der READPAST-Hint dazu führen, dass Zeilen fehlen und dass kein Download einer Zeile in eine entfernte Datenbank möglich ist. Zum Beispiel:

Ab diesem Punkt wird die Zeile erst dann heruntergeladen, wenn sie aktualisiert wurde. Als mögliche Behelfslösung können Sie ein generate_next_last_download_timestamp- oder modify_next_last_download_timestamp-Skript implementieren und die Zeit des letzten Downloads auf die Anfangszeit der ältesten offenen Transaktion setzen.

• Datenskripten
• Skriptparameter
• Skripten hinzufügen oder löschen
• Skripten für den Download von Zeilen schreiben
• download_cursor-Skripten schreiben
• Zeilen auf entfernte Datenbanken verteilen
• download_delete_cursor (Tabellenereignis)
• Entfernte IDs und MobiLink-Benutzernamen in Skripten verwenden
• Zeitpunkt des letzten Downloads in Skripten verwenden
• "READPAST mit MobiLink-Synchronisation verwenden" in FROM-Klausel

Das folgende Beispiel stammt aus einer Oracle-Installation.Die Anweisung kann jedoch mit allen unterstützten Datenbanken eingesetzt werden. Im Beispiel werden alle Zeilen heruntergeladen, die geändert wurden, seit der Benutzer den letzten Datendownload vorgenommen hat, und die mit dem Benutzernamen in der Spalte emp_name übereinstimmen.

CALL ml_add_table_script( 
  'Lab',
  'ULOrder',
  'download_cursor',
  'SELECT order_id, 
    cust_id, 
    prod_id, 
    emp_id, 
    disc, 
    quant, 
    notes, 
    status
   FROM ULOrder 
   WHERE last_modified >= {ml s.last_table_download} 
    AND emp_name = {ml s.username}' )