UltraLite-Dienstprogramm zum Initialisieren einer Datenbank (ulinit)

Erstellt eine neue UltraLite-Datenbank.

Dieses Dienstprogramm funktioniert in einem der folgenden Modi:

Leermodus Erstellt eine leere Datenbank mit den Merkmalen, die in den Befehlszeilenargumenten angegeben werden.
Extraktionsmodus Erstellt eine neue Datenbank, basierend auf einer SQL Anywhere-Datenbank.
Ein Anfangsschema wird erstellt, das Tabellen und Indizes in der SQL Anywhere-Referenzdatenbank entspricht. Viele der Referenzdatenbank-Eigenschaften werden extrahiert und in der neuen UltraLite-Datenbank benutzt.

Syntax

ulinit options dbname

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.
-a "keyword=value;..." ODER --SAconnect="keyword=value;..."	Setzt das Dienstprogramm in den Extraktionsmodus und stellt eine Verbindung zu einer vorhandenen Datenbank unter Verwendung der angegebenen Verbindungsparameter her. Wenn diese Option nicht vorhanden ist, erstellt das Dienstprogramm eine neue Datenbank unter Verwendung der angegebenen Verbindungsparameter Leermodus).
-c ODER --case	Leermodus. Berücksichtigung von Groß- und Kleinschreibung bei allen Zeichenfolgenvergleichen.
-d ODER --datacopy	Extraktionsmodus. Kopiert für jede Tabelle in der neuen UltraLite-Datenbank die Daten aus der entsprechenden Tabelle in der SQL Anywhere-Datenbank. Die neue Datenbank ist anfangs leer, es sei denn, Sie verwenden diese Option. Standardmäßig werden diese Daten in den nachfolgenden Synchronisationen nicht hochgeladen. Um die Daten in die nächste Upload-Synchronisation einzubeziehen, verwenden Sie -i mit -d.
--date_format=format	Leermodus. Legt das Format für Datumsangaben fest, die aus der Datenbank abgerufen werden Siehe UltraLite-Erstellungsparameter date_format.
--date_order=date-format-interpretation	Leermodus. Legt die Interpretation des Datumsformats fest. Siehe UltraLite-Erstellungsparameter date_order.
-e value ODER --fips=value	Leermodus. On oder Off, 1 oder 0, usw. Diese Option steuert die AES FIPS-zertifizierte Verschlüsselung mithilfe eines Certicom-zertifizierten Verschlüsselungsalgorithmus. Siehe Datenbanksicherheit und UltraLite-Erstellungsparameter fips.
-f ODER --exactschema	Extraktionsmodus. Schlägt fehl, wenn das exakte Schema nicht in UltraLite unterstützt wird. Andernfalls werden Warnmeldungen angezeigt, wenn es Unterschiede beim Schema gibt.
-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-Option global_database_id.
-i ODER --insertforupload	Extraktionsmodus. Verwendung mit -d. 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.
--identity-file=file	Gibt die Datei an, die die Client-TLS-Identität enthält. Siehe identity.
--identity-password=password	Legt das Kennwort für die Client-TLS-Identität fest. Siehe identity_password.
-k key ODER --key=key	Extraktionsmodus. Gibt den Chiffrierschlüssel für eine verschlüsselte Datenbank an.
-K ODER --prompt	Leermodus. Gibt an, dass Sie zur Eingabe des Chiffrierschlüssel aufgefordert werden wollen.
-l filename ODER --sql=filename	Extraktionsmodus. Protokolliert SQL-Anweisungen zur DDL-Datenbankschemaerstellung nach der Ausführung in der angegebenen Datei.
--log=filename	Leermodus. Protokolliert Vorgänge in der festgelegten Datei.
-m filename ODER --mirror_file=filename	Extraktionsmodus. Geben Sie die Datenbankspiegeldatei an. Siehe UltraLite-Verbindungsparameter MIRROR_FILE.
--max_hash_size=size	Leermodus. Legt die Standardgröße für den Index-Hash in Byte fest. Siehe UltraLite-Erstellungsparameter max_hash_size.
-n pubname ODER --publication=pubname	Extraktionsmodus. Erforderlich. Fügt Tabellen zum UltraLite-Datenbankschema hinzu. pubname definiert eine Publikation in der Referenzdatenbank. Die Tabellen in der Publikation werden zur UltraLite-Datenbank hinzugefügt. Geben Sie die Option mehrmals an, wenn der UltraLite-Datenbank mehrere Publikationen hinzugefügt werden sollen. Um alle Tabellen in der Referenzdatenbank zur UltraLite-Datenbank hinzuzufügen, geben Sie -n* an.
--nearest_century=yy	Leermodus. Steuert die Interpretation von zweistelligen Jahresangaben bei Konvertierungen von Zeichenfolgen in Datumsangaben Siehe UltraLite-Erstellungsparameter nearest_century.
-o value ODER --obfuscate=value	Leermodus. 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 Datenbanksicherheit und UltraLite-Erstellungsparameter obfuscate.
-p size ODER --page_size=size	Leermodus. Geben Sie die Seitengröße der Datenbank an.
--precision=precision	Leermodus. Legt die maximale Anzahl von Stellen im Ergebnis aller Berechnungen mit Dezimaltrennzeichen fest. Siehe UltraLite-Erstellungsparameter precision.
-q ODER --quiet	Führt das Dienstprogramm im stillen Modus aus. Informative Banner, Versionsnummern und Statusmeldungen werden unterdrückt. Fehlermeldungen und Warnungen werden jedoch weiter angezeigt.
-r size ODER --reserve_size	Nur Datenbankverbindung. Reservierungsgröße. Siehe UltraLite-Verbindungsparameter RESERVE_SIZE.
-s pubname ODER --sync_publication	Extraktionsmodus. Erstellt eine Publikation in der UltraLite-Datenbank mit derselben Definition wie pubname in der Referenzdatenbank. Publikationen werden verwendet, um die Synchronisation zu konfigurieren. Wenn Sie mehrere Synchronisationspublikationen verwenden wollen, geben Sie die Option -s mehrfach an. Die Tabellen in dieser Publikation müssen in einer Publikation enthalten sein, die durch die Option -n aufgelistet ist. Wird die Option -s nicht angegeben, hat die entfernte UltraLite-Datenbank keine benannten Publikationen. Weitere Informationen dazu, wie Sie Publikationen für die MobiLink-Synchronisation erstellen, finden Sie unter Publizieren von Daten in UltraLite.
-S checksum_level ODER --checksum_level=checksum_level	Leermodus. 0, 1 oder 2. Gibt die Ebene der Prüfsummenvalidierung auf Datenbankseiten an. Siehe UltraLite-Erstellungsparameter checksum_level.
--scale=scale	Leermodus. Legt die Mindestanzahl der Stellen nach dem Dezimalzeichen fest, wenn ein arithmetisches Ergebnis auf die maximale Gesamtstellenanzahl gekürzt wird Siehe UltraLite-Erstellungsparameter scale.
-t file ODER --rootcert=file	Gibt die Datei an, die das vertrauenswürdige Stammzertifikat enthält. Dieses Zertifikat ist für die Serverauthentifizierung erforderlich.
--time_format=format	Leermodus. Setzt das Format für Zeitwerte, die aus der Datenbank abgerufen werden Siehe UltraLite-Erstellungsparameter time_format.
--timestamp_format=format	Leermodus. Legt das Format für Zeitstempelwerte fest, die aus der Datenbank abgerufen werden. Siehe UltraLite-Erstellungsparameter timestamp_format.
--timestamp_increment=increment	Leermodus. Legt fest, wie der Zeitstempel in UltraLite gekürzt wird. Siehe UltraLite-Erstellungsparameter timestamp_increment.
--timestamp_with_time_zone_format= format	Leermodus. Diese Option stellt das Format für von der Datenbank abgerufene TIMESTAMP WITH TIME ZONE-Werte ein. Siehe UltraLite-Erstellungsparameter timestamp_with_time_zone_format.
-u <uid>,<pwd> ODER --dba=<uid>,<pwd>	Nur Datenbankverbindung. Geben Sie die Benutzer-ID und das Kennwort an.
--utf8_encoding=value	Leermodus. 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.
-w ODER --nowarnings	Extraktionsmodus. Zeigt Warnungen nicht an.
-x table ODER --exclude	Extraktionsmodus. Schließt in der Liste aufgeführte Tabellen aus.
-y ODER --overwrite	Überschreibt die vorhandene Datenbankdatei.
-z collation-sequence ODER --collation=collation-sequence	Leermodus. Geben Sie die Kollationssequenz an.
-Z ODER --listcollation	Leermodus. Listen Sie die verfügbaren Kollationssequenzen auf und beenden Sie die Anwendung.
-? ODER --help	Zeigt die Verwendung des Dienstprogramms an und beendet die Anwendung.

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.

