TPSQL/de: what changed
Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | ### Über | |
| 2 | 2 | ||
| 3 | 3 | TPSQL ist ein modifizierte-LGPL Package für Lazarus. Es definiert zwei Komponenten, TPSQLDatabase und TPSQLDataset, welche Anwendungen die Verbindung zu PostgreSQL Datenbankservern über TCP/IP Netzwerke erlauben. | |
| 4 | 4 | ||
| 5 | 5 | Der Download enthält die Komponenten-Pascal-Dateien, die Lazarus Package Datei, Ressourcendateien und die modifizierte-LGPL Lizenz-Textdateien. | |
| 6 | 6 | ||
| 7 | 7 | Diese Komponenten wurden entwickelt für Anwendungen, die auf Linux oder Win32 Plattformen laufen. | |
| 8 | 8 | ||
| 9 | 9 | ### Autor | |
| 10 | 10 | ||
| 11 | 11 | Antonio d'Avino | |
| 12 | 12 | ||
| 13 | 13 | ### Lizenz | |
| 14 | 14 | ||
| 15 | 15 | Modifizierte LGPL (lesen sie COPYING.modifiedLGPL und COPYING.LGPL die im Package enthalten sind). | |
| 16 | 16 | ||
| 17 | 17 | ### Download | |
| 18 | 18 | ||
| 19 | 19 | Das letzte stabile Release ist zu finden auf der [Lazarus CCR Files Seite](http://sourceforge.net/project/showfiles.php?group_id=92177&package_id=98986) oder auf den Internetseiten des Autors [<http://infoconsult.homelinux.net>](http://infoconsult.homelinux.net). | |
| 20 | 20 | ||
| 21 | 21 | ### Änderungs Log | |
| 22 | 22 | ||
| 23 | 23 | - Version 0.4.0 2005/06/01 | |
| 24 | 24 | - Version 0.4.1 2005/06/02 | |
| 25 | 25 | ||
| 26 | - | ||
| 26 | + | ```text | |
| 27 | + | - ClientEncoding Eigenschaft zur TPSQLDatabase class hinzugefügt. | |
| 28 | + | ``` | |
| 27 | 29 | ||
| 28 | 30 | - Version 0.4.2 2005/06/03 | |
| 29 | 31 | ||
| 30 | - | ||
| 31 | - | ||
| 32 | - | ||
| 32 | + | ```text | |
| 33 | + | - Einige Änderungen an der destroy Methode von TPSQLDatabase/TPSQLDataset zur Vermeidung von Exceptions | |
| 34 | + | when closing IDE/project with components in Active/Connected status. | |
| 35 | + | - Base path in archived files geändert von 'usr/share/lazarus/components/psql' zu 'psql' | |
| 36 | + | ``` | |
| 33 | 37 | ||
| 34 | 38 | - Version 0.4.6 2005/06/06 | |
| 35 | 39 | ||
| 36 | - | ||
| 37 | - | ||
| 38 | - | ||
| 39 | - | ||
| 40 | + | ```text | |
| 41 | + | - Executing queries that doesn't return data column now raises an exception. | |
| 42 | + | - commandQuery Funktion hinzugefügt (siehe Verwendung Abschnitt). | |
| 43 | + | - beginTransaction/commitTransaction/rollbackTransaction Unterstützung hinzugefügt (siehe Verwendung Abschnitt). | |
| 44 | + | - Weitere ClientEncoding Entitäten hinzugefügt. | |
| 45 | + | ``` | |
| 40 | 46 | ||
| 41 | 47 | ### Abhängigkeiten / Systemvoraussetzungen | |
| 42 | 48 | ||
| 43 | 49 | - Lazarus 0.9.6 (FPC 1.9.8) | |
| 44 | 50 | ||
| 45 | 51 | Status: Stabil | |
| 46 | 52 | ||
| 47 | 53 | Sachverhalte: Getestet unter Windows (Win2K) und Linux (Mdk 10.1). Datenbankserver: PostgreSQL 8.0.3 (laufend auf beiden Plattformen). | |
| 48 | 54 | ||
| 49 | 55 | ### Installation | |
| 50 | 56 | ||
| 51 | 57 | - Im lazarus/components Verzeichnis entpacken sie die Dateien aus der psql-laz-package-\<version\>.tar.gz Datei. Der psql Ordner wird erzeugt. | |
| 52 | 58 | - Öffnen sie Lazarus | |
| 53 | 59 | - Öffnen sie das Package psql_laz.lpk unter Komponenten -\> Paketdatei (.lpk) öffnen ... | |
| 54 | 60 | - (Klicken sie auf Kompilieren nur dann, wenn sie das Package nicht in die IDE installieren wollen) | |
| 55 | 61 | - Klicken sie auf Installieren und antworten mit 'Ja' wenn sie gefragt werden, ob Lazarus neu erstellt werden soll. Ein neuer Tab namens 'PSQL' wird in der Komponentenpalette erzeugt. | |
| 56 | 62 | ||
| 57 | 63 | **Wichtige Anmerkung für Win32 Benutzer.** | |
| 58 | 64 | ||
| 59 | - | ||
| 60 | - | ||
| 61 | - | ||
| 62 | - | ||
| 63 | - | ||
| 64 | - | ||
| 65 | + | ```text | |
| 66 | + | In dem Fall, dass sie einige Schwierigkeiten beim Kompilieren der Pascal Dateien im Package erleben, mögen sie den folgenden Pfad: | |
| 67 | + | ||
| 68 | + | <some-drive>:<some-path>\lazarus\lcl\units\i386-win32 | |
| 69 | + | (d.h.: c:\programs\lazarus\lcl\units\i386-win32) | |
| 70 | + | ||
| 71 | + | zu 'Andere Unitdateien' in 'Pfade' der 'Compilereinstellungen' des Lazarus Packagemanager Fenster hinzufügen. | |
| 72 | + | ``` | |
| 65 | 73 | ||
| 66 | 74 | ### Verwendung | |
| 67 | 75 | ||
| 68 | 76 | Legen sie eine TPSQLDatabase Komponente auf einem Formular ab, für jede verschiedene PostgreSQL Datenbank, mit der sich ihre Anwendung verbinden muss. Zwingende Eigenschaften dieser Komponente, die sie setzen müssen, sind: | |
| 69 | 77 | ||
| 70 | 78 | - DatabaseName : Der Name der PostgreSQL Datenbank, mit der sich ihre Anwendung verbinden muss. | |
| 71 | 79 | - HostName : Die IP Adresse oder die URL des PC's, auf dem der PostgreSQL Server gehostet ist. | |
| 72 | 80 | - UserName : Der Name eines Benutzers, der Zugriffsrechte auf Host/Datenbank hat. | |
| 73 | 81 | ||
| 74 | 82 | Optional müssen sie evtl. die Password Eigenschaft setzen für eine korrekte Verbindung zum Server. Dann, um die Verbindung zu aktivieren, müssen sie die Connected Eigenschaft auf 'True' setzen. Eine Exception wird ausgelöst, wenn die Verbindung fehlgeschlagen ist (falsche Parameter, Benutzer ohne Zugriffsrechte, Netzwerkfehler oder der PostgreSQL Server ist nicht aktiv). Setzen sie die Eigenschaft auf 'False' um die Verbindung zu schließen. | |
| 75 | 83 | ||
| 76 | 84 | **- Anmerkung über die ClientEncoding Eigenschaft.** | |
| 77 | 85 | ||
| 78 | - | ||
| 79 | - | ||
| 80 | - | ||
| 81 | - | ||
| 82 | - | ||
| 83 | - | ||
| 84 | - | ||
| 85 | - | ||
| 86 | - | ||
| 87 | - | ||
| 86 | + | ```text | |
| 87 | + | Die ClientEncoding Eigenschaft erlaubt dem Benutzer to set a character set for the client | |
| 88 | + | application different from the one defined for the database. The PostgreSQL server | |
| 89 | + | make a 'translation' between the two sets. However a "ClientEncoding change failed" | |
| 90 | + | exception may be the result of a ClientEncoding property change. This may be due to | |
| 91 | + | a database character set incompatible with the clientencoding you selected. IE, | |
| 92 | + | the char set 'LATIN9' is not compatible with a 'WIN1250'. You select the default | |
| 93 | + | char set for the whole database cluster when you create it mit dem Kommando | |
| 94 | + | 'initdb', unter Verwendung der -E Option: d.h. 'initdb -E UNICODE'. Also, you can define a | |
| 95 | + | different character set for any database you create (different from the | |
| 96 | + | default one of the whole db cluster), auch mit der -E Option: | |
| 88 | 97 | ||
| 89 | - | ||
| 90 | - | ||
| 91 | - | ||
| 98 | + | d.h. 'createdb -E UNICODE Test' | |
| 99 | + | ||
| 100 | + | oder | |
| 92 | 101 | ||
| 93 | - | ||
| 102 | + | CREATE DATABASE TEST WITH ENCODING 'UNICODE'; | |
| 94 | 103 | ||
| 95 | - | ||
| 104 | + | (Anmerkung: Sie müssen den character set Namen in Anführungszeichen setzen in dem 'CREATE DATABASE' Kommando). | |
| 96 | 105 | ||
| 97 | - | ||
| 98 | - | ||
| 99 | - | ||
| 106 | + | Ich empfehle, den UNICODE character set als Vorgabe einzustellen für your db cluster (oder für die Datenbank, | |
| 107 | + | die sie erzeugen), weil es kompatibel ist mit the whole set of charset available | |
| 108 | + | for the client, except the MULE_INTERNAL. | |
| 109 | + | ``` | |
| 100 | 110 | ||
| 101 | 111 | Now you may drop a TPSQLDataset component on the form for any table connection you need. The main property to set on this component type is the Database one. A dropdown menu allows you to select one of any TDatabase descendant component present on form (natürlich müssen sie eine TPSQLDatabase Komponente wählen). | |
| 102 | 112 | ||
| 103 | 113 | You also need to provide a valid SQL statement in SQL property. Now, you are able to open the TPSQLDataset, setting to 'True' the Active property. Several exceptions are provided for signaling failing conditions. Please, refer to TDataSet documentation für Infos und Beispiele über die Verwendung der TPSQLDataset Komponente in order to access to SQL retrieved data rows as well as conneting to Data Controls components. However, procedures and functions added to parent class sind hier beschrieben: | |
| 104 | 114 | ||
| 105 | 115 | \- function **commandQuery ( query : String) : ShortInt**. | |
| 106 | 116 | ||
| 107 | - | ||
| 108 | - | ||
| 109 | - | ||
| 110 | - | ||
| 117 | + | ```text | |
| 118 | + | Verwenden sie diese Funktion für submit queries that doesn't returns data columns, as update queries | |
| 119 | + | (d.h. update, insert, delete etc.). Current dataset is not affected, however it will reflect | |
| 120 | + | changes made by execution of commandQuery itself, if it has some influence on current | |
| 121 | + | dataset. Die Funktion gibt 0 zurück, wenn sie erfolgreich war, -1 bei einem Fehlschlag. Exceptions werden nicht unterstütz. | |
| 122 | + | ``` | |
| 111 | 123 | ||
| 112 | 124 | \- procedure **beginTransaction** | |
| 113 | 125 | ||
| 114 | - | ||
| 115 | - | ||
| 126 | + | ``` pascal | |
| 127 | + | Startet eine SQL transaction session. Changes to table may be submitted | |
| 128 | + | using the commandQuery function. | |
| 129 | + | ``` | |
| 116 | 130 | ||
| 117 | 131 | \- procedure **commitTransaction** | |
| 118 | 132 | ||
| 119 | - | ||
| 120 | - | ||
| 133 | + | ```text | |
| 134 | + | Beendet eine SQL transaction session, commiting changes submitted starting | |
| 135 | + | from last beginTransaction execution. | |
| 136 | + | ``` | |
| 121 | 137 | ||
| 122 | 138 | \- procedure **rollbackTransaction** | |
| 123 | 139 | ||
| 124 | - | ||
| 140 | + | ```text | |
| 141 | + | Beendet eine SQL transaction session, aborting changes. | |
| 142 | + | ``` | |
| 125 | 143 | ||
| 126 | 144 | --- | |
| 127 | 145 | *From the Free Pascal wiki, page "TPSQL/de", as it stood on 2010-10-19 after a change by Mischi, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |