records下载 - records源代码下载

records

Python

v2 Support

下载

记录：SQL for Humans™

Records 是一个非常简单但功能强大的库，用于对大多数关系数据库进行原始 SQL 查询。

写SQL就可以了。没有铃声，没有口哨。使用可用的标准工具来完成这项常见任务可能会非常困难。该库致力于使此工作流程尽可能简单，同时提供优雅的界面来处理查询结果。

数据库支持包括 RedShift、Postgres、MySQL、SQLite、Oracle 和 MS-SQL（不包括驱动程序）。

☤ 基础知识

我们知道如何编写 SQL，所以让我们将一些 SQL 发送到我们的数据库：

 import records

db = records . Database ( 'postgres://...' )
rows = db . query ( 'select * from active_users' )    # or db.query_file('sqls/active-users.sql')

一次抓取一行：

 > >> rows [ 0 ]
< Record { "username" : "model-t" , "active" : true , "name" : "Henry Ford" , "user_email" : "[email protected]" , "timezone" : "2016-02-06 22:28:23.894202" } >

或者迭代它们：

 for r in rows :
    print ( r . name , r . user_email )

可以通过多种方式访问值： row.user_email 、 row['user_email']或row[3] 。

还完全支持包含非字母数字字符（如空格）的字段。

或者存储您的记录收藏的副本以供以后参考：

 > >> rows . all ()
[ < Record { "username" : ...} > , < Record { "username" : ...} > , < Record { "username" : ...} > , ...]

如果您只期望一个结果：

 > >> rows . first ()
< Record { "username" : ...} >

其他选项包括rows.as_dict()和rows.as_dict(ordered=True) 。

☤ 特点

迭代的行被缓存以供将来参考。
$DATABASE_URL环境变量支持。
方便的Database.get_table_names方法。
用于导出查询的命令行记录工具。
安全参数化： Database.query('life=:everything', everything=42) 。
查询可以作为字符串或文件名传递，支持参数。
事务： t = Database.transaction(); t.commit() 。
批量操作： Database.bulk_query()和Database.bulk_query_file() 。

Records 自豪地由 SQLAlchemy 和 Tablib 提供支持。

☤ 数据导出功能

Records 还具有完整的 Tablib 集成功能，允许您使用一行代码将结果导出到 CSV、XLS、JSON、HTML 表、YAML 或 Pandas DataFrame。非常适合与朋友共享数据或生成报告。

>>> print (rows.dataset)
username|active|name      |user_email       |timezone
--------|------|----------|-----------------|--------------------------
model-t |True  |Henry Ford|[email protected]|2016-02-06 22:28:23.894202
...

逗号分隔值 (CSV)

>>> print (rows.export( ' csv ' ))
username,active,name,user_email,timezone
model-t,True,Henry Ford,[email protected],2016-02-06 22:28:23.894202
...

YAML 不是标记语言 (YAML)

 > >> print ( rows . export ( 'yaml' ))
- { active : true , name : Henry Ford , timezone : '2016-02-06 22:28:23.894202' , user_email : model - t @ gmail . com , username : model - t }
...

JavaScript 对象表示法 (JSON)

 > >> print ( rows . export ( 'json' ))
[{ "username" : "model-t" , "active" : true , "name" : "Henry Ford" , "user_email" : "[email protected]" , "timezone" : "2016-02-06 22:28:23.894202" }, ...]

Microsoft Excel（xls、xlsx）

 with open ( 'report.xls' , 'wb' ) as f :
    f . write ( rows . export ( 'xls' ))

熊猫数据框

 > >> rows . export ( 'df' )
    username  active       name        user_email                   timezone
0    model - t    True Henry Ford model - t @ gmail . com 2016 - 02 - 06 22 : 28 : 23.894202