MiniSql一个简单，快速，安全的sql执行程序

MiniSql一个简单，快速，安全的sql执行程序

MiniSql

Installation

Add this line to your application's Gemfile:

gem 'mini_sql'

And then execute:

$ bundle

Or install it yourself as:

$ gem install mini_sql

Usage

MiniSql is a very simple, safe and fast SQL executor and mapper for PG.

pg_conn = PG.connect(db_name: 'my_db')conn = MiniSql::Connection.new(pg_conn)puts conn.exec('update table set column = 1 where id in (1,2)')# returns 2 if 2 rows changedconn.query("select 1 id, 'bob' name").each do |user| puts user.name # bob puts user.id # 1endp conn.query_single('select 1 union select 2')# [1,2]p conn.query_hash('select 1 as a, 2 as b union select 3, 4')# [{"a" => 1, "b"=> 1},{"a" => 3, "b" => 4}

The query builder

You can use the simple query builder interface to compose queries.

builder = conn.build("select * from topics /*where*/ /*limit*/")if look_for_something builder.where("title = :title", title: 'something')endbuilder.limit(20)builder.query.each do |t| puts t.id puts t.titleend

Is it fast?

Yes, it is very fast. See benchmarks in the bench directory.

As a rule it will outperform similar naive PG code while remaining safe.

pg_conn = PG.connect(db_name: 'my_db')# this is slower, and less saferesult = pg_conn.async_exec('select * from table')result.each do |r| name = r['name']end# ideally you want to remember to run r.clear here# this is faster and saferconn = MiniSql::Connection.new(pg_conn)r = conn.query('select * from table')r.each do |row| name = row.nameend

Safety

In current version of the PG gem you should be careful to clear results. If you do not you risk memory bloat. See: Sam's blog post.

MiniSql is careful to always clear results as soon as possible.

Development

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/SamSaffron/mini_sql. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the MiniSql project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。