JanusGraph圖形數(shù)據(jù)庫集群由一個(gè)或多個(gè)JanusGraph實(shí)例組成搪花。 要打開JanusGraph實(shí)例,必須提供一個(gè)配置撮竿,該配置指定應(yīng)如何設(shè)置JanusGraph幢踏。
JanusGraph配置可以指定JanusGraph使用哪些組件,控制JanusGraph部署的所有可選內(nèi)容房蝉,并提供許多調(diào)整選項(xiàng)以使得JanusGraph集群達(dá)到最佳性能。
JanusGraph配置至少需要定義一個(gè)持久引擎搭幻,JanusGraph會(huì)將其用作存儲(chǔ)后端檀蹋。 存儲(chǔ)后端頁面列出了所有可支持的持久引擎以及如何分別配置它們。 如果需要高級(jí)圖形查詢支持(例如俯逾,全文搜索,地理位置信息搜索或范圍查詢)皇筛,則必須配置其他索引后端识脆。 有關(guān)詳細(xì)信息善已,請(qǐng)參見索引后端 如果需要考慮查詢性能离例,則應(yīng)啟用緩存。 緩存配置和調(diào)整在JanusGraph緩存中進(jìn)行了描述宫蛆。
配置的栗子??
以下是一些示例配置文件,以演示如何配置最常用的存儲(chǔ)后端想虎,索引系統(tǒng)和性能組件叛拷。這僅涵蓋了可用配置選項(xiàng)的一小部分。
參考 配置參考 以了解全部的可選項(xiàng)忿薇。
Cassandra+Elasticsearch
將JanusGraph設(shè)置為使用本地運(yùn)行的Cassandra持久引擎和遠(yuǎn)程ES索引系統(tǒng):
storage.backend=cql
storage.hostname=localhost
index.search.backend=elasticsearch
index.search.hostname=100.100.101.1, 100.100.101.2
index.search.elasticsearch.client-only=true
HBase+Caching
將JanusGraph設(shè)置為使用遠(yuǎn)程運(yùn)行的HBase持久引擎署浩,并使用JanusGraph的緩存組件以提高性能。
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
BerkeleyDB
將JanusGraph設(shè)置為用BerkeleyDB作為嵌入式持久性引擎筋栋,并將Elasticsearch用作嵌入式索引系統(tǒng)。
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
配置參考詳細(xì)描述了所有這些配置選項(xiàng)抢腐。 JanusGraph發(fā)行版的conf目錄包含其他配置示例肴颊。
更多示例
There are several example configuration files in the conf/
directory that can be used to get started with JanusGraph quickly. Paths to these files can be passed to JanusGraphFactory.open(...)
as shown below:
conf /
目錄中有幾個(gè)示例的配置文件,可使用他們快速開始JanusGraph授瘦。 這些文件的路徑可以配置到JanusGraphFactory.open(...)
竟宋,如下所示:
// 使用默認(rèn)的配置文件連接到本地 Cassandra
graph = JanusGraphFactory.open("conf/janusgraph-cql.properties")
// 使用默認(rèn)的配置文件連接到本地 HBase
graph = JanusGraphFactory.open("conf/janusgraph-hbase.properties")
使用配置
根據(jù)不同的實(shí)例化模式有幾種不同的方式用于配置JanusGraph。
JanusGraphFactory
Gremlin Console
JanusGraph發(fā)行版包含一個(gè)命令行工具Gremlin Console徒欣,可以用來與JanusGraph進(jìn)行交互蜗字,并且很容易上手脂新。 調(diào)用bin/gremlin.sh(Unix / Linux)或bin/gremlin.bat(Windows)來啟動(dòng)控制臺(tái)粗梭,然后使用存儲(chǔ)在可訪問的屬性配置文件中的默認(rèn)配置打開JanusGraph:
graph = JanusGraphFactory.open('path/to/configuration.properties')
JanusGraph Embedded
我們還可以在基于JVM的用戶應(yīng)用程序中通過調(diào)用JanusGraphFactory類來啟動(dòng)一個(gè)嵌入的JanusGraph圖實(shí)例断医。在這樣的情況下,JanusGraph是這個(gè)應(yīng)用程序的一部分鉴嗤,而且這個(gè)應(yīng)用程序可以通過公共API接口方便的調(diào)用JanusGraph。
Short Codes
如果先前已經(jīng)配置了JanusGraph圖集群和/或僅需要定義存儲(chǔ)后端兔簇,則JanusGraphFactory可以接收以冒號(hào)分隔的字符串表示形式荣挨,用來傳遞存儲(chǔ)后端名稱和主機(jī)名或目錄朴摊,如下所示。
graph = JanusGraphFactory.open('cql:localhost')
graph = JanusGraphFactory.open('berkeleyje:/tmp/graph')
JanusGraph Server
JanusGraph本身也可以認(rèn)為是一組沒有執(zhí)行線程的jar文件口锭。 有兩種連接和使用JanusGraph數(shù)據(jù)庫的基本模式:
一個(gè)程序的可執(zhí)行線程可以通過調(diào)用嵌入的JanusGraph方式來使用JanusGraph介杆。
JanusGraph打包了一個(gè)可長(zhǎng)期運(yùn)行的服務(wù)器進(jìn)程,啟動(dòng)該進(jìn)程后荆隘,它允許遠(yuǎn)程客戶端或運(yùn)行在單獨(dú)程序中的邏輯調(diào)用JanusGraph赴背。 這個(gè)長(zhǎng)期運(yùn)行的服務(wù)器進(jìn)程稱為** JanusGraph Server **。
JanusGraph Server 使用Apache TinkerPop 的 Gremlin Server 堆棧來處理客戶端請(qǐng)求凰荚。JanusGraph提供了開箱即用的配置,可快速啟動(dòng)JanusGraph Server缆毁,但可以更改配置以提供更多功能到涂。
通過位于JanusGraph發(fā)行版./conf/gremlin-server
目錄中的JanusGraph Server yaml配置文件來配置JanusGraph Server颁督。 要使用JanusGraph Server配置一個(gè)圖實(shí)例(JanusGraph`)浇雹,JanusGraph Server配置文件需要以下設(shè)置:
...
graphs: {
graph: conf/janusgraph-berkeleyje.properties
}
scriptEngines: {
gremlin-groovy: {
plugins: { org.janusgraph.graphdb.tinkerpop.plugin.JanusGraphGremlinPlugin: {},
org.apache.tinkerpop.gremlin.server.jsr223.GremlinServerGremlinPlugin: {},
org.apache.tinkerpop.gremlin.tinkergraph.jsr223.TinkerGraphGremlinPlugin: {},
org.apache.tinkerpop.gremlin.jsr223.ImportGremlinPlugin: {classImports: [java.lang.Math], methodImports: [java.lang.Math#*]},
org.apache.tinkerpop.gremlin.jsr223.ScriptFileGremlinPlugin: {files: [scripts/empty-sample.groovy]}}}}
...
graphs
這一個(gè)條目中定義了‘捆綁物bindings’來明確JanusGraph
的配置箫爷。在上面的栗子中,把 graph
綁定到了conf/janusgraph-berkeleyje.properties
這個(gè)配置文件上虎锚。plugins
這個(gè)條目啟用了JanusGraph Gremlin Plugin,這樣可以自動(dòng)導(dǎo)入JanusGraph類效斑,以便可以在遠(yuǎn)程提交的腳本中引用它們柱徙。
想了解更多關(guān)于JanusGraph Server 的配置和使用方法可參見 JanusGraph Server.
服務(wù)器分配
JanusGraph zip文件包含一個(gè)快速啟動(dòng)服務(wù)器組件,該組件有助于簡(jiǎn)化和快速啟動(dòng)Gremlin Server和JanusGraph敌完。 調(diào)用bin/janusgraph.sh start
來啟動(dòng)Gremlin Server,并使用Cassandra和Elasticsearch做后端羊初。
- 注意事項(xiàng)
為了安全起見, Elasticsearch 和 `janusgraph.sh` 應(yīng)該使用非root賬戶啟動(dòng)晦攒。
全局配置
JanusGraph的配置選項(xiàng)區(qū)分為本地配置選項(xiàng)和全局配置選項(xiàng)得哆。 本地配置選項(xiàng)適用于單個(gè)JanusGraph實(shí)例。 全局配置選項(xiàng)適用于集群中的所有實(shí)例贩据。 更具體地說,JanusGraph為配置選項(xiàng)區(qū)分了以下五個(gè)級(jí)別:
LOCAL: 這些選項(xiàng)僅適用于單個(gè)JanusGraph實(shí)例讼庇,并在初始化JanusGraph實(shí)例時(shí)提供的配置文件中指定近尚。
MASKABLE: 本地配置文件可以為單個(gè)JanusGraph實(shí)例覆蓋這些配置選項(xiàng)。 如果本地配置文件未指定該選項(xiàng)歼跟,則從全局JanusGraph群集配置中讀取其值。
GLOBAL: 這些選項(xiàng)始終從集群配置中讀取留瞳,不能基于實(shí)例進(jìn)行覆蓋骚秦。
GLOBAL_OFFLINE: 類似于 GLOBAL, 但是可以更改,更改這些選項(xiàng)需要重新啟動(dòng)群集作箍,以確保整個(gè)群集中的值相同。
- FIXED: 類似于 GLOBAL, 但是一旦JanusGraph集群初始化荧止,就無法更改該值阶剑。
當(dāng)?shù)谝粋€(gè)集群中的JanusGraph實(shí)例啟動(dòng)時(shí),將從提供的本地配置文件中初始化全局配置選項(xiàng)素邪。 隨后递宅,通過JanusGraph的管理API更改全局配置選項(xiàng)。 要訪問管理API办龄,請(qǐng)?jiān)诖蜷_的JanusGraph實(shí)例句柄g
上調(diào)用g.getManagementSystem()
俐填。 例如翔忽,要更改JanusGraph群集上的默認(rèn)緩存行為可以使用下面的栗子:
mgmt = graph.openManagement()
mgmt.get('cache.db-cache')
// Prints the current config setting 輸出當(dāng)前配置
mgmt.set('cache.db-cache', true)
// Changes option 修改配置
mgmt.get('cache.db-cache')
// Prints 'true'輸出
mgmt.commit()
// Changes take effect
修改離線配置
更改配置選項(xiàng)不會(huì)影響正在運(yùn)行的實(shí)例,僅會(huì)在新啟動(dòng)的實(shí)例上生效驶悟。 更改 GLOBAL_OFFLINE 配置選項(xiàng)需要重新啟動(dòng)群集材失,以便更改對(duì)所有實(shí)例立即生效。 要更改 GLOBAL_OFFLINE 選項(xiàng),請(qǐng)按照以下步驟操作:
- 只保留一個(gè)集群中的實(shí)例熊响,其他所有實(shí)例全部關(guān)掉
- 連接到該實(shí)例
- 確認(rèn)所有事務(wù)都已經(jīng)關(guān)閉
- 確認(rèn)不會(huì)有新的事務(wù)啟動(dòng) (i.e. 集群必須是下線模式)
- 啟動(dòng)管理API
- 修改配置選項(xiàng)
- 提交配置诗赌,該調(diào)用會(huì)自動(dòng)關(guān)閉實(shí)例
- 重啟全部實(shí)例
要了解全部配置詳情請(qǐng)參考 配置說明 包括配置選項(xiàng)和選項(xiàng)的配置范圍。