-a "keyword=value;..."

ODER

--SAconnect="keyword=value;..."

Setzt das Dienstprogramm in den Extraktionsmodus und stellt eine Verbindung zu einer vorhandenen Datenbank unter Verwendung der angegebenen Verbindungsparameter her.

Wenn diese Option nicht vorhanden ist, erstellt das Dienstprogramm eine neue Datenbank unter Verwendung der angegebenen Verbindungsparameter Leermodus).

-c

ODER

--case

Leermodus.

Berücksichtigung von Groß- und Kleinschreibung bei allen Zeichenfolgenvergleichen.

-d

ODER

--datacopy

Extraktionsmodus.

Kopiert für jede Tabelle in der neuen UltraLite-Datenbank die Daten aus der entsprechenden Tabelle in der SQL Anywhere-Datenbank. Die neue Datenbank ist anfangs leer, es sei denn, Sie verwenden diese Option.

Standardmäßig werden diese Daten in den nachfolgenden Synchronisationen nicht hochgeladen. Um die Daten in die nächste Upload-Synchronisation einzubeziehen, verwenden Sie -i mit -d.

--date_format=format

Leermodus.

Legt das Format für Datumsangaben fest, die aus der Datenbank abgerufen werden Siehe UltraLite-Erstellungsparameter date_format.

