Difference between revisions of "NL/Documentation/How Tos/Using SQLite With OpenOffice.org"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Why use SQLite with OpenOffice?)
(Werken met de database in {{AOo}})
 
(25 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
{{DISPLAYTITLE:SQLite gebruiken met {{AOO}}}}
 +
 
=Introductie=
 
=Introductie=
 
OpenOffice Base verschaft functies om met andere databases te erbinden dan de standaard HSQL database. Deze handleiding zou u door de stappen moeten leiden om {{AOo}} te verbinden met een [https://www.sqlite.org/ SQLite] databasebestand.
 
OpenOffice Base verschaft functies om met andere databases te erbinden dan de standaard HSQL database. Deze handleiding zou u door de stappen moeten leiden om {{AOo}} te verbinden met een [https://www.sqlite.org/ SQLite] databasebestand.
Line 31: Line 33:
  
 
* Aanpassen van de structuur van een tabel van SQLite, nadat die is gemaakt, is niet direct mogelijk. Dit betekent dat u niet gemakkelijk velden kunt toevoegen, noch hun eigenschappen kunt aanpassen als de tabel eenmaal is gemaakt. Daarom moet u de structuur van uw tabellen voorbereiden voordat u ze maakt.
 
* Aanpassen van de structuur van een tabel van SQLite, nadat die is gemaakt, is niet direct mogelijk. Dit betekent dat u niet gemakkelijk velden kunt toevoegen, noch hun eigenschappen kunt aanpassen als de tabel eenmaal is gemaakt. Daarom moet u de structuur van uw tabellen voorbereiden voordat u ze maakt.
* OpenOffice.org requires the use of the ODBC driver for accessing a SQLite database thus making this operation somewhat complicated. First it must be declared in ODBC and then in OpenOffice. The native SDBC driver should correct this situation when it is production ready.  
+
* {{AOo}} vereist het gebruiken van het stuurprogramma voor ODBC voor toegang tot een database van SQLite database, wat deze bewerking enigszins gecompliceerd maakt. Het moet eerst worden gedeclareerd in ODBC en dan in OpenOffice. Het eigen stuurprogramma voor SDBC zou deze situatie moeten corrigeren als de database klaar is voor productie.  
* The initial database file cannot be created with OpenOffice but by using other tools.   
+
* Het initiële databasebestand kan niet worden gemaakt met {{AOo}}, maar met andere programma's.   
  
In short, the principal advantages of the use of SQLite with OpenOffice are the format of data storage and the portability from one environment to another. In the list of disadvantages, the two last are not specific to SQLite, but are requirements of using ODBC. However, these are not as awkward as they do not take place during the initial creation of the database.   
+
In het kort: de grootste voordelen van het gebruiken van SQLite met OpenOffice zijn de indeling voor de opslag van gegevens en de portabiliteit van de ene omgeving naar de andere. In de lijst met nadelen zijn de twee laatste niet specifiek voor SQLite, maar zijn vereisten voor het gebruiken van ODBC. Echter, ze zijn niet zo ongemakkelijk, omdat ze niet plaatsvinden bij het initiële maken van de database.   
  
{{Note|SQLite appeals to anyone frustrated with using MDB files under Linux, or who has had difficulty installing MySQL or other RDBMS server on their workstation.}}
+
{{Note|SQLite spreekt iedereen aan die is gefrustreerd met het gebruiken van MDB-bestanden onder Linux, of die moeilijkheden heeft met het installeren van MySQL of een andere server voor RDBMS op zijn werkstation.}}
  
=Installation=
+
=Installatie=
  
{{Lin|'''Under Linux'''}}
+
{{Lin|'''Onder Linux'''}}
  
== Unix ODBC Platform ==
+
== Unix ODBC-platform ==
Connection to a SQLite database will be established through [https://www.unixodbc.org/ UnixODBC]. ODBC is an open specification to provide applications with a consistent interface to a variety of data sources. UnixODBC is an implementation of this specification for non-Windows platforms.
+
Verbinden met een database van SQLite zal worden gerealiseerd via [https://www.unixodbc.org/ UnixODBC]. ODBC is een open specificatie om toepassingen te voorzien van een consistente interface voor een groot scala aan gegevensbronnen. UnixODBC is een implementatie van deze specificatie voor niet-Windows platforms.
  
You can install <tt>unixodbc</tt> with your distribution's package manager, or download the sources from the [https://www.unixodbc.org/ UnixODBC website]. The <tt>unixodbc-bin</tt> package provides a GUI application for configuration, which will be used below. Under Ubuntu or similar Linux distributions, you can use the command:
+
U kunt <tt>unixodbc</tt> installeren met de pakketbeheerder van uw distributie, of de bronnen downloaden vanaf de [https://www.unixodbc.org/ website van UnixODBC]. Het pakket <tt>unixodbc-bin</tt> verschaft een toepassing met GUI voor het configureren, die hieronder zal worden gebruikt. Onder Ubuntu of soortgelijke distributies van Linux kunt u de volgende opdracht gebruiken:
  
 
  sudo apt-get install unixodbc unixodbc-bin
 
  sudo apt-get install unixodbc unixodbc-bin
  
 
==SQLite==
 
==SQLite==
Obviously you will need to install [https://www.sqlite.org SQLite] if it is not installed already as this will be the database you want to connect to.  
+
Uiteraard zult u [https://www.sqlite.org SQLite] moeten installeren als dat nog niet geïnstalleerd is, omdat dat de database is waarmee u wilt verbinden.  
  
You can install SQLite with your distributions package manager. The package should be called <tt>sqlite</tt> or <tt>sqlite3</tt>.  Under Ubuntu:
+
U kunt SQLite installeren met de pakketbeheerder van uw distributie. Het pakket zou <tt>sqlite</tt> of <tt>sqlite3</tt> moeten hetenOnder Ubuntu:
  
 
  sudo apt-get install sqlite3
 
  sudo apt-get install sqlite3
  
If you prefer, you can always [https://www.sqlite.org/download.html download] and install the latest version from source.
+
Als u dat wilt, kunt u altijd [https://www.sqlite.org/download.html downloaden] en de laatste versie van de bron installeren.
  
== SQLite ODBC Driver ==
+
== SQLite ODBC-stuurprogramma ==
For SQLite to work through the ODBC standards you will also need to install and configure the [http://ch-werner.de/sqliteodbc/ SQLite ODBC Driver].
+
Om SQLite te laten werken met de standaarden van ODBC zult u ook het [http://ch-werner.de/sqliteodbc/ SQLite ODBC-stuurprogramma] moeten installeren en configureren.
This driver is available in Ubuntu in the <tt>libsqliteodbc</tt> package.
+
Dit stuurprogramma is in Ubuntu beschikbaar in het pakket <tt>libsqliteodbc</tt>.
  
If you prefer, you can [http://ch-werner.de/sqliteodbc/ download the source] and compile it yourself. You will need the <tt>unixodbc-dev</tt> and <tt>libsqlite3-dev</tt> packages installed for it to build successfully.
+
Als u dat wilt, kunt u ook [http://ch-werner.de/sqliteodbc/ de bron downloaden] en het zelf compileren. U moet de paketten <tt>unixodbc-dev</tt> en <tt>libsqlite3-dev</tt> geïnstalleerd hebben om het met succes te kunnen bouwen.
  
  
To complete the installation the driver has to be integrated into unixODBC. To do this, launch the ODBCConfig utility as root in an terminal window:
+
Het stuurprogramma moet, om de installatie te voltooien, worden geïntegreerd in unixODBC. Start, als root, het programma ODBCConfig in een venster van de terminal:
  
 
  sudo ODBCConfig
 
  sudo ODBCConfig
  
{{Note|If ODBCConfig is not found check that you also installed the <tt>unixODBC-bin</tt> package while installing the [[#ODBC_drivers|ODBC drivers]].}}
+
{{Note|Als ODBCConfig niet wordt gevonden, controleer dan of u ook het pakket <tt>unixODBC-bin</tt> hebt geïnstalleerd bij het installeren van de [[#ODBC_drivers|stuurprogramma's voor ODBC]].}}
  
Now a GUI to manage the configuration shows up.
+
Nu verschijnt er een GUI om de configuratie te beheren.
 
[[Image:doc_howto_sqlite_odbcadmin.png|390px]]
 
[[Image:doc_howto_sqlite_odbcadmin.png|390px]]
  
Click the <tt>Drivers</tt> tab and choose <tt>Add…</tt> Then fill the fields as follows:
+
Klik op de tab <tt>Drivers</tt> en kies <tt>Add…</tt> Vul dan de velden als volgt in:
  
 
  Name: SQLite
 
  Name: SQLite
  Description: SQLite for ODBC
+
  Description: SQLite voor ODBC
 
  Driver: /usr/lib/libsqlite3odbc.so
 
  Driver: /usr/lib/libsqlite3odbc.so
 
  Driver64: /usr/lib64/libsqlite3odbc.so
 
  Driver64: /usr/lib64/libsqlite3odbc.so
Line 83: Line 85:
 
  Setup64: /usr/lib64/libsqlite3odbc.so
 
  Setup64: /usr/lib64/libsqlite3odbc.so
  
{{Note|If you are still using a 2.8.x version of libsqlite the driver names will be different. Try browsing the folder by clicking on the arrow at the right and select one that seems suitable.}}
+
{{Note|Als u nog steeds een versie 2.8.x van libsqlite gebruikt zullen de namen van het stuurprogramma anders zijn. Probeer door de map te bladeren door te klikken op de pijl aan de rechterkant en selecteer er een die geschikt lijkt.}}
  
Then confirm using the checkmark icon on the left in top of the window. Your new driver will now appear in the <tt>Drivers</tt> tab:
+
Bevestig dan met het pictogram van het vinkje in de linkerbovenhoek van het venster. Uw nieuwe stuurprogramma zal nu verschijnen in de tab <tt>Drivers</tt>:
 
[[Image:doc_howto_sqlite_odbcadmin-2.png|450px]]
 
[[Image:doc_howto_sqlite_odbcadmin-2.png|450px]]
  
The driver installation under Linux is now finished and you can exit <tt>ODBCConfig</tt>.
+
De installatie van het stuurprogramma onder Linux is nu voltooid en u kunt <tt>ODBCConfig</tt> sluiten.
  
  
For those who do not have <tt>ODBCConfig</tt> or who prefer to carry out this configuration manually, it is necessary to edit the file <tt>/etc/odbcinst.ini</tt> as root and add the following lines:
+
Voor hen die <tt>ODBCConfig</tt> niet hebben of deze configuratie zelf handmatig willen uitvoeren, is het noodzakelijk om het bestand <tt>/etc/odbcinst.ini</tt> als root te bewerken en de volgende regels toe te voegen:
 
  <nowiki>[SQLite]</nowiki>''
 
  <nowiki>[SQLite]</nowiki>''
  Description<nowiki>= ODBC for SQLite</nowiki>''
+
  Description<nowiki>= ODBC voor SQLite</nowiki>''
 
  Driver<nowiki>= /usr/lib/libsqliteODBC.so</nowiki>''
 
  Driver<nowiki>= /usr/lib/libsqliteODBC.so</nowiki>''
 
  Driver64<nowiki>= /usr/lib64/libsqliteODBC.so</nowiki>''
 
  Driver64<nowiki>= /usr/lib64/libsqliteODBC.so</nowiki>''
Line 103: Line 105:
  
 
==Under Windows==
 
==Under Windows==
{{Win|Under Windows the installation and configuration is much easier. Simply [http://ch-werner.de/sqliteodbc/ download the sqliteODBC.exe], the installer will automatically setup the ODBC drivers including the SQLite configurations for it and also provides you with the sqlite command line tool to create and modify SQLite databases.}}
+
{{Win|Onder Windows is de installatie en het configureren veel gemakkelijker. [http://ch-werner.de/sqliteodbc/ Download eenvoudigweg sqliteODBC.exe], het installatie programma zal automatisch de stuurprogramma's voor ODBC instellen, inclusief de configuraties voor SQLite daarvoor en verschaft u ook het SQLite programma voor de opdrachtregel om databases van SQLite te maken en aan te passen.}}
  
=Setup of SQLite database=
+
=Instellen van database SQLite=
  
==Creating a SQLite database file==
+
==Maken van een bestand voor database van SQLite==
An initial database file cannot be created directly in {{AOo}} but rather this is accomplished by using either the utility “<tt>sqlite</tt>” on the command line or by using a graphical management tool, a list of GUIs is available at [https://www2.sqlite.org/cvstrac/wiki?p=ManagementTools SQLite.org]
+
Een initieel databasebestand kan niet direct worden gemaakt in {{AOo}}, maar dit wordt bereikt door ofwel het programma “<tt>sqlite</tt>” op de opdrachtegrel te gebruiken of door een programma met grafisch beheer te gebruiken, een lijst met GUI's is beschikbaar op [https://www2.sqlite.org/cvstrac/wiki?p=ManagementTools SQLite.org]
  
The utility "<tt>sqlite</tt>" should be already installed if you use Linux and have installed SQLite from rpm. For other *NIX systems, you must build SQLite from source which you can find at [https://www.sqlite.org/download.html www.sqlite.org/download]
+
Het programma "<tt>sqlite</tt>" zou al moeten zijn geïnstalleerd als u Linux gebruikt en SQLite hebt geïnstalleerd vanuit rpm. Voor andere systemen van *NIX, moet u SQLite vanuit de bron bouwen die te vinden is op [https://www.sqlite.org/download.html www.sqlite.org/download]
  
Performance and usage under Linux and Windows is identical.
+
Uitvoering en gebruik onder Linux en Windows is identiek.
 
   
 
   
===Using sqlite===
+
===SQLite gebruiken===
{{Lin|Open a terminal window and change to the directory where you want to create your database. Run <tt>sqlite</tt> with the filename of your database as argument (e.g. ''$ sqlite mydatabase''}}
+
{{Lin|Open een venster voor de terminal en wijzig naar de map waar u uw database wilt maken. Voer <tt>sqlite</tt> uit met de bestandsnaam van uw database als argument (bijv. ''$ sqlite mijndatabase''}}
{{Win|Run <tt>sqlite</tt> from the start menu or where it was installed. A standard file open dialog box will open and ask you to select a database file.}}
+
{{Win|Voer <tt>sqlite</tt> uit vanuit het menu Start of waar het werd geïnstalleerd. Een standaard dialoogvenster voor het openen van bestanden zal openen en u vragen een databasebestand te selecteren.}}
If this database file does not exist yet, it will be created automatically. Using <tt>sqlite</tt> you can also create tables and modify your database with standard SQL-commands:
+
Als dit databasebestand nog niet bestaat, zal het automatisch worden gemaakt. Met <tt>sqlite</tt> kunt u ook tabellen maken en uw database aanpassen met standaard opdrachten voor SQL:
  
  <nowiki>$ sqlite <filename of database></nowiki>
+
  <nowiki>$ sqlite <bestandsnaam van de database></nowiki>
  SQLite version 2.8.12
+
  SQLite version 3.32.3
  Enter ".help" for instructions
+
  Enter ".help" for usage hints
 
  sqlite> CREATE TABLE mytable (id INT, text VARCHAR(100));
 
  sqlite> CREATE TABLE mytable (id INT, text VARCHAR(100));
  sqlite> .exit
+
  sqlite> .quit
  
{{Note|You can then check that the file was, indeed, created in your filesystem. The name of the file does not require a file extension, but you can give it the extension <tt>db</tt> so that is easy to locate as a database.}}
+
{{Note|U kunt dan controleren of het bestand, inderdaad, werd gemaakt in uw bestandssysteem. De naam van het bestand vereist geen bestandsextensie, maar u kunt het de extensie <tt>db</tt> geven, zodat het eenvoudig te lokaliseren is als een database.}}
  
Using <tt>sqlite</tt> on the command line program makes it possible to create tables and indices, to enter and post data and
+
Gebruiken van het programma <tt>sqlite</tt> op de opdrachtregel maakt het mogelijk tabellen en indices te maken, om gegevens in te voeren en te posten en query's te maken, vooropgesteld dat u de taal SQL kent - het is echter praktischer voor beginners om deze bewerkingen later met OpenOffice uit te voeren.
to make queries provided you know the SQL language - however, it is more practical for beginners to carry out these operations later on using
+
OpenOffice.
+
  
===Using SQLite Database Browser===
+
===SQLite Database Browser gebruiken===
There is also a graphical utility for creating and manipulating SQLite databases called <tt>sqlitebrowser</tt>.
+
Er is ook een grafisch programma voor het maken en bewerken van databases van SQLite, genaamd <tt>sqlitebrowser</tt>.
You can install this using your distribution's package manager.
+
U kunt dit installeren met de pakketbeheerder van uw distributie.
  
After unpacking the file, launch <tt>sqlitebrowser</tt> and select <tt>File/New Database</tt> or the corresponding icon:
+
Na het uitpakken van het bestand, start <tt>sqlitebrowser</tt> en selecteer {{menu|Bestand|Nieuwe database}} of het corresponderende pictogram:
  
[[Image:doc_howto_sqlite_dbbrowser.png|410px]]
+
[[Image:doc_howto_sqlite_dbbrowser_nl.png]]
  
Choose the directory in which to place the file and then enter the name of the database file and click on <tt>Save</tt>.
+
Kies de map waarin het bestand moet worden geplaatst en voer dan de naam van het databasebestand in en klik op {{button|Opslaan}}.
  
Using this program, you can also create the tables, the fields, and the indices, to access data and to visualize them. While
+
Met dit programma kunt u ook de tabellen maken, de velden en de indexen, toegang verkrijgen tot gegevens en ze visualiseren. Hoewel
<tt>sqlitebrowswer</tt> is suitable for these actions, there is the disadvantage that it does not show the full list of field types during field creation. In this case, it may be preferable to do it later using {{AOo}}.
+
<tt>sqlitebrowswer</tt> geschikt is voor deze acties, is er het nadeel dat het niet de volledige lijst van veldtypen weergeeft bij het maken van het veld. In dat geval zou het misschien beter zijn om dat let te doen met {{AOo}}.
  
==ODBC-setup of new database==
+
==Instellen van ODBC voor nieuwe database==
After creating a new SQLite database above you now have to configure this database in ODBC so you can connect to it in OpenOffice later on.
+
Na het maken van een nieuwe database voor SQLite hierboven moet u nu deze database in ODBC configureren, zodat u er later in OpenOffice mee kunt verbinden.
  
  
{{Lin|'''Under Linux:'''
+
{{Lin|'''Onder Linux:'''
Launch <tt>ODBCConfig</tt> again as normal user and go to the tab <tt>User DSN</tt>. Here add a new entry. A window appears in which you must choose
+
Start <tt>ODBCConfig</tt> opnieuw als een normale gebruiker en ga naar de tab <tt>User DSN</tt>. Voeg hier een nieuw item in. Er verschijnt een venster waar u het stuurprogramma voor <tt>SQLite</tt> moet kiezen die u eerder geconfigureerd hebt. In het volgende venster, zoals hieronder weergegeven, voert u een naam in voor deze verbinding (bijvoorbeeld de naam van uw database) en het volledige pad naar het databasebestand dat u eerder hebt gemaakt.
the <tt>SQLite</tt> driver you have configured earlier. In the next window, as shown below, you enter a name for this connection (for example the name of your database) and the complete access path to the database file which you created previously.
+
  
 
[[Image:doc_howto_sqlite_driverproperties-2.png|380px]]
 
[[Image:doc_howto_sqlite_driverproperties-2.png|380px]]
  
Validate the data on the screen, click the checkmark and you should see your new data source in the tab <tt>User DSN</tt>.
+
Valideer de gegevens op het scherm, klik op het vinkje en u zou uw nieuwe gegevensbron op de tab <tt>User DSN</tt> moeten zien.
  
  
If you do not have <tt>ODBCConfig</tt> or simply prefer to configure manually, launch your favorite editor, open (or create)  
+
Als u <tt>ODBCConfig</tt> niet hebt of eenvoudigweg de voorkeur hebt om het handmatig te configureren, start uw favoriet bewerker, open (of maak) het bestand <tt>odbc.ini</tt> in uw thuismap, en voeg daarin de volgende regels toe:
the file <tt>odbc.ini</tt> in your home directory, and add the following lines to it:
+
  
 
  <nowiki>[My Base]</nowiki>
 
  <nowiki>[My Base]</nowiki>
Line 167: Line 165:
 
  StepAPI<nowiki>= No</nowiki>
 
  StepAPI<nowiki>= No</nowiki>
  
{{Note|If this data source must by other users on the system, launch <tt>ODBCConfig</tt> as root and add this source in the tab <tt>System DSN</tt> or <tt>data Source system</tt>, or create a <tt>/etc/odbc.ini</tt> file.}}
+
{{Note|Als deze gegevensbron ook door andere gebruikers op het systeem moet worden gebruikt, start <tt>ODBCConfig</tt> als root en voeg deze bron toe op de tab <tt>System DSN</tt> of <tt>data Source system</tt>, of maak een bestand <tt>/etc/odbc.ini</tt>.}}
  
You are now ready to access your database with {{AOo}}!}}
+
U bent nu klaar om toegang te krijgen tot uw database met {{AOo}}!}}
  
{{Win|'''Under Windows:'''
+
{{Win|'''Onder Windows:'''
You will reach the configuration through the OpenOffice dialog in the next step, just read on.}}
+
U bereikt de configuratie via het dialoogvenster van {{AOo}} in de volgende stap, lees gewoon door.}}
  
=Connecting OpenOffice to a SQLite database=
+
={{AOo}} verbinden met een database van SQLite=
You had to spend a lot of time installing and configuring other things but finally we can move on to OpenOffice. Only a few more configuration windows and you will be done.
+
U moest veel tijd spenderen aan het installeren en configureren van andere dingen, maar we kunnen tenslotte overgaan naar {{AOo}}. Nog slechts een paar vensters voor configuratie en u bent er klaar voor.
  
Start ''OpenOffice Base'' and in the first step '''1. Select database''' chose the third option, connect to an existing database using ODBC.
+
Start ''OpenOffice Base'' en kies in de eerste stap '''1. Database selecteren''' de derde optie, Met een bestaande database verbinden  met ODBC.
  
  Connect to an existing database
+
  Met een bestaande database verbinden
 
   ODBC
 
   ODBC
  
In the second step '''2. Set up ODBC connection''' you can select your SQLite database. Clicking on ''Browse'' you should get a list of all databases you have [[#ODBC-setup of new database|configured]] in ODBC.
+
In de tweede stap '''2. ODBC-verbinding instellen''' kunt u uw database van SQLite selecteren. Klikken op ''Bladeren'' zou u een lijst van alle database moeten geven die u hebt [[#{{AOo}} verbinden met een database van SQLite|geconfigureerd]] in ODBC.
  
If nothing is showing up here you have a problem. Check that you actually [[#ODBC-setup of new database|set up the database in ODBC]] and that the drivers are properly configured as described.
+
Als hier niets wordt weergegeven heeft u een probleem. Controleer dat u feitelijk [[#{{AOo}} verbinden met een database van SQLite|de database hebt ingesteld in ODBC]] en dat de stuurprogramma's correct zijn geconfigureerd, zoals beschreven.
  
{{Win|'''Under Windows:'''
+
{{Win|'''Onder Windows:'''
Before you will find your database listed here you need to register it with ODBC as mentioned above. Click on ''Organize...'' in the bottom right of the window.
+
Voordat u uw database hier vermeld ziet moet u die registreren in ODBC zoals hierboven vermeld. Klik op ''Beheren …'' aan de rechteronderzijde van het venster.
  
[[Image:doc_howto_sqlite_odbcdriver-windows-1.png]]
+
[[Image:doc_howto_sqlite_odbcdriver-windows-1_nl.png|400px]]
  
  
In the ''User DSN'' (or the ''System DSN'') tab click on ''Add...'' to setup your database file.
+
Op de tab ''Gebruikers-DSN'' (of de tab ''Systeem-DSN''), klik op ''Toevoegen…'' om uw databasebestand in te stellen.
  
[[Image:doc_howto_sqlite_odbcdriver-windows-2.png]]
+
[[Image:doc_howto_sqlite_odbcdriver-windows-2_nl.png]]
  
  
Give your database a meaningful name as ''Data Source Name'' - this will be the name you find your database listed as. For ''Database Name'' browse to the SQLite database file you have created earlier. Leave the rest on its default values and press ok.  
+
Geef uw database een betekenisvolle naam bij ''Data Source Name'' - dit zal de naam zijn waaronder uw database zal worden vermeld. Blader voor ''Database Name'' naar het SQLite databasebestand dat u eerder gemaakt hebt. Laat de rest op zijn standaard waarden en druk op {{button|OK}}.  
  
 
[[Image:doc_howto_sqlite_odbcdriver-windows-3.png]]
 
[[Image:doc_howto_sqlite_odbcdriver-windows-3.png]]
  
  
The database will now be listed in the ''ODBC Data Source Administrator'' and leaving this window you should now also be able to select this database in the ''OpenOffice Base'' dialog.
+
De database zal nu worden vermeld in de ''ODBC Data Source Administrator'' en na het verlaten van dit venster zou u in staat moeten zijn deze database te selecteren in het dialoogvenster ''OpenOffice Base''.
 
}}
 
}}
  
 +
=Werken met de database in {{AOo}}=
 +
De rest is ''OpenOffice Base'' zoals u het kent.
  
 +
Onthoud alleen enkele dingen:
 +
Het maken van nieuwe tabellen met OpenOffice is mogelijk. Die tabellen - samen met alle gegevens die u daar invoert - worden opgeslagen in het externe databasebestand van SQLite waarmee u uw OpenOffice .odb-bestand hebt verbonden.
  
 +
Velden die zijn gedefinieerd als het type "integer" zijn automatisch verhogend, wat betekent dat ze automatisch de waarde van het veld verhogen als een nieuw record in de tabel wordt ingevoegd.
  
=Working on the database with OpenOffice=
+
{{Warn|Als u de tabel eenmaal hebt opgeslagen, kunt u die niet meer aanpassen! D.i. u kunt de eigenschappen van de velden niet meer aanpassen, noch toevoegen of verwijderen!}}
The rest is ''OpenOffice Base'' just as you know it.
+
 
+
Only note a few things:
+
Creating new tables using OpenOffice is possible. Those tables - along with all data you enter in them - are saved in the external SQLite database file to which you connected your OpenOffice .odb file.
+
 
+
Fields defined as type "integer" are auto-increment, that is they automatically increment the value of the field when adding a new record in this table.
+
 
+
{{Warn|Once you have saved your table, you cannot modify it! I.e. you will not be able to modify the properties of the fields any more, nor add or remove!}}
+
 
+
This rather awkward constraint is specific to SQLite, which does not handle the SQL command ALTER COUNTS, and not the ODBC driver. This limitation is designed in by the authors in order to make the basic database engine as light as possible. However, this limitation may be eliminated in a future version. Therefore you are advised to check your table structure very carefully before recording it.
+
  
If you must modify a table, the only solution is to create a new table and save it under different name. By doing so, you can transfer the data from the original table to the new table.  
+
Deze nogal ongemakkelijke beperking is specifiek voor SQLite, dat de opdracht voor SQL ALTER COUNTS niet afhandelt, en niet het stuurprogramma voor ODBC. Deze beperking is door de auteurs ontworpen om het basisprogramma voor de database zo licht mogelijk te maken. Deze beperking zou echter in een toekomstige versie kunnen verdwijnen. U wordt daarom geadviseerd uw tabelstructuur zorgvuldig te controleren, voordat u die opneemt.
  
 +
Als u een tabel moet aanpassen, is de enige oplossing om een nieuwe tabel te maken en die onder ene andere naam op te slaan. U kunt, door dit te doen, de gegevens overzetten van de originele tabel naar de nieuwe tabel.
  
Creating and using Forms, Queries and Reports are all independent of the datasource you use. They will function just as with the default integrated HSQL-database and will still be saved in your odb-file. For more information on these topics refer to the [[Base|other documentation]].
+
Maken en gebruiken van formulieren, query's en rapporten zijn allemaal onafhankelijk van de gegevensbron die u gebruikt. Zij zullen net zo functioneren als met de standaard geïntegreerde HSQL-database en zullen nog steeds worden opgeslagen in uw .odb-bestand. Bekijk voor meer informatie over deze onderwerpen de [[Base|andere documentatie]].
  
{{Warn|If you want to use subforms you need to activate "parameter substitution" first.
+
{{Warn|Als u subformulieren wilt gebruiken moet u eerst "parameter vervangen" activeren.
Select "Edit/Database/Advanced Settings..." in the main menu of your OpenOffice Base window. There, in the "Special Settings" tab check the option "Replace named parameters with '?'". You might need to restart OpenOffice but then you should be able to use subforms without problems.}}
+
Selecteer {{menu|Bewerken|Database|Geavanceerde instellingen…}} in het hoofdmenu van uw venster van OpenOffice Base. Selecteer daar, op de tab "Speciale instellingen", de optie "Benoemde parameters vervangen door '?'". U moet misschien OpenOffice opnieuw starten, maar dan zou u zonder problemen subformulieren moeten kunnen gebruiken.}}
  
=Exchanging databases between users=
+
=Databases uitwisselen tussen gebruikers=
  
Thanks to the availability of driver sqliteODBC driver for both Linux and Windows (just as for OpenOffice, of course!), a SQLite
+
Danzij d ebeschikbaarheid van het stuurprogramma sqliteODBC voor zowel Linux als Windows (net als voor OpenOffice natuurlijk!), kan een database van SQLite gemakkelijk wordne gedeeld door d egebruikers van de twee omgevingen. Het is nodig dat elk een stuurprogramma voor ODBC heeft geïnstalleerd dat zich bewust is van het SQLite-doelbestand en dat die is gedefinieerd als een gegevensbron in OpenOffice. Op dezelfde wijze kunnen OpenOffice Base-bestanden (.odb), die formulieren en macro's bevatten, ook worden gedeeld door d egebruikers van de twee omgevingen.
database can be easily exchanged between users of the two environments. It is necessary that each has an installed
+
ODBC driver that is aware of the target SQLite file and which is defined as a data source in OpenOffice. Likewise, OpenOffice Base files (.odb) containing forms and macros can also be exchanged between users of the two environments.
+
  
{{Warn|If forms are to function correctly for each user, it is absolutely necessary that each user applies exactly the same name to the data source during its creation.}}
+
{{Warn|Als formulieren correct moeten functioneren voor elke gebruiker, is het absoluut noodzakelijk dat elke gebruiker exact dezelfde naam toepast voor de gegevensbron bij het maken daarvan.}}
  
 
{{PDL1}}
 
{{PDL1}}
Line 240: Line 232:
 
[[Category:Database]]
 
[[Category:Database]]
 
[[Category:Documentation/How Tos/Database]]
 
[[Category:Documentation/How Tos/Database]]
 +
[[en:Documentation/How_Tos/Using_SQLite_With_OpenOffice.org]]
 +
[[fr:FR/Documentation/How_Tos/Utiliser_SQLite_Avec_OpenOffice.org]]

Latest revision as of 11:18, 30 June 2023


Introductie

OpenOffice Base verschaft functies om met andere databases te erbinden dan de standaard HSQL database. Deze handleiding zou u door de stappen moeten leiden om Apache OpenOffice te verbinden met een SQLite databasebestand.

Wat is SQLite?

SQLite is een basis databaseprogramma dat de meeste mogelijkheden van SQL92 implementeert. Anders dan PostgreSQL en MySQL, slaat SQLite een hele database met al zijn tabellen op in één enkel bestand. Andere voordelen zijn: toegang tot de database vereist geen database-server, databasebestanden kunnen vrijelijk worden gedeeld tussen machines met verschillende volgorde van bytes en databases mogen tot 2 terabytes (241 bytes) in grootte zijn. En daarnaast is het heel snel (twee keer zo snel als PostgreSQL en MySQL voor de meeste bewerkingen) en heeft een kleine voetafdruk voor het geheugen.

Beheren van de gegevens kan worden gedaan op de volgende manieren:

  1. Via een Linux-bibliotheek voor C/C++ of Windows DLL.
  2. Via een in-regelig programma (sqlite: beschikbaar onder Linux en Windows) dat het mogelijk maakt de bestanden van de database te maken of te beheren.
  3. Via de SQLite PHP-module of, als u dat heeft, PHP versie 5 intern naar een database van SQLite.
  4. Via ODBC (Linux en Windows) wat een toepassing die deze standaard ondersteunt, toestaat een database van SQLite te bereiken.
  5. Gebruiken van het experimentele stuurprogramma voor SDBC SQLite

Deze gids beperkt zich tot ODBC wat Apache OpenOffice gebruikt om te verbinden met databases en in het bijzonder SQLite.

Waarom SQLite te gebruiken met OpenOffice?

Het gebruiken van SQLite heeft vele voordelen:

  • De database is slechts in één bestand, in tegenstelling tot dBASE dat een bestand per tabel maakt, wat het delen van databases tussen verschillende gebruikers eenvoudig maakt.
  • Java JRE of SDK is niet vereist voor ondersteuning van SQLite.
  • Er is geen server nodig (lokaal of op afstand) voor toegang tot een database.
  • Stuurprogramma's voor ODBC bestaan voor *NIX en voor Windows, wat gebruikers van beide omgevingen in staat stelt toegang te krijgen tot de gegevens en ze te delen.
  • Een nieuw stuurprogramma voor SDBC (eigen voor Apache OpenOffice) is beschikbaar om mee te experimenteren.
  • Uitgebreide grafische interfaces, zoals die van MS Access, kunnen gemakkelijk worden ontwikkeld met de formulieren, query's, statussen en macro's van Apache OpenOffice. Deze interfaces worden afzonderlijk opgeslagen in .odb-bestanden van OpenOffice en kunnen onafhankelijk van de gegevens worden gedeeld met gebruikers onder UNIX of Windows.

en enkele nadelen:

  • Aanpassen van de structuur van een tabel van SQLite, nadat die is gemaakt, is niet direct mogelijk. Dit betekent dat u niet gemakkelijk velden kunt toevoegen, noch hun eigenschappen kunt aanpassen als de tabel eenmaal is gemaakt. Daarom moet u de structuur van uw tabellen voorbereiden voordat u ze maakt.
  • Apache OpenOffice vereist het gebruiken van het stuurprogramma voor ODBC voor toegang tot een database van SQLite database, wat deze bewerking enigszins gecompliceerd maakt. Het moet eerst worden gedeclareerd in ODBC en dan in OpenOffice. Het eigen stuurprogramma voor SDBC zou deze situatie moeten corrigeren als de database klaar is voor productie.
  • Het initiële databasebestand kan niet worden gemaakt met Apache OpenOffice, maar met andere programma's.

In het kort: de grootste voordelen van het gebruiken van SQLite met OpenOffice zijn de indeling voor de opslag van gegevens en de portabiliteit van de ene omgeving naar de andere. In de lijst met nadelen zijn de twee laatste niet specifiek voor SQLite, maar zijn vereisten voor het gebruiken van ODBC. Echter, ze zijn niet zo ongemakkelijk, omdat ze niet plaatsvinden bij het initiële maken van de database.

Documentation note.png SQLite spreekt iedereen aan die is gefrustreerd met het gebruiken van MDB-bestanden onder Linux, of die moeilijkheden heeft met het installeren van MySQL of een andere server voor RDBMS op zijn werkstation.

Installatie

Documentation linux.png Onder Linux

Unix ODBC-platform

Verbinden met een database van SQLite zal worden gerealiseerd via UnixODBC. ODBC is een open specificatie om toepassingen te voorzien van een consistente interface voor een groot scala aan gegevensbronnen. UnixODBC is een implementatie van deze specificatie voor niet-Windows platforms.

U kunt unixodbc installeren met de pakketbeheerder van uw distributie, of de bronnen downloaden vanaf de website van UnixODBC. Het pakket unixodbc-bin verschaft een toepassing met GUI voor het configureren, die hieronder zal worden gebruikt. Onder Ubuntu of soortgelijke distributies van Linux kunt u de volgende opdracht gebruiken:

sudo apt-get install unixodbc unixodbc-bin

SQLite

Uiteraard zult u SQLite moeten installeren als dat nog niet geïnstalleerd is, omdat dat de database is waarmee u wilt verbinden.

U kunt SQLite installeren met de pakketbeheerder van uw distributie. Het pakket zou sqlite of sqlite3 moeten heten. Onder Ubuntu:

sudo apt-get install sqlite3

Als u dat wilt, kunt u altijd downloaden en de laatste versie van de bron installeren.

SQLite ODBC-stuurprogramma

Om SQLite te laten werken met de standaarden van ODBC zult u ook het SQLite ODBC-stuurprogramma moeten installeren en configureren. Dit stuurprogramma is in Ubuntu beschikbaar in het pakket libsqliteodbc.

Als u dat wilt, kunt u ook de bron downloaden en het zelf compileren. U moet de paketten unixodbc-dev en libsqlite3-dev geïnstalleerd hebben om het met succes te kunnen bouwen.


Het stuurprogramma moet, om de installatie te voltooien, worden geïntegreerd in unixODBC. Start, als root, het programma ODBCConfig in een venster van de terminal:

sudo ODBCConfig
Documentation note.png Als ODBCConfig niet wordt gevonden, controleer dan of u ook het pakket unixODBC-bin hebt geïnstalleerd bij het installeren van de stuurprogramma's voor ODBC.

Nu verschijnt er een GUI om de configuratie te beheren. Doc howto sqlite odbcadmin.png

Klik op de tab Drivers en kies Add… Vul dan de velden als volgt in:

Name: SQLite
Description: SQLite voor ODBC
Driver: /usr/lib/libsqlite3odbc.so
Driver64: /usr/lib64/libsqlite3odbc.so
Setup: /usr/lib/libsqlite3odbc.so
Setup64: /usr/lib64/libsqlite3odbc.so
Documentation note.png Als u nog steeds een versie 2.8.x van libsqlite gebruikt zullen de namen van het stuurprogramma anders zijn. Probeer door de map te bladeren door te klikken op de pijl aan de rechterkant en selecteer er een die geschikt lijkt.

Bevestig dan met het pictogram van het vinkje in de linkerbovenhoek van het venster. Uw nieuwe stuurprogramma zal nu verschijnen in de tab Drivers: Doc howto sqlite odbcadmin-2.png

De installatie van het stuurprogramma onder Linux is nu voltooid en u kunt ODBCConfig sluiten.


Voor hen die ODBCConfig niet hebben of deze configuratie zelf handmatig willen uitvoeren, is het noodzakelijk om het bestand /etc/odbcinst.ini als root te bewerken en de volgende regels toe te voegen:

[SQLite]
Description= ODBC voor SQLite
Driver= /usr/lib/libsqliteODBC.so
Driver64= /usr/lib64/libsqliteODBC.so
Setup= /usr/lib/libsqliteODBC.so
Setup64= /usr/lib64/libsqliteODBC.so
FileUsage= 1
CPTimeout= 
CPReuse= 

Under Windows

Documentation windows.png Onder Windows is de installatie en het configureren veel gemakkelijker. Download eenvoudigweg sqliteODBC.exe, het installatie programma zal automatisch de stuurprogramma's voor ODBC instellen, inclusief de configuraties voor SQLite daarvoor en verschaft u ook het SQLite programma voor de opdrachtregel om databases van SQLite te maken en aan te passen.

Instellen van database SQLite

Maken van een bestand voor database van SQLite

Een initieel databasebestand kan niet direct worden gemaakt in Apache OpenOffice, maar dit wordt bereikt door ofwel het programma “sqlite” op de opdrachtegrel te gebruiken of door een programma met grafisch beheer te gebruiken, een lijst met GUI's is beschikbaar op SQLite.org

Het programma "sqlite" zou al moeten zijn geïnstalleerd als u Linux gebruikt en SQLite hebt geïnstalleerd vanuit rpm. Voor andere systemen van *NIX, moet u SQLite vanuit de bron bouwen die te vinden is op www.sqlite.org/download

Uitvoering en gebruik onder Linux en Windows is identiek.

SQLite gebruiken

Documentation linux.png Open een venster voor de terminal en wijzig naar de map waar u uw database wilt maken. Voer sqlite uit met de bestandsnaam van uw database als argument (bijv. $ sqlite mijndatabase
Documentation windows.png Voer sqlite uit vanuit het menu Start of waar het werd geïnstalleerd. Een standaard dialoogvenster voor het openen van bestanden zal openen en u vragen een databasebestand te selecteren.

Als dit databasebestand nog niet bestaat, zal het automatisch worden gemaakt. Met sqlite kunt u ook tabellen maken en uw database aanpassen met standaard opdrachten voor SQL:

$ sqlite <bestandsnaam van de database>
SQLite version 3.32.3
Enter ".help" for usage hints
sqlite> CREATE TABLE mytable (id INT, text VARCHAR(100));
sqlite> .quit
Documentation note.png U kunt dan controleren of het bestand, inderdaad, werd gemaakt in uw bestandssysteem. De naam van het bestand vereist geen bestandsextensie, maar u kunt het de extensie db geven, zodat het eenvoudig te lokaliseren is als een database.

Gebruiken van het programma sqlite op de opdrachtregel maakt het mogelijk tabellen en indices te maken, om gegevens in te voeren en te posten en query's te maken, vooropgesteld dat u de taal SQL kent - het is echter praktischer voor beginners om deze bewerkingen later met OpenOffice uit te voeren.

SQLite Database Browser gebruiken

Er is ook een grafisch programma voor het maken en bewerken van databases van SQLite, genaamd sqlitebrowser. U kunt dit installeren met de pakketbeheerder van uw distributie.

Na het uitpakken van het bestand, start sqlitebrowser en selecteer Bestand → Nieuwe database of het corresponderende pictogram:

Doc howto sqlite dbbrowser nl.png

Kies de map waarin het bestand moet worden geplaatst en voer dan de naam van het databasebestand in en klik op  Opslaan .

Met dit programma kunt u ook de tabellen maken, de velden en de indexen, toegang verkrijgen tot gegevens en ze visualiseren. Hoewel sqlitebrowswer geschikt is voor deze acties, is er het nadeel dat het niet de volledige lijst van veldtypen weergeeft bij het maken van het veld. In dat geval zou het misschien beter zijn om dat let te doen met Apache OpenOffice.

Instellen van ODBC voor nieuwe database

Na het maken van een nieuwe database voor SQLite hierboven moet u nu deze database in ODBC configureren, zodat u er later in OpenOffice mee kunt verbinden.


Documentation linux.png Onder Linux:

Start ODBCConfig opnieuw als een normale gebruiker en ga naar de tab User DSN. Voeg hier een nieuw item in. Er verschijnt een venster waar u het stuurprogramma voor SQLite moet kiezen die u eerder geconfigureerd hebt. In het volgende venster, zoals hieronder weergegeven, voert u een naam in voor deze verbinding (bijvoorbeeld de naam van uw database) en het volledige pad naar het databasebestand dat u eerder hebt gemaakt.

Doc howto sqlite driverproperties-2.png

Valideer de gegevens op het scherm, klik op het vinkje en u zou uw nieuwe gegevensbron op de tab User DSN moeten zien.


Als u ODBCConfig niet hebt of eenvoudigweg de voorkeur hebt om het handmatig te configureren, start uw favoriet bewerker, open (of maak) het bestand odbc.ini in uw thuismap, en voeg daarin de volgende regels toe:

[My Base]
Description= My test database
Driver= SQLite
Database= /home/<user>/basename.db
Timeout= 1000
StepAPI= No
Documentation note.png Als deze gegevensbron ook door andere gebruikers op het systeem moet worden gebruikt, start ODBCConfig als root en voeg deze bron toe op de tab System DSN of data Source system, of maak een bestand /etc/odbc.ini.

U bent nu klaar om toegang te krijgen tot uw database met Apache OpenOffice!

Documentation windows.png Onder Windows:

U bereikt de configuratie via het dialoogvenster van Apache OpenOffice in de volgende stap, lees gewoon door.

Apache OpenOffice verbinden met een database van SQLite

U moest veel tijd spenderen aan het installeren en configureren van andere dingen, maar we kunnen tenslotte overgaan naar Apache OpenOffice. Nog slechts een paar vensters voor configuratie en u bent er klaar voor.

Start OpenOffice Base en kies in de eerste stap 1. Database selecteren de derde optie, Met een bestaande database verbinden met ODBC.

Met een bestaande database verbinden
 ODBC

In de tweede stap 2. ODBC-verbinding instellen kunt u uw database van SQLite selecteren. Klikken op Bladeren zou u een lijst van alle database moeten geven die u hebt geconfigureerd in ODBC.

Als hier niets wordt weergegeven heeft u een probleem. Controleer dat u feitelijk de database hebt ingesteld in ODBC en dat de stuurprogramma's correct zijn geconfigureerd, zoals beschreven.

Documentation windows.png Onder Windows:

Voordat u uw database hier vermeld ziet moet u die registreren in ODBC zoals hierboven vermeld. Klik op Beheren … aan de rechteronderzijde van het venster.

Doc howto sqlite odbcdriver-windows-1 nl.png


Op de tab Gebruikers-DSN (of de tab Systeem-DSN), klik op Toevoegen… om uw databasebestand in te stellen.

Doc howto sqlite odbcdriver-windows-2 nl.png


Geef uw database een betekenisvolle naam bij Data Source Name - dit zal de naam zijn waaronder uw database zal worden vermeld. Blader voor Database Name naar het SQLite databasebestand dat u eerder gemaakt hebt. Laat de rest op zijn standaard waarden en druk op  OK .

Doc howto sqlite odbcdriver-windows-3.png


De database zal nu worden vermeld in de ODBC Data Source Administrator en na het verlaten van dit venster zou u in staat moeten zijn deze database te selecteren in het dialoogvenster OpenOffice Base.

Werken met de database in Apache OpenOffice

De rest is OpenOffice Base zoals u het kent.

Onthoud alleen enkele dingen: Het maken van nieuwe tabellen met OpenOffice is mogelijk. Die tabellen - samen met alle gegevens die u daar invoert - worden opgeslagen in het externe databasebestand van SQLite waarmee u uw OpenOffice .odb-bestand hebt verbonden.

Velden die zijn gedefinieerd als het type "integer" zijn automatisch verhogend, wat betekent dat ze automatisch de waarde van het veld verhogen als een nieuw record in de tabel wordt ingevoegd.

Documentation caution.png Als u de tabel eenmaal hebt opgeslagen, kunt u die niet meer aanpassen! D.i. u kunt de eigenschappen van de velden niet meer aanpassen, noch toevoegen of verwijderen!

Deze nogal ongemakkelijke beperking is specifiek voor SQLite, dat de opdracht voor SQL ALTER COUNTS niet afhandelt, en niet het stuurprogramma voor ODBC. Deze beperking is door de auteurs ontworpen om het basisprogramma voor de database zo licht mogelijk te maken. Deze beperking zou echter in een toekomstige versie kunnen verdwijnen. U wordt daarom geadviseerd uw tabelstructuur zorgvuldig te controleren, voordat u die opneemt.

Als u een tabel moet aanpassen, is de enige oplossing om een nieuwe tabel te maken en die onder ene andere naam op te slaan. U kunt, door dit te doen, de gegevens overzetten van de originele tabel naar de nieuwe tabel.

Maken en gebruiken van formulieren, query's en rapporten zijn allemaal onafhankelijk van de gegevensbron die u gebruikt. Zij zullen net zo functioneren als met de standaard geïntegreerde HSQL-database en zullen nog steeds worden opgeslagen in uw .odb-bestand. Bekijk voor meer informatie over deze onderwerpen de andere documentatie.

Documentation caution.png Als u subformulieren wilt gebruiken moet u eerst "parameter vervangen" activeren.

Selecteer Bewerken → Database → Geavanceerde instellingen… in het hoofdmenu van uw venster van OpenOffice Base. Selecteer daar, op de tab "Speciale instellingen", de optie "Benoemde parameters vervangen door '?'". U moet misschien OpenOffice opnieuw starten, maar dan zou u zonder problemen subformulieren moeten kunnen gebruiken.

Databases uitwisselen tussen gebruikers

Danzij d ebeschikbaarheid van het stuurprogramma sqliteODBC voor zowel Linux als Windows (net als voor OpenOffice natuurlijk!), kan een database van SQLite gemakkelijk wordne gedeeld door d egebruikers van de twee omgevingen. Het is nodig dat elk een stuurprogramma voor ODBC heeft geïnstalleerd dat zich bewust is van het SQLite-doelbestand en dat die is gedefinieerd als een gegevensbron in OpenOffice. Op dezelfde wijze kunnen OpenOffice Base-bestanden (.odb), die formulieren en macro's bevatten, ook worden gedeeld door d egebruikers van de twee omgevingen.

Documentation caution.png Als formulieren correct moeten functioneren voor elke gebruiker, is het absoluut noodzakelijk dat elke gebruiker exact dezelfde naam toepast voor de gegevensbron bij het maken daarvan.
Content on this page is licensed under the Public Documentation License (PDL).
Personal tools
In other languages