Jan Ulrich Hasecke
2020-07-21 2dda138b6615d3973aa7fe55f90688784cec1e23
commit | author | age
8d081a 1 .. _kap-modul-mysqldb:
0a126d 2
8d081a 3 =============
JUH 4 Modul mysqldb
5 =============
0a126d 6
8d081a 7 Funktionen
JUH 8 ==========
0a126d 9
8d081a 10 .. option:: mysqldb.search
0a126d 11
8d081a 12    Suche Datenbank nach den im Befehlsausdruck angegebenen Feldern und Werten
JUH 13
14 .. option:: mysqldb.add
15
16    Füge eine neue Datenbank nach den im Befehlsausdruck angegebenen Feldern und Werten hinzu.
17
18 .. option:: mysqldb.update
19
20    Aktualisiere eine Datenbank nach den im Befehlsausdruck angegebenen Feldern und Werten.
21
22 .. option:: mysqldb.remove
23
24    Lösche eine Datenbank nach den im Befehlsausdruck angegebenen Feldern und Werten.
25    
26 Editierbare Felder
27 ==================
28
222551 29 Das HSAdmin-Modul ``mysqldb`` kann entsprechend der folgenden Befehlssyntax von :command:`HSAdmin` Felder setzen oder verändern::
8d081a 30
JUH 31    mysqldb.function({where:{field:'value',...}, set:{field:'value',...}})
32
33 Im Modul ``mysqldb`` stehen folgende Felder zur Verfügung.
34
35 name
36    Datenbankname (z.B. xyz00_abc)
37 owner
38    Datenbanknutzer (z.B. xyz00_owner)
39 encoding
40    Zeichensatz der Datenbank (Standard ist UTF-8)
41
42 Beispiele
43 =========
0a126d 44
e050b7 45 Im ersten Beispiel erzeugen wir eine Datenbank mit dem Namen ``xyz00_abc`` und legen als Besitzer den Datenbanknutzer ``xyz00_owner`` fest.
JUH 46
0a126d 47 .. code-block:: console
JUH 48
9f8db6 49     xyz00@hsadmin> mysqldb.add ({set:{name:'xyz00_abc',owner:'xyz00_owner'}})
e050b7 50
JUH 51 Bevor man Änderungen an einem Datensatz vornimmt, kann man sich alle Eigenschaften einer Datenbank mit dem Befehl :option:`mysqldb.search` anzeigen lassen.
52 Die gewünschte Datenbank wird mit dem Befehlsausdruck ``where`` ausgewählt.
53
54 .. code-block:: console
55
9f8db6 56     xyz00@hsadmin> mysqldb.search ({where:{name:'xyz00_abc'}})
e050b7 57
JUH 58 Und mit dem Befehl :option:`mysqldb.remove` können Datenbanken gelöscht werden.
59 Die gewünschte Datenbank wird erneut mit dem Befehlsausdruck ``where`` ausgewählt.
60
61 .. code-block:: console
62
9f8db6 63     xyz00@hsadmin> mysqldb.remove ({where:{name:'xyz00_abc'}})
8d081a 64