--date_order=date-format-interpretation

Leermodus.

Legt die Interpretation des Datumsformats fest. Siehe UltraLite-Erstellungsparameter date_order.

-e value

ODER

--fips=value

Leermodus.

On oder Off, 1 oder 0, usw. Diese Option steuert die AES FIPS-zertifizierte Verschlüsselung mithilfe eines Certicom-zertifizierten Verschlüsselungsalgorithmus. Siehe Datenbanksicherheit und UltraLite-Erstellungsparameter fips.

-f

ODER

--exactschema

Extraktionsmodus.

Schlägt fehl, wenn das exakte Schema nicht in UltraLite unterstützt wird. Andernfalls werden Warnmeldungen angezeigt, wenn es Unterschiede beim Schema gibt.

-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-Option global_database_id.

-i

ODER

--insertforupload

Extraktionsmodus.

Verwendung mit -d. 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.

--identity-file=file

Gibt die Datei an, die die Client-TLS-Identität enthält. Siehe identity.

--identity-password=password

Legt das Kennwort für die Client-TLS-Identität fest. Siehe identity_password.

-k key

ODER

--key=key

Extraktionsmodus.

Gibt den Chiffrierschlüssel für eine verschlüsselte Datenbank an.

-K

ODER

--prompt

Leermodus.

Gibt an, dass Sie zur Eingabe des Chiffrierschlüssel aufgefordert werden wollen.

-l filename

ODER

--sql=filename

Extraktionsmodus.

Protokolliert SQL-Anweisungen zur DDL-Datenbankschemaerstellung nach der Ausführung in der angegebenen Datei.

--log=filename

Leermodus.

Protokolliert Vorgänge in der festgelegten Datei.

-m filename

ODER

--mirror_file=filename

Extraktionsmodus.

Geben Sie die Datenbankspiegeldatei an. Siehe UltraLite-Verbindungsparameter MIRROR_FILE.

