Neo4j 配置#
支持的 URI#
liquibase-neo4j 仅接受 JDBC 格式的 URI。
仅支持通过 Bolt 协议变体的连接。扩展不支持通过 HTTP 或嵌入式方式的连接。
- ✅
jdbc:neo4j:bolt://host:port被支持 - ✅
jdbc:neo4j:bolt+s://host:port被支持 - ✅
jdbc:neo4j:bolt+ssc://host:port被支持 - ✅
jdbc:neo4j:neo4j://host:port被支持 - ✅
jdbc:neo4j:neo4j+s://host:port被支持 - ✅
jdbc:neo4j:neo4j+ssc://host:port被支持 - ❌
jdbc:neo4j:http://host:port不受支持 - ❌
jdbc:neo4j:https://host:port不受支持 - ❌
jdbc:neo4j:file:///path/to/neo4j不受支持
了解每个 URI 方案的含义,请参阅 Neo4j 驱动手册。
JDBC 连接#
对于 4.18.0.1 及更早版本,Neo4j 扩展依赖于 第三方 JDBC 连接器。该连接器的配置参数可在 此链接 中找到。
从 4.19.0 版本开始,扩展定义了自己的内置 JDBC 连接器。
内置连接器更简单,易于理解,因为 Liquibase 只需要单次执行使用一个连接,并且依赖一组特定且有限的 JDBC API。
此新连接器与第三方连接器相比有一些关键差异。
内置连接器的序列化和反序列化逻辑更为严格。
警告
此问题 可能在尝试在扩展的最新版本中使用第三方连接器时出现。
由于它仅针对 Liquibase 使用进行定制,新的连接器未通过标准 JDBC 机制注册。
import java.sql.Connection;
import java.sql.DriverManager;
// [...]
Connection connection = DriverManager.getConnection("jdbc:neo4j:neo4j://", "neo4j", "<redacted>");
// this will not work! see below
如果需要访问 JDBC Connection 实例以编程方式配置 Liquibase,运行的代码如下
import liquibase.ext.neo4j.database.jdbc.Neo4jDriver;
import java.sql.Connection;
import java.sql.SQLException;
import java.util.Properties;
// [...]
Properties properties = new Properties();
properties.setProperty("user", "neo4j");
properties.setProperty("password", "<redacted>");
Connection connection = new Neo4jDriver().connect(
"jdbc:neo4j:neo4j://",
properties
);
spring.liquibase.driver-class-name=liquibase.ext.neo4j.database.jdbc.Neo4jDriver
spring.liquibase.url=jdbc:neo4j:bolt://
spring.liquibase.user=neo4j
spring.liquibase.password=<redacted>
import javax.sql.DataSource;
import liquibase.ext.neo4j.database.jdbc.Neo4jDriver;
import org.springframework.boot.autoconfigure.liquibase.LiquibaseDataSource;
import org.springframework.context.annotation.Bean;
import org.springframework.jdbc.datasource.SimpleDriverDataSource;
// [...]
@LiquibaseDataSource
@Bean
public DataSource liquibaseNeo4jDataSource() {
// SimpleDriverDataSource is a great fit for Liquibase
// since it does not need any connection pooling
// note: you can set properties instead of hardcoding credentials
SimpleDriverDataSource dataSource = new SimpleDriverDataSource(
new Neo4jDriver(),
"jdbc:neo4j:bolt://"
);
dataSource.setUsername("neo4j");
dataSource.setPassword("<redacted>");
return dataSource;
}
配置#
您可以通过配置以下任意设置,微调 JDBC 驱动或底层 Java Bolt 驱动的行为。
重要提示
第三方 JDBC 连接器支持的某些设置尚未实现。如果您恰好需要其中之一,请 提交 Issue 并描述在您情境下的需求原因。
| 设置 | 描述 | 允许的值 | URL? | 属性? | 备注 |
|---|---|---|---|---|---|
database |
设置数据库名称 | 任意有效的数据库名称 | 是 | 是 | 此设置仅在 Neo4j 4+ 服务器上可用 |
nossl |
禁用加密 | - [empty] - "true" |
是 | 是 | "false" 没有影响。 将此设置与 encryption 或不兼容的 URI 方案一起使用时行为未定义。请改用合适的 URL 方案( bolt 或 neo4j) |
encryption |
设置是否对流量进行加密 | - [empty] - "true" - "false" |
是 | 是 | 将此设置与 nossl 一同使用时行为未定义。请改用合适的 URL 方案。 |
trust.strategy |
配置底层 驱动 如何处理证书 | - "TRUST_ALL_CERTIFICATES" - "TRUST_CUSTOM_CA_SIGNED_CERTIFICATES" - "TRUST_SYSTEM_CA_SIGNED_CERTIFICATES" |
是 | 是 | "TRUST_CUSTOM_CA_SIGNED_CERTIFICATES" 需要设置 "trusted.certificate.file" |
trusted.certificate.file |
自定义证书文件名 | 有效路径 | 是 | 是 | 仅在与 "TRUST_CUSTOM_CA_SIGNED_CERTIFICATES" 信任策略组合时使用 |
connection.acquisition.timeout |
设置完整连接池获取连接的最大耗时 | 任意整数值 | 是 | 是 | 该值以毫秒为单位。 |
connection.liveness.check.timeout |
设置空闲连接在再次获取前进行存活性检查的阈值 | 任意整数值 | 是 | 是 | 该值以分钟为单位。 |
connection.timeout |
设置套接字连接超时 | 任意正整数值 | 是 | 是 | |
leaked.sessions.logging |
启用泄漏会话日志记录(即未正确关闭的会话,导致底层连接泄漏进而产生 OOM) | - [empty] - "true" |
是 | 是 | "false" 没有影响 |
max.connection.lifetime |
设置连接在达到此阈值后不再被获取 | 任意整数值 | 是 | 是 | 该值以毫秒为单位 |
max.connection.poolsize |
设置底层 驱动 连接池的最大大小 | 任意整数值 | 是 | 是 | 该扩展现在将驱动的默认池大小覆盖为 1(自 4.22.0.1 起) |
max.transaction.retry.time |
设置事务可以重试的最长时间 | 任意正整数值 | 是 | 是 | 该值以毫秒为单位。 该设置目前无效,因为专用的 JDBC 连接器不依赖事务函数 |
fetch.size |
设置每批获取的记录数 | -1 或任何严格正整数值 | 是 | 是 | 此设置仅在 Neo4j 4+ 服务器上可用 -1 会禁用批处理(并可能导致内存问题,请谨慎使用) |
impersonated.user |
设置要模拟的用户名 | 任意有效用户名 | 是 | 是 | 此设置仅在 Neo4j 4.4+ 服务器上可用 |
driver.logging.console.level |
根据名称或数值设置 java.util.logging.Level,并将驱动日志重定向到标准错误输出流 |
任意有效的级别名称或数值 | 是 | 是 | 此设置自 4.22.0.1 版本起可用 |
driver.logging.jul.level |
根据名称或数值设置内置 Java Util Logging 系统使用的 java.util.logging.Level |
任意有效的级别名称或数值 | 是 | 是 | 此设置自 4.22.0.1 版本起可用 |
driver.logging.slf4j |
将驱动日志记录设为 SLF4J | - [empty] - "true" |
是 | 是 | 此设置自 4.22.0.1 版本起可用 |
driver.logging.none |
禁用驱动日志记录 | - [empty] - "true" |
是 | 是 | 此设置自 4.22.0.1 版本起可用 |
重要提示
- 设置名称会被规范化为小写(基于英文地区的大小写规则)。
- 如果同一设置通过 URL 和属性两种方式表达,URL 中指定的设置具有更高优先级。
- 没有值的 URL 设置等同于布尔标志,其值为
true。