common-lisp
Praca z bazami danych

Proste użycie PostgreSQL z Postmodern

Postmodern to biblioteka do interfejsu relacyjnej bazy danych PostgreSQL . Oferuje kilka poziomów dostępu do PostgreSQL, od wykonywania zapytań SQL reprezentowanych jako łańcuchy lub listy, po mapowanie obiektowo-relacyjne.

Bazę danych użytą w poniższych przykładach można utworzyć za pomocą tych instrukcji SQL:

create table employees
  (empid integer not null primary key,
   name text not null,
   birthdate date not null,
   skills text[] not null);
insert into employees (empid, name, birthdate, skills) values
  (1, 'John Orange', '1991-07-26', '{C, Java}'),
  (2, 'Mary Red', '1989-04-14', '{C, Common Lisp, Hunchentoot}'),
  (3, 'Ron Blue', '1974-01-17', '{JavaScript, Common Lisp}'),
  (4, 'Lucy Green', '1968-02-02', '{Java, JavaScript}');

Pierwszy przykład pokazuje wynik prostego zapytania zwracającego relację:

CL-USER> (ql:quickload "postmodern")   ; load the system postmodern (nickname: pomo)
("postmodern")
CL-USER> (let ((parameters '("database" "dbuser" "dbpass" "localhost")))
           (pomo:with-connection parameters
             (pomo:query "select name, skills from employees")))
(("John Orange" #("C" "Java"))                  ; output manually edited!
 ("Mary Red" #("C" "Common Lisp" "Hunchentoot"))
 ("Ron Blue" #("JavaScript" "Common Lisp"))
 ("Lucy Green" #("Java" "JavaScript")))
4                                               ; the second value is the size of the result

Zauważ, że wynik może zostać zwrócony jako lista list lub list dodających opcjonalne parametry :alists list lub list :plists do funkcji zapytania.

Alternatywą dla query jest doquery , pozwalające na iterację wyników zapytania. Jego parametry to query (&rest names) &body body , przy czym nazwy są powiązane z wartościami w wierszu przy każdej iteracji:

CL-USER> (let ((parameters '("database" "dbuser" "dbpass" "localhost")))
           (pomo:with-connection parameters
             (format t "The employees that knows Java are:~%")
             (pomo:doquery "select empid, name from employees where skills @> '{Java}'" (i n)
               (format t "~a (id = ~a)~%" n i))))
The employees that knows Java are:
John Orange (id = 1)
Lucy Green (id = 4)
NIL
2

Gdy zapytanie wymaga parametrów, można użyć przygotowanych instrukcji:

CL-USER> (let ((parameters '("database" "dbuser" "dbpass" "localhost")))
           (pomo:with-connection parameters
             (funcall
               (pomo:prepare "select name, skills from employees where skills @> $1")
               #("Common Lisp"))))    ; find employees with skills including Common Lisp
(("Mary Red" #("C" "Common Lisp" "Hunchentoot"))
 ("Ron Blue" #("JavaScript" "Common Lisp")))
2

Funkcja prepare odbiera zapytanie z symbolami zastępczymi $1 , $2 itd. I zwraca nową funkcję, która wymaga jednego parametru dla każdego symbolu zastępczego i wykonuje zapytanie, gdy zostanie wywołana z odpowiednią liczbą argumentów.

W przypadku aktualizacji funkcja exec zwraca liczbę zmodyfikowanych krotek (dwie instrukcje DDL są zawarte w transakcji):

CL-USER> (let ((parameters '("database" "dbuser" "dbpass" "localhost")))
           (pomo:with-connection parameters
             (pomo:ensure-transaction
               (values
                 (pomo:execute "alter table employees add column salary integer")
                 (pomo:execute "update employees set salary =
                                     case when skills @> '{Common Lisp}'
                                     then 100000 else 50000 end")))))
0
4

Oprócz pisania zapytań SQL jako ciągów, można używać list słów kluczowych, symboli i stałych o składni przypominającej lisp (S-SQL):

CL-USER> (let ((parameters '("database" "dbuser" "dbpass" "localhost")))
           (pomo:with-connection parameters
             (pomo:query (:select 'name :from 'employees :where (:> 'salary 60000)))))
(("Mary Red") ("Ron Blue"))
2