Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/juvenn/honeysql-phoenix
Honesql extension for HBase Phoenix
https://github.com/juvenn/honeysql-phoenix
clojure hbase honeysql phoenix sql-query
Last synced: about 1 month ago
JSON representation
Honesql extension for HBase Phoenix
- Host: GitHub
- URL: https://github.com/juvenn/honeysql-phoenix
- Owner: juvenn
- License: epl-1.0
- Created: 2017-01-15T06:22:41.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-04-17T09:50:57.000Z (almost 7 years ago)
- Last Synced: 2024-10-11T17:14:37.767Z (3 months ago)
- Topics: clojure, hbase, honeysql, phoenix, sql-query
- Language: Clojure
- Size: 51.8 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: LICENSE
Awesome Lists containing this project
README
# Clojure SQL for HBase Phoenix
Clojure SQL for HBase [Phoenix](http://phoenix.apache.org). This
library extends [honeysql](https://github.com/jkk/honeysql) with
additional constructs to support Phoenix-specific queries, such as
upsert, dynamic columns, etc. It facilitates building SQL queries with
clojure data structure.
## Build
[](https://travis-ci.org/juvenn/honeysql-phoenix)
[](https://clojars.org/honeysql-phoenix)
## Getting started
Specify dependencies:
```clj
:dependencies [
[honeysql-phoenix "0.2.1"]
]
```
In addition to that, a (compatible) phoenix client
(e.g. `phoenix-{version}-client.jar`) should be added to classpath.
## Examples
```clj
(:require [phoenix.db :refer [defdb deftable phoenix] :as db]
[phoenix.honeysql :refer :all])
```
First of all, define db connection:
```clj
(defdb my-db
(phoenix {:zk-quorum "127.0.0.1,127.0.0.2:2181"}))
```
Then define table(s) with optional dynamic typed columns:
```clj
(deftable user
(db/db* my-db)
(db/table* :user)
;; define dynamic columns with its type
(db/types* :referrer "VARCHAR(64)"
:landing_url "VARCHAR(64)"))
```
To insert a row:
```clj
(-> (upsert-into user)
(values [{:username "jack" :email "[email protected]"
:referrer "google.com"}])
db/exec)
```
In place of `db/exec`, we could invoke `as-sql` to render it as sql
string:
```clj
(-> (upsert-into user)
(values [{:username "jack" :email "[email protected]"
:referrer "google.com"}])
as-sql)
["UPSERT INTO user (username, email, referrer VARCHAR(64)) VALUES (?, ?, ?)"
"jack" "[email protected]" "google.com"]
```
Note that `referrer` is type annotated.
To query rows:
```clj
(-> (select :username :email :referrer :landing_url)
(from user)
(where [:= :email "[email protected]"])
(limit 1)
as-sql)
;; manually formatted for ease of reading
["SELECT username, email, referrer, landing_url
FROM user (referrer VARCHAR(64), landing_url VARCHAR(64))
WHERE email = ? LIMIT ?"
"[email protected]" 1]
```
To delete rows:
```clj
(-> (delete-from user)
(where [:= :email "[email protected]"])
as-sql)
["DELETE FROM user WHERE email = ?"
"[email protected]"]
```
Atomic update:
```clj
(-> (upsert-into user)
(values [{:username "jack" :email "[email protected]"
:referrer "google.com"}])
(on-duplicate-key :ignore)
as-sql)
["UPSERT INTO user (username, email, referrer VARCHAR(64)) VALUES (?, ?, ?) ON DUPLICATE KEY IGNORE"
"jack" "[email protected]" "google.com"]
(-> (upsert-into user)
(values [{:username "jack" :email "[email protected]"
:referrer "google.com"}])
(on-duplicate-key {:referrer "google.com"})
as-sql)
["UPSERT INTO user (username, email, referrer VARCHAR(64)) VALUES (?, ?, ?)
ON DUPLICATE KEY UPDATE referrer = ?"
"jack" "[email protected]" "google.com" "google.com"]
```
For more examples, please refer to [honeysql](https://github.com/jkk/honeysql).
## License
Copyright © 2017, Juvenn Woo.
Distributed under the Eclipse Public License version 1.0.