1 ;;;; -*- Mode: LISP; Syntax: ANSI-Common-Lisp; Base: 10 -*-
2 ;;;; *************************************************************************
4 ;;;; Generic postgresql layer, used by db-postgresql and db-postgresql-socket
6 ;;;; This file is part of CLSQL.
8 ;;;; CLSQL users are granted the rights to distribute and use this software
9 ;;;; as governed by the terms of the Lisp Lesser GNU Public License
10 ;;;; (http://opensource.franz.com/preamble.html), also known as the LLGPL.
11 ;;;; *************************************************************************
13 (in-package #:clsql-sys)
15 (defclass generic-postgresql-database (database)
16 ((has-table-pg_roles :type boolean :reader has-table-pg_roles :initform nil))
17 (:documentation "Encapsulate same behavior across postgresql and postgresql-socket backends."))
23 (defmethod database-get-type-specifier (type args database
24 (db-type (eql :postgresql)))
25 (declare (ignore type args database))
28 (defmethod database-get-type-specifier ((type (eql 'string)) args database
29 (db-type (eql :postgresql)))
30 (declare (ignore database))
32 (format nil "CHAR(~A)" (car args))
35 (defmethod database-get-type-specifier ((type (eql 'tinyint)) args database
36 (db-type (eql :postgresql)))
37 (declare (ignore args database))
40 (defmethod database-get-type-specifier ((type (eql 'smallint)) args database
41 (db-type (eql :postgresql)))
42 (declare (ignore args database))
45 (defmethod database-get-type-specifier ((type (eql 'wall-time)) args database
46 (db-type (eql :postgresql)))
47 (declare (ignore args database))
48 "TIMESTAMP WITHOUT TIME ZONE")
50 (defmethod database-get-type-specifier ((type (eql 'number)) args database
51 (db-type (eql :postgresql)))
52 (declare (ignore database))
54 ((and (consp args) (= (length args) 2))
55 (format nil "NUMERIC(~D,~D)" (first args) (second args)))
56 ((and (consp args) (= (length args) 1))
57 (format nil "NUMERIC(~D)" (first args)))
63 (defun owner-clause (owner)
68 " AND (relowner=(SELECT usesysid FROM pg_user WHERE (usename='~A')))"
71 (format nil " AND (relowner<>(SELECT usesysid FROM pg_user WHERE usename='postgres'))"))
74 (defun has-table (name database)
77 (format nil "SELECT relname FROM pg_class WHERE relname='~A'"
80 (if (and (stringp name-retrieved) (plusp (length name-retrieved)))
84 (defmethod slot-unbound (class (obj generic-postgresql-database)
85 (slot (eql 'has-table-pg_roles)))
86 ;; Lazily cache slot value
87 (declare (ignore class))
88 (setf (slot-value obj 'has-table-pg_roles) (has-table "pg_roles" obj)))
90 (defun database-list-objects-of-type (database type owner)
94 (if (and (has-table-pg_roles database)
95 (not (eq owner :all)))
98 FROM pg_catalog.pg_class c
99 LEFT JOIN pg_catalog.pg_roles r ON r.oid = c.relowner
100 LEFT JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace
101 WHERE c.relkind IN ('~A','')
102 AND n.nspname NOT IN ('pg_catalog', 'pg_toast')
103 AND pg_catalog.pg_table_is_visible(c.oid)
105 "SELECT relname FROM pg_class WHERE (relkind =
108 (owner-clause owner))
111 (defmethod database-list-tables ((database generic-postgresql-database)
113 (database-list-objects-of-type database "r" owner))
115 (defmethod database-list-views ((database generic-postgresql-database)
117 (database-list-objects-of-type database "v" owner))
119 (defmethod database-list-indexes ((database generic-postgresql-database)
121 (database-list-objects-of-type database "i" owner))
124 (defmethod database-list-table-indexes (table (database generic-postgresql-database)
130 "select indexrelid from pg_index where indrelid=(select relfilenode from pg_class where LOWER(relname)='~A'~A)"
131 (string-downcase (unescaped-database-identifier table))
132 (owner-clause owner))
135 (dolist (indexrelid indexrelids (nreverse result))
137 (caar (database-query
138 (format nil "select relname from pg_class where relfilenode='~A'"
143 (defmethod database-list-attributes ((table %database-identifier)
144 (database generic-postgresql-database)
146 (let* ((table (unescaped-database-identifier table))
148 (cond ((stringp owner)
149 (format nil " AND (relowner=(SELECT usesysid FROM pg_user WHERE usename='~A'))" owner))
150 ((null owner) " AND (not (relowner=1))")
155 (format nil "SELECT attname FROM pg_class,pg_attribute WHERE pg_class.oid=attrelid AND attisdropped = FALSE AND relname='~A'~A"
156 (string-downcase table)
160 (remove-if #'(lambda (it) (member it '("cmin"
166 ;; kmr -- added tableoid
167 "tableoid") :test #'equal))
170 (defmethod database-attribute-type ((attribute %database-identifier)
171 (table %database-identifier)
172 (database generic-postgresql-database)
174 &aux (table (unescaped-database-identifier table))
175 (attribute (unescaped-database-identifier attribute)))
176 (let ((row (car (database-query
177 (format nil "SELECT pg_type.typname,pg_attribute.attlen,pg_attribute.atttypmod,pg_attribute.attnotnull FROM pg_type,pg_class,pg_attribute WHERE pg_class.oid=pg_attribute.attrelid AND pg_class.relname='~A' AND pg_attribute.attname='~A' AND pg_attribute.atttypid=pg_type.oid~A"
178 (string-downcase table)
179 (string-downcase attribute)
180 (owner-clause owner))
183 (destructuring-bind (typname attlen atttypmod attnull) row
184 (setf attlen (%get-int attlen)
185 atttypmod (%get-int atttypmod))
186 (let ((coltype (ensure-keyword typname))
187 (colnull (typecase attnull
188 (string (if (string-equal "f" attnull) 1 0))
193 (setf (values collen colprec)
198 (values (ash (- atttypmod 4) -16)
199 (boole boole-and (- atttypmod 4) #xffff))))
202 (cond ((and (= -1 attlen) (= -1 atttypmod)) nil)
203 ((= -1 attlen) (- atttypmod 4))
206 (values coltype collen colprec colnull))))))
208 (defmethod database-create-sequence (sequence-name
209 (database generic-postgresql-database))
210 (let ((cmd (concatenate
211 'string "CREATE SEQUENCE " (escaped-database-identifier sequence-name database))))
212 (database-execute-command cmd database)))
214 (defmethod database-drop-sequence (sequence-name
215 (database generic-postgresql-database))
216 (database-execute-command
217 (concatenate 'string "DROP SEQUENCE " (escaped-database-identifier sequence-name database))
220 (defmethod database-list-sequences ((database generic-postgresql-database)
222 (database-list-objects-of-type database "S" owner))
224 (defmethod database-set-sequence-position (name (position integer)
225 (database generic-postgresql-database))
230 (format nil "SELECT SETVAL ('~A', ~A)" (escaped-database-identifier name) position)
231 database nil nil)))))
233 (defmethod database-sequence-next (sequence-name
234 (database generic-postgresql-database))
239 (concatenate 'string "SELECT NEXTVAL ('" (escaped-database-identifier sequence-name) "')")
240 database nil nil)))))
242 (defmethod database-sequence-last (sequence-name (database generic-postgresql-database))
247 (concatenate 'string "SELECT LAST_VALUE FROM " (escaped-database-identifier sequence-name))
248 database nil nil)))))
250 (defmethod auto-increment-sequence-name (table column (database generic-postgresql-database))
251 (let* ((sequence-name (or (database-identifier (slot-value column 'autoincrement-sequence))
252 (combine-database-identifiers
253 (list table column 'seq)
255 (when (search "'" (escaped-database-identifier sequence-name)
256 :test #'string-equal)
257 (signal-database-too-strange
258 "PG Sequence names shouldnt contain single quotes for the sake of sanity"))
261 (defmethod database-last-auto-increment-id ((database generic-postgresql-database) table column)
262 (let ((seq-name (auto-increment-sequence-name table column database)))
263 (first (clsql:query (format nil "SELECT currval ('~a')"
264 (escaped-database-identifier seq-name))
267 :result-types '(:int)))))
269 (defmethod database-generate-column-definition
270 (class slotdef (database generic-postgresql-database))
271 (when (member (view-class-slot-db-kind slotdef) '(:base :key))
273 (list (sql-expression :attribute (database-identifier slotdef database))
274 (specified-type slotdef)
275 (view-class-slot-db-type slotdef)))
276 (const (listify (view-class-slot-db-constraints slotdef)))
277 (seq (auto-increment-sequence-name class slotdef database)))
279 (setf const (remove :auto-increment const))
280 (unless (member :default const)
281 (let* ((next (format nil "nextval('~a')" (escaped-database-identifier seq))))
282 (setf const (append const (list :default next))))))
283 (append cdef const))))
285 (defmethod database-add-autoincrement-sequence
286 ((self standard-db-class) (database generic-postgresql-database))
287 (let ((ordered-slots (if (normalizedp self)
288 (ordered-class-direct-slots self)
289 (ordered-class-slots self))))
290 (dolist (slotdef ordered-slots)
292 ;; ensure that referenceed sequences actually exist before referencing them
293 (let ((sequence-name (auto-increment-sequence-name self slotdef database)))
294 (when (and sequence-name
295 (not (sequence-exists-p sequence-name :database database)))
296 (create-sequence sequence-name :database database))))))
298 (defmethod database-remove-autoincrement-sequence
299 ((table standard-db-class)
300 (database generic-postgresql-database))
302 (if (normalizedp table)
303 (ordered-class-direct-slots table)
304 (ordered-class-slots table))))
305 (dolist (slotdef ordered-slots)
306 ;; ensure that referenceed sequences are dropped with the table
307 (let ((sequence-name (auto-increment-sequence-name table slotdef database)))
308 (when sequence-name (drop-sequence sequence-name))))))
310 (defun postgresql-database-list (connection-spec type)
311 (destructuring-bind (host name &rest other-args) connection-spec
312 (declare (ignore name))
313 (let ((database (database-connect (list* host "template1" other-args)
317 (setf (slot-value database 'clsql-sys::state) :open)
318 (mapcar #'car (database-query "select datname from pg_database"
321 (database-disconnect database)
322 (setf (slot-value database 'clsql-sys::state) :closed))))))
324 (defmethod database-list (connection-spec (type (eql :postgresql)))
325 (postgresql-database-list connection-spec type))
327 (defmethod database-list (connection-spec (type (eql :postgresql-socket)))
328 (postgresql-database-list connection-spec type))
331 (defmethod database-describe-table ((database generic-postgresql-database) table)
332 ;; MTP: LIST-ATTRIBUTE-TYPES currently executes separate queries for
333 ;; each attribute. It would be more efficient to have a single SQL
334 ;; query return the type data for all attributes. This code is
335 ;; retained as an example of how to do this for PostgreSQL.
337 (format nil "select a.attname, t.typname
338 from pg_class c, pg_attribute a, pg_type t
339 where c.relname = '~a'
341 and a.attrelid = c.oid
342 and a.atttypid = t.oid"
343 (sql-escape (string-downcase table)))
346 ;;; Prepared statements
348 (defvar *next-prepared-id-num* 0)
349 (defun next-prepared-id ()
350 (let ((num (incf *next-prepared-id-num*)))
351 (format nil "CLSQL_PS_~D" num)))
353 (defclass postgresql-stmt ()
354 ((database :initarg :database :reader database)
355 (id :initarg :id :reader id)
356 (bindings :initarg :bindings :reader bindings)
357 (field-names :initarg :field-names :accessor stmt-field-names)
358 (result-types :initarg :result-types :reader result-types)))
360 (defun clsql-type->postgresql-type (type)
362 ((in type :int :integer) "INT4")
363 ((in type :short) "INT2")
364 ((in type :bigint) "INT8")
365 ((in type :float :double :number) "NUMERIC")
366 ((and (consp type) (in (car type) :char :varchar)) "VARCHAR")
368 (error 'sql-user-error
370 (format nil "Unknown clsql type ~A." type)))))
372 (defun prepared-sql-to-postgresql-sql (sql)
373 ;; FIXME: Convert #\? to "$n". Don't convert within strings
374 (declare (simple-string sql))
375 (with-output-to-string (out)
376 (do ((len (length sql))
381 (declare (fixnum len param pos))
382 (let ((c (schar sql pos)))
383 (declare (character c))
385 ((or (char= c #\") (char= c #\'))
386 (setq in-str (not in-str))
388 ((and (char= c #\?) (not in-str))
390 (write-string (write-to-string (incf param)) out))
392 (write-char c out)))))))
394 (defmethod database-prepare (sql-stmt types (database generic-postgresql-database) result-types field-names)
395 (let ((id (next-prepared-id)))
396 (database-execute-command
397 (format nil "PREPARE ~A (~{~A~^,~}) AS ~A"
399 (mapcar #'clsql-type->postgresql-type types)
400 (prepared-sql-to-postgresql-sql sql-stmt))
402 (make-instance 'postgresql-stmt
405 :result-types result-types
406 :field-names field-names
407 :bindings (make-list (length types)))))
409 (defmethod database-bind-parameter ((stmt postgresql-stmt) position value)
410 (setf (nth (1- position) (bindings stmt)) value))
412 (defun binding-to-param (binding)
415 (concatenate 'string "'" (sql-escape-quotes binding) "'"))
419 (defmethod database-run-prepared ((stmt postgresql-stmt))
420 (with-slots (database id bindings field-names result-types) stmt
421 (let ((query (format nil "EXECUTE ~A (~{~A~^,~})"
422 id (mapcar #'binding-to-param bindings))))
424 ((and field-names (not (consp field-names)))
425 (multiple-value-bind (res names)
426 (database-query query database result-types field-names)
427 (setf field-names names)
430 (values (nth-value 0 (database-query query database result-types nil))
433 (database-query query database result-types field-names))))))
437 (defmethod db-type-has-fancy-math? ((db-type (eql :postgresql)))
440 (defmethod db-type-default-case ((db-type (eql :postgresql)))
443 (defmethod db-type-has-prepared-stmt? ((db-type (eql :postgresql)))
446 (defmethod db-type-has-prepared-stmt? ((db-type (eql :postgresql-socket)))
449 (defmethod db-type-has-auto-increment? ((db-type (eql :postgresql)))