orientjs, 官方快速,轻量级 node.js 客户端 OrientDB

分享于 

8分钟阅读

GitHub

  繁體 雙語
The official fast, lightweight node.js client for OrientDB
  • 源代码名称:orientjs
  • 源代码网址:http://www.github.com/orientechnologies/orientjs
  • orientjs源代码文档
  • orientjs源代码下载
  • Git URL:
    git://www.github.com/orientechnologies/orientjs.git
    Git Clone代码到本地:
    git clone http://www.github.com/orientechnologies/orientjs
    Subversion代码到本地:
    $ svn co --depth empty http://www.github.com/orientechnologies/orientjs
    Checked out revision 1.
    $ cd repo
    $ svn up trunk
    
    OrientJS驱动程序

    用于 node.js的官方 orientdb 驱动程序。 快速,轻量级,使用二进制协议。

    Build StatusCoverage Statusnpm versionnpm downloads

    注意:版本v2.2使用本机C 驱动程序对封送的improvement很大改进。

    特性
    • 使用最新的OrientDB ( 2.1. x 和 2.2. x ) 测试。
    • 直观的API,基于蓝鸟承诺。
    • 快速二进制协议解析器。
    • 分布式支持
    • 通过同一套接字访问多个数据库。
    • 迁移支持。
    • 简单 CLI。
    • 连接池
    文档

    主题

    支持版本

    OrientJS的目标是使用OrientDB和更高版本的版本 2.0.0. 虽然它可能与早期版本一起使用,但目前不支持它们,欢迎请求请求

    重要: OrientJS目前不支持基于orientdb的RIDBag 特性,因为它依赖于额外的网络请求。 这意味着默认情况下,最多 119个边的比如 JSON.stringify(record)的结果与 120 + 边的记录非常不同。 这可能会导致非常令人惊讶的意外,在开发过程中可以能不会显示出来,但是在。 在中有一个打开的问题,直到得到修复为止,它将为你设置 strongly推荐RID_BAG_EMBEDDED_TO_SBTREEBONSAI_THRESHOLD 为一个非常大的值,比如 2147483647. 请参阅手册中有关的相关章节,以获得更多信息。

    安装

    通过npm安装。

    npm install orientjs

    要全局安装 OrientJS,请使用 -g 选项:

    npm install orientjs -g
    运行测试

    要运行测试套件,首先在 repo 中调用以下命令,安装开发依赖项:

    npm install

    然后运行测试:

    npm test

    ##CLI

    提供一个极它的简单的命令行 界面,以允许数据库创建和迁移以通过终端应用。

    为了有用,OrientJS需要一些参数来针对服务器进行身份验证。 除非用户配置了空密码,否则所有操作都需要 password 参数。 对于涉及特定数据库的操作,包括 dbname 参数( 如果 dbuserdbpassword 被设置为默认值以外的值)。

    你可以使用 orientjs --help 获得支持的参数列表。

     -d, --cwd The working directory to use.
     -h, --host The server hostname or IP address.
     -p, --port The server port.
     -u, --user The server username.
     -s, --password The server password.
     -n, --dbname The name of the database to use.
     -U, --dbuser The database username.
     -P, --dbpassword The database password.
     -?, --help Show the help screen.

    如果在每次输入这些选项时都太省时,也可以创建一个包含它们的orientjs.opts 文件。 OrientJS将在工作目录中搜索这个文件并应用它所包含的任何参数。 有关此类文件的示例,请参见 test/fixtures/orientjs.opts

    注意:为了简洁起见,所有这些示例都假定你已经全局安装了 OrientJS ( npm install -g orientjs ),并设置了一个带有服务器和数据库凭据的orientjs.opts 文件。

    数据库CLI命令。

    列出服务器上的所有数据库。
    orientjs db list
    创建一个新数据库
    orientjs db create mydb graph plocal
    正在销毁现有数据库
    orientjs db drop mydb

    迁移

    OrientJS支持简单的数据库迁移系统。 这使得在多个环境和分布式团队之间跟踪orientdb数据库结构的更改变得容易。

    运行迁移命令时,OrientJS首先查找一个名为 Migration的定向类。 如果该类不存在,将创建它。 这里类用于跟踪已经应用的迁移。

    然后OrientJS查找还没有应用到 migrations的文件夹中的迁移。 每个迁移都包含一个简单的node.js MODULE,它导出了两个方法- up()down()。 每个方法都将当前选定的数据库实例作为参数接收。

    up() 方法应该执行迁移,而 down() 方法应该撤销它。

    注意:迁移可能导致数据丢失 ! 请确保备份前备份数据库。

    除了下面列出的命令行 选项外,还可以通过编程方式使用迁移 API:

    var db =server.use('mydb');var manager =newOrientDB.Migration.Manager({
     db: db,
     dir:__dirname+'/migrations'});manager.up(1)
    .then(function () {
     console.log('migrated up by one!')
    });
    列出可用迁移

    列出所有未应用的迁移:

    orientjs migrate list
    创建新的迁移
    orientjs migrate create my new migration

    创建一个称为 m20140318_200948_my_new_migration的文件,你应该编辑它以指定向上和向下的方法。

    正在完全迁移

    要应用所有迁移:

    orientjs migrate up
    Migrating 1

    仅应用第一个迁移:

    orientjs migrate up 1
    完全迁移

    要恢复所有迁移:

    orientjs migrate down
    迁移到 1
    orientjs migrate down 1

    ##Troubleshooting

    • node 异常最大调用堆栈大小在这里超过

    历史

    In,Petrovay创建了原始的节点 orientdb 库,带有一个简单的基于回调API的API。

    在早期的2014年,Giraldo Rosales 为提供了一个全面的改进,包括支持 orientdb 1.7和转换为基于承诺的API。

    在 2014年以后,codemix重构了库,使它的易于扩展和维护,并引入了类似于 nano的API。 结果与原始代码库不同,它保证了它自己的NAME 和npm包。 这也给了我们一个 switch 语义版本控制的机会。

    在 2015年06月 中,定向技术公司正式采用Oriento驱动程序并将它的重命名为 OrientJS。

    提供给贡献者的注释

    请参见捐赠。

    更改

    请参见变更日志。

    许可证

    Apache 2.0许可证,请参阅许可证


    Light  fast  orientdb  
    相关文章