【JanusGraph】第四章：配置

最新推荐文章于 2024-10-11 08:14:53 发布

原创最新推荐文章于 2024-10-11 08:14:53 发布 · 363 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#janusgraph

图数据库专栏收录该内容

14 篇文章

订阅专栏

本文介绍JanusGraph数据库的配置方法，包括存储后台、索引后台的选择，以及性能优化策略。阐述了如何通过配置文件或命令行参数启动JanusGraph实例，包括使用JanusGraphFactory和JanusGraphServer的不同场景。同时，详细解释了本地和全局配置的区别及如何修改配置参数。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

JanusGraph数据库集群通常包含一个或多个JanusGraph实例. 运行实例需要提供JanusGraph的配置参数.

JanusGraph配置中定义了JanusGraph要使用哪些组件, 控制部署各个操作, 提供一系列的动态调整的参数, 来获得集群的最大性能.

一般情况, JanusGraph配置必须提供存储后台. Part III, “Storage Backends” 列出了全部支持的存储后台, 如何配置参数. 如果需要支持图的高级检索(例如:全文检索, 地理位置检索, 和范围检索) 需要配置索引后台. Part IV, “Index Backends”. 如果性能是主要考虑方面, 需要打开缓存功能. 开启缓存和缓存的配置的详细内容在Chapter 11, JanusGraph Cache.

4.1 配置示例

以下示例展示了如何配置存储后台, 索引和性能组件. 这部分只是参数配置的一小部分. 完整的配置列表, 请查看 Chapter 13, Configuration Reference

4.1.1 Cassandra+Elasticsearch

使用Cassandra存储后台(本地的), 和ElasticSearch索引(远程的), 配置如下:

storage.backend=cassandra
storage.hostname=localhost

index.search.backend=elasticsearch
index.search.hostname=100.100.101.1, 100.100.101.2
index.search.elasticsearch.client-only=true

4.1.2 HBase+Caching

使用HBase存储后台(远程), 要获得更好的性能需要开启缓存

storage.backend=hbase
storage.hostname=100.100.101.1
storage.port=2181

cache.db-cache = true
cache.db-cache-clean-wait = 20
cache.db-cache-time = 180000
cache.db-cache-size = 0.5

4.1.3 BerkeleyDB

使用内嵌的BerkeleyDB存储后台, 内嵌的ElasticSearch索引

storage.backend=berkeleyje
storage.directory=/tmp/graph

index.search.backend=elasticsearch
index.search.directory=/tmp/searchindex
index.search.elasticsearch.client-only=false
index.search.elasticsearch.local-mode=true

Chapter 13, Configuration Reference 包含全部的配置信息. 配置文件中包含完整的配置示例.

4.1.4 更多配置

conf目录下有一些配置示例, 可以快速的开始练习. 把配置文件的路径传给JanusGraphFactory.open(…)方法

// Connect to Cassandra on localhost using a default configuration
graph = JanusGraphFactory.open("conf/janusgraph-cassandra.properties")
// Connect to HBase on localhost using a default configuration
graph = JanusGraphFactory.open("conf/janusgraph-hbase.properties")

4.2 使用配置

如何配置JanusGraph实例, 依赖于实例的运行模式.

4.2.1 JanusGraphFactory

4.2.1.1 Gremlin Console

JanusGraph中的Gremlin命令行工具可以方便的启动JanusGraph并和其交互. 执行bin/gremlin.sh(Unix/Linux系统)或者bin/gremlin.bat(Windows系统)来启动命令行, 随后用JanusGraphFactory工厂类读取某个配置文件, 新建graph对象

graph = JanusGraphFactory.open(‘path/to/configuration.properties’)

4.2.1.2 JanusGraph Embedded

基于JVM应用的内部, 也能用JanusGraphFactory创建实例, . 在这种情况下, JanusGraph属于应用的一部分, 应用可以直接调用它的接口

4.2.1.3 Short Codes

如果配置JanusGraph集群, 需要定义存储后台. JanusGraphFactory接受一个分号分割的字符串, 分号前是存储后台类型的名称, 分号后是主机名称或者是目录

graph = JanusGraphFactory.open('cassandra:localhost')

graph = JanusGraphFactory.open('berkeleyje:/tmp/graph')

4.2.2 JanusGraph Server

JanusGraph仅仅是一些jar文件, 不提供执行线程. 连接和使用JanusGraph数据库, 有两种方法:

客户端程序提供执行线程, 在客户端程序中调用JanusGraph
JanusGraph内置了可以长时间运行的程序, 当启动该程序, 允许远程客户端或者其他程序调用JanusGraph. 这个长时间运行的程序就是JanusGraph Server

JanusGraph Server使用Gremlin Server(Apache TinkerPop stack) 处理客户端的请求. JanusGraph提供开箱即用的配置, 能够JanusGraph Server快速启动, 这些配置可以被修改, 来调整服务器的性能.

配置JanusGraph Server需要通过./conf/gremlin-server目录下的yaml文件. JanusGraph Server配置如下:

...
graphs: {
  graph: conf/janusgraph-berkeleyje.properties
}
plugins:
  - janusgraph.imports
...

图的定义是在配置文件中提供的, 上边的例子中, 图的配置文件是conf/janusgraph-berkeleyje.properties. 插件启用了JanusGraph Gremlin插件, 这个插件能够自动导入JanusGraph的类, 远端提交的脚本可以参考这些类.

查看更多JanusGraph Server, 请看Chapter 7, JanusGraph Server

4.2.2.1 Server Distribution

JanusGraph zip文件中包含服务器组件, 可以让Gremlin和JanusGraph快速启动. 通过执行bin/janusgraph.sh 可以启动Gremlin Server和Cassandra和Elasticsearch.Note

由于安全原因 Elasticsearch and janusgraph.sh 必须使用非root账户运行

4.3 全局配置

JanusGraph分为本地和全局配置. 本地配置适用于单独的JanusGraph实例. 全局配置适用于集群中的全部实例. JanusGraph有以下5个范围的配置:

LOCAL 只适用于单独的JanusGraph实例, 而且需要在实例初始化时提供
MASKABLE 用本地配置文件启动的单独实例, MASKABLE参数可以被覆盖. 如果本地配置文件没有提供参数, 会读取全局集群的配置.
GLOBAL 从全局集群配置中读取, 而且不能被覆盖
GLOBAL_OFFLINE 与GLOBAL类似, 但修改这类参数, 需要启动集群, 确保集群中获得同一个值
FIXED 与GLOBAL类似, 但这些值不能被修改

当集群中第一个实例启动, 全局配置便被从本地文件初始化了. 可以通过系统提供的API来修改全局配置参数. 调用实例g.getManagementSystem()方法,可以访问管理API.例如, 修改一个集群默认的缓存行为

mgmt = graph.openManagement()
mgmt.get('cache.db-cache')
// Prints the current config setting
mgmt.set('cache.db-cache', true)
// Changes option
mgmt.get('cache.db-cache')
// Prints 'true'
mgmt.commit()
// Changes take effect

4.3.1 修改离线参数

修改配置参数不会影响运行着的实例, 只会对新启动的实例有作用. 修改GLOBAL_OFFLINE级别的配置, 需要重启集群, 让全部实例生效. 如下步骤:

集群仅留一个实例
连接到该实例上
确保全部业务都关闭
确保没有新的业务被启动
打开管理API
修改配置参数
调用commit方法, commit方法会自动将实例停止
重启全部实例

查看全部配置参数, 请跳到Chapter 13, Configuration Reference, 其中包括各个范围的参数