--max_hash_size=size

Leermodus.

Legt die Standardgröße für den Index-Hash in Byte fest. Siehe UltraLite-Erstellungsparameter max_hash_size.

-n pubname

ODER

--publication=pubname

Extraktionsmodus.

Erforderlich. Fügt Tabellen zum UltraLite-Datenbankschema hinzu.

pubname definiert eine Publikation in der Referenzdatenbank. Die Tabellen in der Publikation werden zur UltraLite-Datenbank hinzugefügt.

Geben Sie die Option mehrmals an, wenn der UltraLite-Datenbank mehrere Publikationen hinzugefügt werden sollen. Um alle Tabellen in der Referenzdatenbank zur UltraLite-Datenbank hinzuzufügen, geben Sie -n* an.

--nearest_century=yy

Leermodus.

Steuert die Interpretation von zweistelligen Jahresangaben bei Konvertierungen von Zeichenfolgen in Datumsangaben Siehe UltraLite-Erstellungsparameter nearest_century.

-o value

ODER

--obfuscate=value

Leermodus.

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 Datenbanksicherheit und UltraLite-Erstellungsparameter obfuscate.

-p size

ODER

--page_size=size

Leermodus.

Geben Sie die Seitengröße der Datenbank an.

--precision=precision

Leermodus.

Legt die maximale Anzahl von Stellen im Ergebnis aller Berechnungen mit Dezimaltrennzeichen fest. Siehe UltraLite-Erstellungsparameter precision.

-q

ODER

--quiet

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

-r size

ODER

--reserve_size

Nur Datenbankverbindung.

Reservierungsgröße. Siehe UltraLite-Verbindungsparameter RESERVE_SIZE.

-s pubname

ODER

--sync_publication

Extraktionsmodus.

Erstellt eine Publikation in der UltraLite-Datenbank mit derselben Definition wie pubname in der Referenzdatenbank. Publikationen werden verwendet, um die Synchronisation zu konfigurieren. Wenn Sie mehrere Synchronisationspublikationen verwenden wollen, geben Sie die Option -s mehrfach an.

Die Tabellen in dieser Publikation müssen in einer Publikation enthalten sein, die durch die Option -n aufgelistet ist.

Wird die Option -s nicht angegeben, hat die entfernte UltraLite-Datenbank keine benannten Publikationen.

Weitere Informationen dazu, wie Sie Publikationen für die MobiLink-Synchronisation erstellen, finden Sie unter Publizieren von Daten in UltraLite.

-S checksum_level

ODER

--checksum_level=checksum_level

Leermodus.

0, 1 oder 2. Gibt die Ebene der Prüfsummenvalidierung auf Datenbankseiten an. Siehe UltraLite-Erstellungsparameter checksum_level.

--scale=scale

Leermodus.

Legt die Mindestanzahl der Stellen nach dem Dezimalzeichen fest, wenn ein arithmetisches Ergebnis auf die maximale Gesamtstellenanzahl gekürzt wird Siehe UltraLite-Erstellungsparameter scale.

-t file

ODER

--rootcert=file

Gibt die Datei an, die das vertrauenswürdige Stammzertifikat enthält. Dieses Zertifikat ist für die Serverauthentifizierung erforderlich.

--time_format=format

Leermodus.

Setzt das Format für Zeitwerte, die aus der Datenbank abgerufen werden Siehe UltraLite-Erstellungsparameter time_format.

--timestamp_format=format

Leermodus.

Legt das Format für Zeitstempelwerte fest, die aus der Datenbank abgerufen werden. Siehe UltraLite-Erstellungsparameter timestamp_format.

--timestamp_increment=increment

Leermodus.

Legt fest, wie der Zeitstempel in UltraLite gekürzt wird. Siehe UltraLite-Erstellungsparameter timestamp_increment.

--timestamp_with_time_zone_format=

format

Leermodus.

Diese Option stellt das Format für von der Datenbank abgerufene TIMESTAMP WITH TIME ZONE-Werte ein. Siehe UltraLite-Erstellungsparameter timestamp_with_time_zone_format.

