跳转到内容

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 方案(boltneo4j
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
© . This site is unofficial and not affiliated with Neo4j, Inc.