- 浏览: 243021 次
- 性别:
- 来自: ph
文章分类
最新评论
-
zrj_software:
说了等于没说,LZ能否把DLL代码给我研究下啊30729375 ...
如何在Delphi中调用.Net编写的DLL中的函数 -
reyesyang:
正在查找ruby单例模式相关资料,很有帮助,谢谢。
ruby中的单例模式 -
chaochao_pc:
您好,您的通讯工具能传输文件吗? 我在上边好像没找到!!! ...
Silverlight Socket 实现收发信息 -
huaxia524151:
谢谢,解决问题。return self.name.encode ...
Django笔记5(管理站点) -
yahon:
在flash中如何获取呢?
Flash+html--网页向FLASH传递参数
使用Ruby DBI模块
原著 Paul DuBois paul@kitebird.com
翻译:liubin 2004/11/9 http://www.ruby-cn.org/
原文地址:http://www.kitebird.com/articles/ruby-dbi.html
文档版本: 1.02
最后更新: 2003-05-27
目录
<!-- INSERT TOC HERE --> <!-- TOC BEGIN -->- 序论
- 准备
- 安装
- 一个简单的DBI脚本
- 处理查询
- 接受代码块的方法(Methods That Take Code Blocks)
- 再论连接数据库
- 错误处理和调试
- 事务处理支持
- 使用不同驱动特有的功能(Driver-Specific Capabilities)
- 一些有用的DBI模块和工具
- 资源
Ruby DBI模块为ruby程序访问数据库提供了一个与数据库无关的接口,就像perl的DBI模块一样。这篇文章将讲述如何编写基于DBI的ruby程序。这篇文章是对DBI规范文档(specification documents)的补充,而不是要替代规范文档,更多的信息请参见“资源”一节。
Ruby的DBI 模块架构分为两层:
- 数据库接口层(database interface DBI)。这层是与数据库无关的,它提供一些与你具体使用的数据库无关的通用的访问方法。。
- 数据库驱动层(database driver DBD)。这一层是与数据库相关的,不同的驱动用来访问不同的数据库。一个驱动用来访问mysql,另一个用来访问postgresql,每一个具体的数 据库都有不同的驱动。每个驱动解释DBI层传送的请求,并转换成对应于具体数据库的请求,发送到数据库。
本文的例子用到的数据库都是mysql的,但多数也可以适用其他数据库驱动。
准备
Ruby DBI模块包括了实现一般DBI的代码,和一些DBD层的驱动,很多这些驱动需要你安装额外的软件。比如,用于Mysql的驱动使用ruby写成,与ruby mysql模块绑定,而ruby mysql驱动是c语言写的,帮定了mysql 的c语言 客户端API。这就是说,你要是想用DBI访问MySql数据库,ruby mysql模块和C API这两者都需要安装。更多关于ruby mysql 模块的信息,参见“资源”一节。这里我们假定你已经安装了ruby mysql,并且可以用于DBI。
安装
一旦你满足了前面的条件,就可以安装Ruby DBI模块,可以从这里取得:
http://ruby-dbi.sourceforge.net/
DBI模块以压缩的tar格式发布,下载之后应该解压缩,比如,现在版本是0.0.19,如下即可解压缩:
% tar zxf ruby-dbi-all-0.0.19.tar.gz % gunzip < ruby-dbi-all-0.0.19.tar.gz | tar xf -
解压缩之后,进入软件包的顶层目录下,用setup.rb脚本进行配置。一般的配置命令都像这样,在config后面没有参数:
% ruby setup.rb config
这条命令设置了默认安装所有的驱动,更有效的办法是在刚才的config 后面加上--with参数,指定需要安装的部分。比如,为了配置只安装主DBI模块和MYSQL DBD 驱动,运行下面命令:
% ruby setup.rb config --with=dbi,dbd_mysql
配置完要安装的软件之后,就可以build和安装了:
% ruby setup.rb setup % ruby setup.rb install
运行install需要root权限。
本文的后面部分将使用下面的表示约定:
-
"DBI module" 指的是包括DBI层和DBD层都在内的集合,除非上下文说明了这层是独立于数据库。
- "DBD::Mysql " 指的是用于DBI的特定于MySQL的数据库驱动。
- "Ruby MySQL 模块" 指的是用于建造DBD::Mysql 的基础模块。
安装完ruby DBI模块之后,你就可以在你的Ruby程序中访问MYSQL数据库了。假设我们的数据库在本机运行,即localhost,数据库名为test,通过一 个用户名为testuser,密码是testpass的用户访问。我们可以用root登陆到mysql程序,然后执行下列命令建立这样的一个用户:
mysql> GRANT ALL ON test.* TO 'testuser'@'localhost' IDENTIFIED BY 'testpass';
如果test数据库不存在,用下面的命令创建它:
mysql> CREATE DATABASE test;
如果你想用不同的数据库,服务器,用户和密码的话,只需要将例子里对应的值换成你自己的就行了。
下面这个脚本, simple.rb , 是一个很短的DBI程序,它先连接的数据库,然后查询了数据库的版本,并显示出来,然后断开连接。你可以从“资源”里提供的链接下载这段代码,或者把它拷贝到文本编辑器中:
# simple.rb - simple MySQL script using Ruby DBI module require "dbi" begin # connect to the MySQL server dbh = DBI.connect("dbi:Mysql:test:localhost", "testuser", "testpass") # get server version string and display it row = dbh.select_one("SELECT VERSION()") puts "Server version: " + row[0] rescue DBI::DatabaseError => e puts "An error occurred" puts "Error code: #{e.err}" puts "Error message: #{e.errstr}" ensure # disconnect from server dbh.disconnect if dbh end
simple.rb 展现了DBI最基本的一些概念,下面的讨论将会讲述他是如何工作的,然后更后面还要讲述DBI的其他一些方面。
simple.rb 以一行require 开始,把DBI模块引入近来;没有这一行的话,DBI方法将会出错,后面的代码包括在一个 begin/rescue/ensure 结构中:
-
begin
部分处理了所有的数据库请求。
-
rescue
部分用来处理出错信息,它将获取出错信息,并显示出来。
-
ensure
块确保程序不管出错与否,最后都将关闭数据库连接。
方法connect 用来和数据库服务器建立一个连接,并返回这个连接。第一个参数是数据源名(data source name DSN),它指定了驱动名称(Mysql用于MySql服务器),默认得数据库名和服务器的机器名,第二、三个参数是用户和密码。还有其他的DSN写法, 将在后面“再论连接数据库”中说明。
simple.rb 用数据库句柄(database handle)调用方法select_one , 这个方法向服务器发送一个查询语句,并且将结果集的第一行作为数组返回给调用者。“SELECT VERSION() ”返回返回单个值,所以版本信息将存在row[0]中,这是这个数组的第一个也是唯一一个元素。运行这个程序,结果像这样:
% ruby simple.rb Server version: 4.0.13-log
如果出错,会导致抛出异常,异常可能各种各样,但多数都属于数据库错误,多为DatabaseError 异常,这种异常对象包括err和errstr属性,err是错误编号,errstr是错误消息。simple.rb得到这些异常的值并打印它们,但是忽略了其他的异常,这时候如果出现了其他异常,则将会抛给ruby执行环境。
simple.rb
用disconnect方法来断开与数据库的连接,这在ensure里执行,这样就使得不管出错与否,数据库连接都会被断开。
处理查询
Ruby DBI 提供了很多方法用来执行查询语句。这里将讨论这中间的一部分,但还有其他的。
多数的例子都用到了表people,它的结构如下:
CREATE TABLE people ( id INT UNSIGNED NOT NULL AUTO_INCREMENT, # ID number name CHAR(20) NOT NULL, # name height FLOAT, # height in inches PRIMARY KEY (id) );
如果一个语句不需要返回结果,可以用数据库句柄的do方法,这个方法的参数为要执行的sql语句,返回受影响的行数。下面的例子创建了表people,并插入了几条记录,都用了do方法:
dbh.do("DROP TABLE IF EXISTS people")
dbh.do("CREATE TABLE people (
id INT UNSIGNED NOT
NULL AUTO_INCREMENT,
PRIMARY KEY (id),
name CHAR(20) NOT
NULL,
height
FLOAT)")
rows = dbh.do("INSERT INTO people (name,height)
VALUES('Wanda',62.5),('Robert',75),('Phillip',71.5),('Sarah',68)")
printf "%d rows were inserted\n", rows
需要注意的是insert语句返回了一个值,即插入的行数,并把它打印了出来。
处理返回结果集的查询
像select和show这样的语句是要返回行记录的,处理这样的语句,要先向服务器提交查询,处理查询产生的每条记录,然后把结果集销毁。
一种办法是调用prepare产生一个statement 句柄,用这个句柄来执行查询,取回结果,然后释放结果集:
sth = dbh.prepare(statement ) sth.execute ... fetch rows ... sth.finish
或者直接把语句发送给数据库连接句柄去执行而不用调用prepare:
sth = dbh.execute(statement ) ... fetch rows ... sth.finish
同样也有很多方法从执行完的语句取得结果,可以在一个循环里调用fetch方法直到返回nil为止:
sth = dbh.execute("SELECT * FROM people") while row = sth.fetch do printf "ID: %d, Name: %s, Height: %.1f\n", row[0], row[1], row[2] end sth.finish
fetch 也可以用作一个 iterator来用, 也用each .方法。下面的两个是一样的作用:
sth = dbh.execute("SELECT * FROM people") sth.fetch do |row| printf "ID: %d, Name: %s, Height: %.1f\n", row[0], row[1], row[2] end sth.finish sth = dbh.execute("SELECT * FROM people") sth.each do |row| printf "ID: %d, Name: %s, Height: %.1f\n", row[0], row[1], row[2] end sth.finish
fetch 和each 都产生了 DBI::Row 对象, 这个对象提供了访问他们内容的方法:
-
可以用by_index
或 by_field
来通过顺序或者名字访问字段值:
val = row.by_index(2) val = row.by_field("height")
-
字段值也可以将row对象当成数组来取得:
val = row[2] val = row["height"]
-
迭代方法 each_with_name
生成每个字段名和它们的值:
sth = dbh.execute("SELECT * FROM people") sth.each do |row| row.each_with_name do |val, name| printf "%s: %s, ", name, val.to_s end print "\n" end sth.finish
-
DBI::Row
对象提供了一个方法 column_names
来得到一个包含每个字段名的数组。 field_names
是 column_names
的别名。
其他的返回行数据的方法包括fetch_array和fetch_hash,他们不返回DBI::Row 对象,而是将下一行数据作为数组或者哈希返回, 如果已经到结果集的最后的话,也会返回nil。fetch_hash返回哈希结构,由列名作为key,而列的值作为这个key对应的值。这两个方法可以独立使用,也可以在迭代中使用。下面例子用了hash方法:
sth = dbh.execute("SELECT * FROM people") while row = sth.fetch_hash do printf "ID: %d, Name: %s, Height: %.1f\n", row["id"], row["name"], row["height"] end sth.finish sth = dbh.execute("SELECT * FROM people") sth.fetch_hash do |row| printf "ID: %d, Name: %s, Height: %.1f\n", row["id"], row["name"], row["height"] end sth.finish
你也可以不用依照 “查询--取结果--完成”这种顺序来执行你的语句,数据库句柄可以一次取回所有的结果:
row = dbh.select_one(statement ) rows = dbh.select_all(statement )
select_one 执行一个查询,然后将结果的第一行作为一个数组返回,或者返回nil,如果没有匹配记录的话。select_all 返回一个 DBI::Row 的数组,(你可以用前面讨论过得方法访问里面的内容)。如果没有匹配结果,则返回空数组。注意不是nil。
MySQL
驱动会检查返回的结果集中的元数据(metadata),然后强制将这个字段的的值变为对应的Ruby类型(比如,从people取得的
id,name,height字段的值将会被转变为Fixnum,String和Float对象)。但是,如果一个列的值为NULL,则用nil来表示,
并且它的类型为NilClass。还有就是这不是DBI规格说明书的硬性规定,所以有的驱动可能不会做这样的工作。
引用,占位符(placeholder)和参数绑定
Ruby DBI提供了占位符机制,使得你可以不用在查询语句中把数据值的字面值写到里面,而是用一些特殊的符号标记数据的位置,当你真的要执行的时候,用真实的数 据值填充占位符的位置。DBI会用数据值替换占位符,完成对字符串等加引号,特殊字符的转义(如果需要的话)等,而不必你自己去做,而且占位符机制能很好 的处理NULL值,你只需要提供一个nil值,它会自动被换成NULL放到查询中。
下面例子解释了它是如何工作的。加入你想向people表里插入一条记录,这个人的名字叫Na'il,这个名字包括一个单引号,他的身高是76英寸。在查询语句中,用?来作为插入值的占位符,不需要引号括起来,然后将实际要插入的值作为do的参数,如下:
dbh.do("INSERT INTO people (id, name, height) VALUES(?, ?, ?)", nil, "Na'il", 76)
这条语句发送给数据库的语句像这样:
INSERT INTO people (id,name,height) VALUES(NULL,'Na\'il',76)
这更适合于你要多次执行一个查询,你可以先生成一个预处理语句语句,然后每次用数据值填充去执行。假如要导入的数据存在文本文件people.txt里 面,每一行了用tab分割,由name,height两列组成,下面的代码演示了如何从数据文件读取数据,然后执行insert语句将每一行插入数据库:
# prepare statement for use within insert loop sth = dbh.prepare("INSERT INTO people (id, name, height) VALUES(?, ?, ?)") # read each line from file, split into values, and insert into database f = File.open("people.txt", "r") f.each_line do |line| name, height = line.chomp.split("\t") sth.execute(nil, name, height) end f.close
生成一个预处理语句,然后在循环中多次执行它,比用循环来直接执行有效多了,主要是因为数据库能为预处理语句生成一个执行计划,以后每次执行都会用这个执行计划来执行,提高了效率。当然目前mysql还不支持这个功能,oracle支持。
如果想用占位符的方法执行select语句,你应该先考虑一下是否用预处理语句:
-
如果你用prepare
方法得到一个statement
句柄,用这个句柄执行查询,并提供数据值填充占位符:
sth = dbh.prepare("SELECT * FROM people WHERE name = ?") sth.execute("Na'il") sth.fetch do |row| printf "ID: %d, Name: %s, Height: %.1f\n", row[0], row[1], row[2] end sth.finish
-
如果你不用 prepare
那么execute方法的第一个参数就是要执行的语句,后面的参数是要填充用的数据值:
sth = dbh.execute("SELECT * FROM people WHERE name = ?", "Na'il") sth.fetch do |row| printf "ID: %d, Name: %s, Height: %.1f\n", row[0], row[1], row[2] end sth.finish
其它的驱动也许需要用不同的占位符,比如你可能需要写 :name 或 :n 来指明是按名称还是按位置来对应。
方法quote 能将一个值中的特殊字符处理、转义等,并返回这个结果。这适用于产生sql语句以供别的程序使用,比如,你想将上面的people.txt文件的内容转化为能在mysql命令行里执行的一组insert语句,只需要如下程序:
# read each line from file, split into values, and write INSERT statement f = File.open("people.txt", "r") f.each_line do |line| name, height = line.chomp.split("\t") printf "INSERT INTO people (id, name, height) VALUES(%s, %s, %s);\n", dbh.quote(nil), dbh.quote(name), dbh.quote(height) end f.close
对于不需要返回结果的语句,比如insert,delete等,do方法返回insert或者delete的行数。
对于返回结果的查询,比如select,你可以在execute方法之后用statement句柄取得返回的行和列的个数,以及各列的信息:
- 行数和列数不能直接得到,为了得到行数,你可以循环处理每一行的时候进行计数,或者将结果放到一个数据结构里,然后看看这个数据结构有多少个元素。要想得到返回的列的个数,你可以从sth.column_names.size 得到。
-
方法column_info
返回各列的详细信息。
下面例子说明了如何从一个查询得到metadata:
sth = dbh.execute(query) puts "Query: " + query if sth.column_names.size == 0 then puts "Query has no result set" printf "Number of rows affected: %d\n", sth.rows else puts "Query has a result set" rows = sth.fetch_all printf "Number of rows: %d\n", rows.size printf "Number of columns: %d\n", sth.column_names.size sth.column_info.each_with_index do |info, i| printf "--- Column %d (%s) ---\n", i, info.name printf "precision: %s\n", info.precision printf "scale: %s\n", info.scale end end sth.finish
注意:本文档的早期版本中说你可以从sth.rows得到返回的行数,现在已经不支持了。(尽管现在在mysql驱动中还可以用,但是你不应该在依赖这个函数了)
接受代码块的方法(Methods That Take Code Blocks)
一些能产生句柄的方法可以用来在block中调用,用这种方法时,它们将句柄作为参数提供给block,并且在块结束后自动销毁这些句柄。
-
DBI.connect
产生一个数据库句柄(database handle),在块结束后会(自动)调用disconnect。
- dbh.prepare 产生一个statement句柄(statement handle),在块结束后,会自动调用finish方法,在块内部,你必须调用execute方法来执行语句。
- dbh.execute 也和上面类似,但是你不需要在块内部调用execute方法,statement会自动执行。
下面的例子说明了上面的三个问题:
# connect can take a code block, passes the database handle to it, # and automatically disconnects the handle at the end of the block DBI.connect("dbi:Mysql:test:localhost", "testuser", "testpass") do |dbh| # prepare can take a code block, passes the statement handle # to it, and automatically calls finish at the end of the block dbh.prepare("SHOW DATABASES") do |sth| sth.execute puts "Databases: " + sth.fetch_all.join(", ") end # execute can take a code block, passes the statement handle # to it, and automatically calls finish at the end of the block dbh.execute("SHOW DATABASES") do |sth| puts "Databases: " + sth.fetch_all.join(", ") end end
此外还有一个 transaction
方法可以接收一个块,将在下面的“事务处理支持”中讨论。
再论连接数据库
前面讨论过的simple.rb 脚本用DBI 的connect方法连接数据库服务器:
dbh = DBI.connect("dbi:Mysql:test:localhost", "testuser", "testpass")
connect的第一个参数十DSN,它指明了要连接类型,后面的参数是用户名和密码。
DSN 可以是下面的任何格式的一种:
dbi:driver_name dbi:driver_name :db_name :host_name dbi:driver_name :key=val ;key=val ...
DSN总是以dbi或者DBI(而不能既有大写又有小写的字母)和驱动名称开头,对MySql来说,驱动名称是Mysql,对于其他的驱动,需要指定对应的正确的名字。
DSN中必须有dbi (或 DBI ) ,如果在驱动后面没有其他信息,那么驱动会尝试用默认得数据库和机器名连接数据库。而mysql要求必须指定数据库名,所以上面的第一种写法不能用于mysql,必须用其他的写法。第二种写法需要两个值,一个数据库名,一个机器名,两个值用冒号分开。第三种格式允许用 param =value 格式指定一系列的参数,参数之间用分号分割,比如,下面三种写法完全等同:
dbi:Mysql:test:localhost dbi:Mysql:host=localhost;database=test dbi:Mysql:database=test;host=localhost
在 DSN 语法中使用 param
=
value
格式比较灵活,各个参数的位置可以随意设置。而且可以设置一些针对不同驱动的特有的参数,就是说可以在它接收的参数方面进行扩展。比如Mysql,除了
host和database参数,还可以设置port,socket,flag等参数。(这些参数对应于ruby mysql
模块的real_connect方法中的各个参数,而DBD::Mysql也是基于这个Ruby Mysql模块的)
错误处理和调试
如果一个DBI方法是白了,将抛出一个异常。DBI方法可以抛出几种异常,但是和数据库相关的方法一般抛出DatabaseError异常,这种异常的对
象有三个属性,err,errstr和state。DBI的文档没有说这三个属性是什么意思,但是看起来它们分别表示错误编号,一个字符串型的错误描述和
一些“标准”的错误代码。目前MySQL驱动只支持errstr,但很容易用补丁使它也支持err属性。假定这两个属性都可用,那么下面方法说明了如何得
到这些值:
rescue DBI::DatabaseError => e puts "An error occurred" puts "Error code: #{e.err}" puts "Error message: #{e.errstr}"
为了得到你的语句执行时的调试信息,可以使用跟踪(tracing)。要想这样,首先你要载入dbi/trace模块:
require "dbi/trace"
模块 dbi/trace 默认没有包括在dbi模块中,因为这需要0.3.3以上版本的AspectR模块,这个模块可能在你的机器上并不存在。
dbi/trace
模块提供了一个trace方法,可以用来控制跟踪模式和输出目标:
trace(mode
, destination
)
mode 值为0(off),1,2,3,默认值为2; destination 是一个IO对象,默认为STDERR。
trace
可以作为一个类方法调用,这样随后创建的句柄都可以使用;或者作为一个单独的驱动,数据库,statement
句柄的对象方法,任何继承这些对象的子类都可以继承这些跟踪设置。比如,比如,你允许一个数据库句柄进行跟踪,从这个句柄创建的statement句柄也具备同样的跟踪设置。
事务处理支持
DBI提供了事务支持,但是怎样支持取决于你的底层数据库和DBD层数据库驱动的实现情况。比如Mysql驱动,在DBI
0.0.19之前都没有提供,所以你必须使用statement的自动提交功能来达到同样的目的,比如:
dbh.do("SET AUTOCOMMIT=0") dbh.do("BEGIN") ... statements that make up the transaction ... dbh.do("COMMIT")
对于 DBI 0.0.19 和更高版本,你可以使用mysql的事务控制,可以设置数据库句柄来设置是否自动提交:
dbh['AutoCommit'] = true dbh['AutoCommit'] = false
当自动提交被禁止之后,你有两种方法来实现事务控制。下面的例子说明了这两种方法,一个表account,要在两个人时间的基金转帐中实现事务性操作:
-
首先是用 DBI的 commit
和 rollback
方法显示的提交或者取消事务:
dbh['AutoCommit'] = false begin dbh.do("UPDATE account SET balance = balance - 50 WHERE name = 'bill'") dbh.do("UPDATE account SET balance = balance + 50 WHERE name = 'bob'") dbh.commit rescue puts "transaction failed" dbh.rollback end
-
第二种方法用了transaction方法,这种方法很简单,它接受了一个要求事务操作的处理块,transaction方法执行这个块,然后根据这个块执行结果是成功还是失败自动执行commit或者rollback。
dbh['AutoCommit'] = false dbh.transaction do |dbh| dbh.do("UPDATE account SET balance = balance - 50 WHERE name = 'bill'") dbh.do("UPDATE account SET balance = balance + 50 WHERE name = 'bob'") end
使用不同驱动特有的功能(Driver-Specific Capabilities)
DBI提供了一个func
方法,可以执行不同数据库驱动特有的功能,比如,mysql
C API提供了mysq_insert_id()方法,这个方法返回AUTO_INCREMENT
的最新值。Ruby Mysql模块提供了一个绑定到这个函数的函数:数据库句柄的insert_id
方法。这个方法是在DBD::Mysql中提供的,使得你可以通过DBI访问。
func 的第一个参数是你想执行的数据库特有的方法的名称,后面的参数是这个数据库特有方法的参数,如果没有参数,可以不填。insert_id没有参数,所以要想访问最新的AUTO_INCREMENT 值,可以这样:
dbh.do("INSERT INTO people (name,height) VALUES('Mike',70.5)") id = dbh.func(:insert_id) puts "ID for new record is: " + id.to_s
DBD::Mysql 提供的其它方法包括:
dbh.func(:createdb, db_name ) 创建数据库 dbh.func(:dropdb, db_name ) 删除数据库 dbh.func(:reload) 重新加载(reload) dbh.func(:shutdown) 关闭数据库
注意的是,只有你的mysql版本在4以上,创建数据库和删除数据库的功能才可以使用。
有些时候,使用数据库特有的方法能有特别的有点,即使按通常的其他方法也能达到同样的作用。比如,DBD::Mysql
的insert_id方法的功能和执行查询语句“SELECT
LAST_INSERT_ID()
”一样,都返回同一个值,但是insert_id更有效,因为它把这个值保存在了客户端,再次需要时不用重复执行查找。每次有新的插入之后,这个值都会改变,所以你必须重新得到这个AUTO_INCREMENT
值。与此相对,LAST_INSERT_ID()
的结果保存在服务器上,所以是持久稳固的,它不会因为别的查询语句执行而改变。
一些有用的DBI模块和工具
模块DBI::Utils
包含了其他一些有趣的方法(包括子模块中的方法):
-
DBI::Utils::measure
接受一个block,然后计算执行这个block需要多长时间:
elapsed = DBI::Utils::measure do dbh.do(query) end puts "Query: " + query puts "Elapsed time: " + elapsed.to_s
-
模块 DBI::Utils::TableFormatter
中的方法ascii
用来打印一个结果集(包括表头),第一个参数是一个包含列名的数组,第二个参数是一个row对象的数组。为了打印表people的内容,可以用如下代码:
sth = dbh.execute("SELECT * FROM people") rows = sth.fetch_all col_names = sth.column_names sth.finish DBI::Utils::TableFormatter.ascii(col_names, rows)
输出结果如下:+----+---------+--------+ | id | name | height | +----+---------+--------+ | 1 | Wanda | 62.5 | | 2 | Robert | 75.0 | | 3 | Phillip | 71.5 | | 4 | Sarah | 68.0 | +----+---------+--------+
-
模块DBI::Utils::XMLFormatter
包含row
和table
方法,用来用xml格式输出一行或者整个结果集的数据。这使得从数据库中生成xml文档变得方便简单,下面例子演示了table
方法:
DBI::Utils::XMLFormatter.table(dbh.select_all("SELECT * FROM people"))
输出结果如下:<?xml version="1.0" encoding="UTF-8" ?> <rows> <row> <id>1</id> <name>Wanda</name> <height>62.5</height> </row> <row> <id>2</id> <name>Robert</name> <height>75.0</height> </row> <row> <id>3</id> <name>Phillip</name> <height>71.5</height> </row> <row> <id>4</id> <name>Sarah</name> <height>68.0</height> </row> </rows>
方法 ascii
和table
支持更多的参数以提供对结果的更多控制和更多的格式和输出方式,可以参看这个模块的源代码获取更多信息。
资源
本文用到的脚本可以从下面的地址下载:
http://www.kitebird.com/articles/
那里你也可以找到另一篇文章 "使用 Ruby MySQL 模块" ,这篇文章讨论了作为DBD:Mysql的基础的Ruby Mysql模块。
你会发现下面这些额外资源对你很好的使用Ruby DBI很有帮助:
-
你可以从DBI sourceforge得到Ruby DBI模块和规范说明书:
http://ruby-dbi.sourceforge.net/
-
如果你想用dbi/trace
模块来使用DBI执行tracing的话,必须安装AspectR Ruby
模块 。 AspectR 可以在sourceforge得到:
http://aspectr.sourceforge.net/
-
Ruby主页,提供了关于ruby很全面的信息:
http://www.ruby-lang.org/
-
可以从这里得到mysql数据库:
http://www.mysql.com/
发表评论
-
ruby 连接操作 sql2005
2010-05-24 09:38 1087The following is improved versi ... -
Symbol对象
2009-08-07 10:19 769Symbol 对象用于表现 Ruby 解释器内的名字或 ... -
ruby中的单例模式
2009-08-05 16:00 1586Singleton 模块实现了单态模式 (Singleto ... -
ruby中的观察者模式
2009-08-05 15:56 959require 'observer' class TV ... -
区别Ruby的require,load,和include
2009-08-05 15:49 937三者之间区别并不像你想的那么难,也不会像有些文章写的那么长。挺 ... -
Object and Reflection
2009-08-05 15:34 721摘自: http://anw.stikipad.com/oc ... -
Blocks, Closures and Proc Objects
2009-08-05 15:18 752Ruby 的 block 是個不錯的設計. 一個 block ... -
Enumerable模块
2009-08-05 14:59 806可枚举模块。 Enumerable mixin 是含有几 ... -
Comparable模块
2009-08-05 12:20 1025Comparable mixin 由希望对它的对象进行排序的 ... -
Proc过程对象
2009-08-05 12:04 876就是所谓的过程对象。 Proc 对象是将一组局部变量绑定到 ... -
Method对象
2009-08-05 11:36 955Method 对象是由 Object#method(: ... -
Struct对象
2009-08-04 17:50 939结构体类 Struct 是将许多属性 (atribute ... -
Range对象
2009-08-04 16:29 931Range 对象表现为一个间隔,有开始与结束的值集。 Ra ... -
Ruby学习笔记
2009-08-04 16:27 12561、$variable 代表全局变量, @variable ... -
ruby惯用法
2009-08-04 15:27 843Ruby有不少惯用法,这里略作一些介绍,也方便阅读他人代码: ... -
Ruby哈希表
2009-08-04 14:51 2129哈希表的建立: ... -
Ruby中的数组过滤
2009-08-04 12:19 1078数组可以算是计算机编程中用到的最多的一个数据结构了,ruby中 ... -
Ruby数组操作总结
2009-08-04 11:50 3579数组的创建 arr = Array.new num #创 ...
相关推荐
每个驱动程序都是一个符合DBI接口规范的Ruby模块,实现了与特定数据库的通信。例如,如果你需要连接到MySQL数据库,你可以使用DBD::MySQL这个驱动。一旦驱动程序加载并连接到数据库,你就可以通过DBI提供的方法执行...
Ruby DBI(Database-agnostic Database Interface)是Ruby社区开发的一个模块,它提供了一个标准的API来连接和操作不同的数据库系统,如MySQL、PostgreSQL、SQLite等,使得开发者无需关心底层数据库的具体实现,可以...
RubyDBI提供了一个抽象层,使得开发者能够使用统一的API与不同的数据库系统(如JDBC或ODBC)进行交互,实现数据库无关性。这意味着你可以使用相同的Ruby代码来处理Oracle数据库,就像处理其他支持DBI的数据库一样。 ...
在Ruby编程语言中,连接和操作Oracle数据库通常需要利用Ruby的数据库接口模块Ruby/DBI以及Oracle调用接口(OCI8)库。由于没有纯Ruby的Oracle瘦驱动,开发人员必须借助于OCI8这个C语言编写的Ruby包装器,它实现了与...
这是一个基于Ruby/DBI(数据库接口模块)的数据库驱动程序,能够实现Ruby与Oracle数据库之间的交互。 - **Ruby DBI**:提供了一个与数据库无关的接口,类似于JDBC或ODBC,使得Ruby程序可以统一的方式访问各种数据库...
Ruby提供了多种方式来实现这一目标,其中包括使用Ruby的数据库接口(如DBI)以及特定于供应商的驱动程序,如`sybct`。 首先,`sybct.rb`和`sybct.so`文件是Ruby Sybase CT(Client Toolkit)驱动程序的一部分。`...
#### 二、使用`dbi`和`win32ole`模块连接SQL Server数据库 接下来,我们再来看一种使用`dbi`和`win32ole`的方式。 ##### 2.1 概述 除了直接使用`win32ole`外,还可以结合`dbi`(Database Interface)模块来实现更...
至于Ruby,它有多种方式连接MySQL,如直接使用MySQL C客户端API或通过DBI接口。Ruby的代码风格通常更加简洁,其`Mysql`模块提供了连接数据库的功能。在文件操作上,Ruby的`File`类提供了丰富的读写方法,如`read`和`...
- **数据库连接**: 使用DBI等库连接到数据库。 - **SQL查询**: 执行SQL查询操作。 #### 十一、标准库 - **字符串操作**: 提供了丰富的字符串处理方法,如搜索、替换、格式化等。 - **日期和时间**: 支持日期和时间...
`perl` 文件夹内可能包含Perl语言的DBI模块与SQLite结合的示例,Perl的DBI模块是数据库访问的通用接口,通过它我们可以学习如何在Perl中进行数据库操作。 最后,`python` 文件夹可能包含了Python的sqlite3模块示例...
Apache :: Authn :: Redmine ... 对不起,ruby用户,但是您需要一些perl模块,至少需要mod_perl2,DBI和DBD :: mysql(或者您数据库的DBD驱动程序,因为它应该在所有所有数据库上都可以工作)。 在debian /
5. **其他语言适配器**:MySQL API 也支持其他编程语言,如 Perl 的 DBI 模块,Ruby 的 ActiveRecord,Node.js 的 mysql2 库等,这些适配器都有各自的调用方式和特性,但核心都是围绕着 MySQL C API 来实现的。...
Perl支持多种数据库操作,常用的有DBI(Database Interface for Perl)模块,它提供了一个统一的接口来访问不同的数据库系统。 ##### 5.5 进程和IPC Perl支持进程间的通信(Interprocess Communication),包括...
尽管Perl在20世纪90年代和21世纪初非常流行,但随着Python和Ruby等现代语言的崛起,其使用率有所下降。然而,Perl仍然在某些领域,如系统管理和网络编程中占据重要地位,尤其是在生物信息学领域,Perl因其强大的文本...
使用Catalyst开发个人电子秘书应用,首先需要设置开发环境,包括安装Ruby和相关的依赖库,如DBI用于数据库接口,Template Toolkit用于视图渲染,或者Dancer2作为轻量级的替代视图选项。然后,开发者可以创建控制器来...