-u <uid>,<pwd>

ODER

--dba=<uid>,<pwd>

Nur Datenbankverbindung.

Geben Sie die Benutzer-ID und das Kennwort an.

--utf8_encoding=value

Leermodus.

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.

-w

ODER

--nowarnings

Extraktionsmodus.

Zeigt Warnungen nicht an.

-x table

ODER

--exclude

Extraktionsmodus.

Schließt in der Liste aufgeführte Tabellen aus.

-y

ODER

--overwrite

Überschreibt die vorhandene Datenbankdatei.

-z collation-sequence

ODER

--collation=collation-sequence

Leermodus.

Geben Sie die Kollationssequenz an.

-Z

ODER

--listcollation

Leermodus.

Listen Sie die verfügbaren Kollationssequenzen auf und beenden Sie die Anwendung.

ODER

--help

Zeigt die Verwendung des Dienstprogramms an und beendet die Anwendung.

Hinweis

Eine Option kann in einem der beiden Modi verwendet werden, falls nicht eine in der Beschreibung erwähnt ist.

Bemerkungen

Bei Ausführung im Extraktionsmodus versucht ULINIT, eine UltraLite-Datenbank zu erstellen, die so weit wie möglich mit der SQL Anywhere-Datenbank übereinstimmt. Wenn beispielsweise eine Spalte in der SQL Anywhere-Datenbank über eine Klausel verfügt, die UltraLite nicht unterstützt, wird der Standardwert ignoriert und stattdessen wird der UltraLite-Standardwert verwendet. Eine Warnung wird generiert und die Erstellung wird fortgesetzt. Dies ist sinnvoll, wenn SQL Anywhere-Tabellen nicht geändert werden können, aber eine angemessene UltraLite-Alternative zur Verfügung steht. Um eine genaue Schemaentsprechung zu erzwingen, verwenden Sie die -f-Option. Das Dienstprogramm ulinit schlägt fehl, wenn das Schema keine geeignete UltraLite-Alternative unterstützt.

Siehe auch

Beispiele

Erstellen Sie eine Datei mit dem Namen customer.udb, die die Tabellen aus TestPublication enthält:

ulinit -a "DSN=MySADb;UID=JimmyB;PWD=secret" -n TestPublication -k mykey customer.udb

In diesem Beispiel wird eine Verbindung zu einer SQL Anywhere-Datenbank hergestellt, die in der MySADb-Datenquelle angegeben ist. Es wird eine UltraLite-Datenbank mit allen Optionen dieser Datenbank und allen Tabellen in der Publikation TestPublication erstellt. Die neue UltraLite-Datenbank wird customer.udb genannt und mit dem Schlüssel mykey verschlüsselt.

Erstellen Sie eine Datei namens customer.udb, die zwei unterschiedliche Publikationen enthält. Pub1 könnte eine kleine Teilmenge von Daten für eine vorrangige Synchronisation enthalten, während Pub2 den Großteil der Daten enthalten könnte:

ulinit -a "DSN=MySADb;UID=JimmyB;PWD=secret" --exactschema -n Pub1 -n Pub2 -s Pub1 -s Pub2 customer.udb

In diesem Beispiel wird eine Verbindung zu einer SQL Anywhere-Datenbank hergestellt, die in der MySADb-Datenquelle angegeben ist. Es wird eine UltraLite-Datenbank mit allen Optionen dieser Datenbank und allen Tabellen in den Publikationen Pub1 und Pub2 erstellt. Die neue UltraLite-Datenbank wird ebenfalls mit den Publikationen Pub1 und Pub2 erstellt. Da die Option --exactschema eingestellt ist, schlägt ulinit fehl, wenn das genaue Schema nicht extrahiert werden kann.

Erstellen Sie eine neue, leere Datenbank, die eine andere customer.udb-Datei überschreibt, wenn vorhanden. Die neue Datenbank hat kein Schema und alle Datenbankoptionen sind auf Standardwerte gesetzt.

ulinit -y customer.udb

Kommentieren Sie diese Seite in DocCommentXchange.