Spring-Boot: Jak ustawić właściwości puli JDBC, takie jak maksymalna liczba połączeń?

Spring-Boot to całkiem niesamowite narzędzie, ale dokumentacja jest nieco skąpa, jeśli chodzi o bardziej zaawansowaną konfigurację. Jak ustawić właściwości, takie jak maksymalny rozmiar puli połączeń z bazą danych?

Wiosna-Boot podpory tomcat-jdbc, HikariCPa Commons DBCPnatywnie są one skonfigurowane w ten sam sposób?

Okazuje się, że ustawienie tych właściwości konfiguracyjnych jest dość proste, ale oficjalna dokumentacja jest bardziej ogólna, więc może być trudna do znalezienia podczas wyszukiwania informacji o konfiguracji puli połączeń.

Aby ustawić maksymalny rozmiar puli dla tomcat-jdbc, ustaw tę właściwość w pliku .properties lub .yml:

spring.datasource.maxActive=5

Jeśli wolisz, możesz również skorzystać z:

spring.datasource.max-active=5

W ten sposób możesz ustawić dowolną właściwość puli połączeń. Oto pełna lista właściwości obsługiwanych przeztomcat-jdbc .

Aby ogólnie zrozumieć, jak to działa, musisz trochę zagłębić się w kod Spring-Boot.

Spring-Boot konstruuje źródło danych w następujący sposób ( zobacz tutaj , wiersz 102):

@ConfigurationProperties(prefix = DataSourceAutoConfiguration.CONFIGURATION_PREFIX)
@Bean
public DataSource dataSource() {
    DataSourceBuilder factory = DataSourceBuilder
            .create(this.properties.getClassLoader())
            .driverClassName(this.properties.getDriverClassName())
            .url(this.properties.getUrl())
            .username(this.properties.getUsername())
            .password(this.properties.getPassword());
    return factory.build();
}

DataSourceBuilder jest odpowiedzialny za ustalenie, której biblioteki puli należy użyć, sprawdzając każdą z serii znanych klas w ścieżce klas. Następnie konstruuje DataSource i zwraca go do dataSource()funkcji.

W tym momencie pojawia się magia @ConfigurationProperties. Ta adnotacja mówi Springowi, aby szukał właściwości z przedrostkiem CONFIGURATION_PREFIX(którym jest spring.datasource). Dla każdej właściwości, która zaczyna się od tego prefiksu, Spring spróbuje wywołać metodę ustawiającą w DataSource z tą właściwością.

Tomcat DataSource jest rozszerzeniem DataSourceProxy , które ma tę metodę setMaxActive().

I w ten sposób twój spring.datasource.maxActive=5jest poprawnie stosowany!

A co z innymi pulami połączeń

Nie próbowałem, ale jeśli używasz jednej z innych pul połączeń obsługiwanych przez Spring-Boot (obecnie HikariCP lub Commons DBCP), powinieneś być w stanie ustawić właściwości w ten sam sposób, ale musisz spojrzeć na projekt dokumentację, aby wiedzieć, co jest dostępne.

W aktualnej wersji Spring-Boot (1.4.1.RELEASE) każda implementacja buforowania źródła danych ma swój własny prefiks właściwości.

Na przykład, jeśli używasz tomcat-jdbc:

spring.datasource.tomcat.max-wait=10000

Możesz znaleźć wyjaśnienie tutaj

spring.datasource.max-wait=10000

to już nie ma wpływu.

W spring boot 2.x musisz odwołać się do właściwości konkretnego dostawcy.

https://docs.spring.io/spring-boot/docs/current/reference/html/boot-features-sql.html#boot-features-connect-to-production-database

Domyślnie hikari można ustawić za pomocą spring.datasource.hikari.maximum-pool-size.

Różne pule połączeń mają różne konfiguracje.

Na przykład Tomcat (domyślnie) oczekuje:

spring.datasource.ourdb.url=...

a HikariCP będzie zadowolony z:

spring.datasource.ourdb.jdbc-url=...

Możemy zaspokoić oba bez konfiguracji standardowej:

spring.datasource.ourdb.jdbc-url=${spring.datasource.ourdb.url}

Brak właściwości do zdefiniowania dostawcy puli połączeń.

Spójrz na źródło DataSourceBuilder.java

Jeśli Tomcat, HikariCP lub Commons DBCP znajdują się na ścieżce klas, jeden z nich zostanie wybrany (w tej kolejności najpierw z Tomcat).

... więc możemy łatwo zastąpić dostawcę puli połączeń za pomocą tej konfiguracji maven (pom.xml):

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-jdbc</artifactId>
        <exclusions>
            <exclusion>
                <groupId>org.apache.tomcat</groupId>
                <artifactId>tomcat-jdbc</artifactId>
            </exclusion>
        </exclusions>
    </dependency>       

    <dependency>
        <groupId>com.zaxxer</groupId>
        <artifactId>HikariCP</artifactId>
    </dependency>

Na podstawie typu / rozmiaru / obciążenia / liczby aplikacji. użytkowników ... itd. - możesz śledzić swoje właściwości produkcyjne

spring.datasource.tomcat.initial-size=50
spring.datasource.tomcat.max-wait=20000
spring.datasource.tomcat.max-active=300
spring.datasource.tomcat.max-idle=150
spring.datasource.tomcat.min-idle=8
spring.datasource.tomcat.default-auto-commit=true