La Primera Vez

Que tal SQLite?

Tres preguntas: ¿esta es la primera vez que utiliza Bauble?, ¿va a trabajar desde un solo ordenador?, ¿no tiene ni meñique idea de que es un sistema de gestión de base de datos? Pues si la respuesta a una de estas es «así es», mejor se quede con SQLite, la base de datos SQL más utilizada en el mundo, fácil, rápida, sin administración.

Con SQLite, no hace falta preparar nada y puede seguir con connecting.

On the other hand, if you want to connect more than one bauble workstation to the same database, or if you want to make your data available for other clients, as could be a web server in a LAMP setting, you should consider keeping your database in a database management system like PostgreSQL or MySQL/MariaDB, both supported by Bauble.

When connecting to a database server as one of the above, you have to manually create: at least one bauble user, the database you want bauble to use, and to give at lest one bauble user full permissions on its database. When this is done, Bauble will be able to proceed, creating the tables and importing the default data set. The process is database-dependent and it falls beyond the scope of this manual.

If you already got the chills or sick at your stomach, no need to worry, just stick with SQLite, you do not miss on features nor performance.

Conectarse a una base de datos

Al arrancar Bauble, lo primero que aparece es una ventana para escojer la conexión.

Pues si esta es la primera vez que arranca Bauble por supuesto no hay conexiones. Bauble se lo deja notar.

_images/first-time-activation.png

Como Bauble le sugiere: cierre la ventana, con esto vuelve a la ventana de conexión, donde puede pisar Add para crear la primera conexión.

_images/enter-a-connection-name.png

No más inserte el nombre de la conexión, algo sencillo y relevante, que se asocie a la colección que va a poner en la base de datos (por ejemplo: «parques municipales»), y pise OK. Bauble vuelve a la ventana anterior, donde el nombre de la conexión está seleccionada y los Detalles de conexión se han expandido.

_images/my-first-botanical-garden.png

especificar los detalles de conexión

Si no sabría que hacer acá, Bauble le da una mano. Active el Utilice los valores por defecto y finalice el crear la conexión pisando Conectar.

El resto de esta sección da más detalles de natura técnica. Si no quiere adentrarse, puede seguir con la sección siguiente.

detalles de conexión: sintonización fina

By default Bauble uses the file-based SQLite database. During the installation process you had the choice (and you still have after installation), to add database connectors other than the default SQLite.

In this example, Bauble can connect to SQLite, PostgreSQL and MySQL, but no connector is available for Oracle or MS SQL Server.

_images/connection-drop-down.png

If you use SQLite, all you really need specify is the connection name. If you let Bauble use the default filename then Bauble creates a database file with the same name as the connection and .db extension, and a pictures folder with the same name and no extension, both in ~/.bauble on Linux/MacOSX or in AppData\Roaming\Bauble on Windows.

Still with SQLite, you might have received or downloaded a bauble database, and you want to connect to it. In this case you do not let Bauble use the default filename, but you browse in your computer to the location where you saved the Bauble SQLite database file.

If you use a different database connector, the dialog box will look different and it will offer you the option to fine tune all parameters needed to connect to the database of your choice.

If you are connecting to an existing database you can continue to Editar e Insertar información and subsequently Searching in Bauble, otherwise read on to the following section on initializing a database for Bauble.

If you plan to associate pictures to plants, specify also the pictures root folder. The meaning of this is explained in further detail at Fotos in Editar e Insertar información.

Inicializar una base de datos

La primera vez que se abre una conexión a una base de datos, nunca antes vista con Bauble, el programa presenta el aviso:

_images/empty-database.png

e inmediatamente después la pregunta:

_images/bauble-create-new.png

Be careful when manually specifying the connection parameters: the values you have entered may refer to an existing database, not intended for use with Bauble. By letting Bauble initialize a database, the database will be emptied and all of its content be lost.

If you are sure you want to create a database at this connection then select «Yes». Bauble will then start creating the database tables and importing the default data. This can take a minute or two so while all of the default data is imported into the database so be patient.

Cuando se haya creado, configurado, inicialisado la base de datos, estamos listos para Editar e Insertar información y lo más interesante Searching in Bauble.