Module 基礎模塊

模塊db

數據庫訪問模塊

基礎模塊。可用於創建和操作數據庫資源,引用方式:

1 2
var db = require('db'); var conn = db.open('rng://user:pass@host:port/dbname');

通過指定數據庫引擎,可以建立不同的數據庫鏈接。fibjs 內置兩個sql 引擎:sqlite 和mysql,同時還支持通過ODBC/unixODBC 連接更多數據庫,基於ODBC/unixODBC,fibjs 構建了與mssql 和PostgreSQL 的驅動。為了使用ODBC/unixODBC,需要安裝對應的驅動,在posix 下使用mssql 需要安裝freetds,使用PostgreSQL 需要安裝psqlodbc。正常情況下驅動安裝成功即可直接使用,無需進一步配置。

靜態函數

open

打開一個數據庫,此方法為通用入口,根據提供的connString 不同調用不同的引擎

1
static object db.open(String connString) async;

調用參數:

  • connString: String, 數據庫描述,如:mysql://user:pass@host/db

返回結果:

  • object, 返回數據庫連接對象

openMySQL

打開一個mysql 數據庫

1
static MySQL db.openMySQL(String connString) async;

調用參數:

  • connString: String, 數據庫描述,如:mysql://user:pass@host/db

返回結果:

  • MySQL, 返回數據庫連接對象

openSQLite

打開一個sqlite 數據庫

1
static SQLite db.openSQLite(String connString) async;

調用參數:

  • connString: String, 數據庫描述,如:sqlite:test.db 或者test.db

返回結果:

  • SQLite, 返回數據庫連接對象

openOdbc

打開一個sqlite 數據庫

1
static DbConnection db.openOdbc(String connString) async;

調用參數:

  • connString: String, 數據庫描述,如:odbc://user:pass@host/db?driver=PostgreSQL%20ANSI

返回結果:


openMSSQL

打開一個mssql 數據庫

1
static DbConnection db.openMSSQL(String connString) async;

調用參數:

  • connString: String, 數據庫描述,如:mssql://user:pass@host/db

返回結果:

為了建立與mssql 的連接,在posix 下必須安裝freetds 的odbc 驅動,也可以通過指定驅動來使用微軟的mssql 驅動,指定驅動的方式,是在 url 後增加?driver=msodbcsql17[.so/.dylib] 的選項。


openPSQL

打開一個PostgresSQL 數據庫

1
static DbConnection db.openPSQL(String connString) async;

調用參數:

  • connString: String, 數據庫描述,如:psql://user:pass@host/db

返回結果:

為了建立與PostgresSQL 的連接,必須安裝PostgresSQL 的odbc 驅動。


openMongoDB

打開一個mongodb 數據庫

1
static MongoDB db.openMongoDB(String connString) async;

調用參數:

  • connString: String, 數據庫描述

返回結果:

  • MongoDB, 返回數據庫連接對象

openLevelDB

打開一個leveldb 數據庫

1
static LevelDB db.openLevelDB(String connString) async;

調用參數:

  • connString: String, 數據庫描述,如:level:test.db 或者test.db

返回結果:


openRedis

打開一個 Redis 數據庫

1
static Redis db.openRedis(String connString) async;

調用參數:

  • connString: String, 數據庫描述,如:redis://server:port 或者"server"

返回結果:

  • Redis, 返回數據庫連接對象