Ruby Operación Read de DBI

DBI proporciona diferentes métodos para obtener registros de la base de datos. Suponga quedbhes un manejador de base de datos,sthes un manejador de sentencia:

N.ºMétodo y descripción
1db.select_one( stmt, *bindvars ) => aRow | nil
Ejecuta conbindvarsenlazados antes de los marcadores de parámetrosstmtsentencia.nil。
2db.select_all( stmt, *bindvars ) => [aRow, ...] | nil

db.select_all( stmt, *bindvars ){ |aRow| aBlock }

Ejecuta conbindvarsenlazados antes de los marcadores de parámetrosstmtsentencia. Al llamar a este método sin bloque, devuelve un array que contiene todas las filas. Si se proporciona un bloque, se invocará este método para cada fila.
3sth.fetch => aRow | nil
Devuelvela siguiente fila. Si no hay una siguiente fila en el resultado, devuelvenil。
4sth.fetch { |aRow| aBlock }
Llama al bloque proporcionado para las filas restantes del conjunto de resultados.
5sth.fetch_all => [aRow, ...]
Devuelve todas las filas restantes del conjunto de resultados almacenadas en un array.
6sth.fetch_many( count ) => [aRow, ...]
Devuelve la fila almacenada en el array [aRow, ...]countfila.
7sth.fetch_scroll( direction, offset=1 ) => aRow | nil
Devuelvedirectionel parámetro yoffsetla fila especificada. Excepto SQL_FETCH_ABSOLUTE y SQL_FETCH_RELATIVE, los demás métodos descartan el parámetrooffset。directionLos valores posibles del parámetro se indican en la siguiente tabla.
8sth.column_names => anArray
Devuelve los nombres de las columnas.
9column_info => [ aColumnInfo, ... ]
Devuelve un array de objetos DBI::ColumnInfo. Cada objeto almacena información sobre una columna e incluye el nombre, tipo, precisión y más información de esa columna.
10sth.rows => rpc
Devuelve el número de filas procesadas por la sentencia ejecutadaCount, si no existe, devuelvenil。
11sth.fetchable? => true | false
Si es posible obtener filas, devuelvetrue, de lo contrario devuelvefalse。
12sth.cancel
Libera los recursos que ocupa el conjunto de resultados. Después de llamar a este método, ya no podrá obtener filas, a menos que vuelva a llamar aexecute。
13sth.finish
Libera los recursos que ocupa la sentencia preparada. Después de llamar a este método, no podrá llamar a otros métodos de operación adicionales en este objeto.

Parámetro direction

Los siguientes valores se pueden utilizar parafetch_scrollel parámetro direction del método:

ConstanteDescripción
DBI::SQL_FETCH_FIRSTObtiene la primera fila.
DBI::SQL_FETCH_LASTObtiene la última fila.
DBI::SQL_FETCH_NEXTObtiene la siguiente fila.
DBI::SQL_FETCH_PRIORObtiene la fila anterior.
DBI::SQL_FETCH_ABSOLUTEObtiene la fila en la posición de desplazamiento.
DBI::SQL_FETCH_RELATIVEObtiene la fila situada a ese desplazamiento de la fila actual.

Ejemplo

El siguiente ejemplo demuestra cómo obtener los metadatos de una sentencia. Supongamos que tenemos la tabla EMPLOYEE.

#!/usr/bin/ruby -w

require "dbi"

begin
     # 连接到 MySQL 服务器
     dbh = DBI.connect("DBI:Mysql:TESTDB:localhost", 
                        "testuser", "test123")
     sth = dbh.prepare("SELECT * FROM EMPLOYEE 
                        WHERE INCOME > ?")
     sth.execute(1000)
     if sth.column_names.size == 0 then
        puts "Statement has no result set"
        printf "Number of rows affected: %d\n", sth.rows
     else
        puts "Statement 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 "sql_type:         %s\n", info["sql_type"]
          printf "type_name:        %s\n", info["type_name"]
          printf "precision:        %s\n", info["precision"]
          printf "scale:            %s\n", info["scale"]
          printf "nullable:         %s\n", info["nullable"]
          printf "indexed:          %s\n", info["indexed"]
          printf "primary:          %s\n", info["primary"]
          printf "unique:           %s\n", info["unique"]
          printf "mysql_type:       %s\n", info["mysql_type"]
          printf "mysql_type_name:  %s\n", info["mysql_type_name"]
          printf "mysql_length:     %s\n", info["mysql_length"]
          printf "mysql_max_length: %s\n", info["mysql_max_length"]
          printf "mysql_flags:      %s\n", info["mysql_flags"]
      end
   end
   sth.finish
rescue DBI::DatabaseError => e
     puts "An error occurred"
     puts "Error code:    #{e.err}"
     puts "Error message: #{e.errstr}"
ensure
     # 断开与服务器的连接
     dbh.disconnect if dbh
end

Esto producirá el siguiente resultado:

Statement has a result set
Number of rows: 5
Number of columns: 5
--- Column 0 (FIRST_NAME) ---
sql_type:         12
type_name:        VARCHAR
precision:        20
scale:            0
nullable:         true
indexed:          false
primary:          false
unique:           false
mysql_type:       254
mysql_type_name:  VARCHAR
mysql_length:     20
mysql_max_length: 4
mysql_flags:      0
--- Column 1 (LAST_NAME) ---
sql_type:         12
type_name:        VARCHAR
precision:        20
scale:            0
nullable:         true
indexed:          false
primary:          false
unique:           false
mysql_type:       254
mysql_type_name:  VARCHAR
mysql_length:     20
mysql_max_length: 5
mysql_flags:      0
--- Column 2 (AGE) ---
sql_type:         4
type_name:        INTEGER
precision:        11
scale:            0
nullable:         true
indexed:          false
primary:          false
unique:           false
mysql_type:       3
mysql_type_name:  INT
mysql_length:     11
mysql_max_length: 2
mysql_flags:      32768
--- Column 3 (SEX) ---
sql_type:         12
type_name:        VARCHAR
precision:        1
scale:            0
nullable:         true
indexed:          false
primary:          false
unique:           false
mysql_type:       254
mysql_type_name:  VARCHAR
mysql_length:     1
mysql_max_length: 1
mysql_flags:      0
--- Column 4 (INCOME) ---
sql_type:         6
type_name:        FLOAT
precision:        12
scale:            31
nullable:         true
indexed:          false
primary:          false
unique:           false
mysql_type:       4
mysql_type_name:  FLOAT
mysql_length:     12
mysql_max_length: 4
mysql_flags:      32768
Otras extensiones