MongoDB クライアントの利用

前提条件

このガイドを完成させるには、以下が必要です:

約15分
IDE
JDK 11+ がインストールされ、 JAVA_HOME が適切に設定されていること
Apache Maven 3.8.1+
使用したい場合、 Quarkus CLI
ネイティブ実行可能ファイルをビルドしたい場合、MandrelまたはGraalVM（あるいはネイティブなコンテナビルドを使用する場合はDocker）をインストールし、適切に設定していること
MongoDBがインストールされているか、Dockerがインストールされている

アーキテクチャ

このガイドで構築されるアプリケーションは非常にシンプルです: ユーザーはフォームを使用してリストに要素を追加することができ、リストは更新されます。

ブラウザとサーバー間の情報はすべてJSON形式になっています。

要素はMongoDBに格納されています。

ソリューション

次の節で紹介する手順に沿って、ステップを踏んでアプリを作成することをお勧めします。ただし、完成した例にそのまま進んでも構いません。

Gitレポジトリをクローンするか git clone https://github.com/quarkusio/quarkus-quickstarts.git 、アーカイブをダウンロードします。

ソリューションは mongodb-quickstart ディレクトリにあります。

Mavenプロジェクトの作成

まず、新しいプロジェクトが必要です。以下のコマンドで新規プロジェクトを作成します。

CLI

quarkus create app org.acme:mongodb-quickstart \
    --extension=resteasy-reactive-jackson,mongodb-client \
    --no-code
cd mongodb-quickstart

Gradleプロジェクトを作成するには、 --gradle または --gradle-kotlin-dsl オプションを追加します。

Quarkus CLIのインストール方法については、Quarkus CLIガイドをご参照ください。

Maven

mvn io.quarkus.platform:quarkus-maven-plugin:2.11.1.Final:create \
    -DprojectGroupId=org.acme \
    -DprojectArtifactId=mongodb-quickstart \
    -Dextensions="resteasy-reactive-jackson,mongodb-client" \
    -DnoCode
cd mongodb-quickstart

Gradleプロジェクトを作成するには、 -DbuildTool=gradle または -DbuildTool=gradle-kotlin-dsl オプションを追加します。

このコマンドは、RESTEasy Reactive JacksonとMongoDB ClientエクステンションをインポートするMaven構造を生成します。その後、 quarkus-mongodb-client エクステンションがビルドファイルに追加されます。

すでにQuarkusプロジェクトが設定されている場合は、プロジェクトのベースディレクトリーで以下のコマンドを実行することで、プロジェクトに mongodb-client エクステンションを追加することができます。

CLI

quarkus extension add 'mongodb-client'

Maven

./mvnw quarkus:add-extension -Dextensions="mongodb-client"

Gradle

./gradlew addExtension --extensions="mongodb-client"

これにより、 pom.xml に以下が追加されます:

pom.xml

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-mongodb-client</artifactId>
</dependency>

build.gradle

implementation("io.quarkus:quarkus-mongodb-client")

初めてのJSON RESTサービスの作成

この例では、果物のリストを管理するアプリケーションを作成します。

まず、以下のように Fruit Bean を作成してみましょう。

package org.acme.mongodb;

import java.util.Objects;

public class Fruit {

    private String name;
    private String description;
    private String id;

    public Fruit() {
    }

    public Fruit(String name, String description) {
        this.name = name;
        this.description = description;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getDescription() {
        return description;
    }

    public void setDescription(String description) {
        this.description = description;
    }

    @Override
    public boolean equals(Object obj) {
        if (!(obj instanceof Fruit)) {
            return false;
        }

        Fruit other = (Fruit) obj;

        return Objects.equals(other.name, this.name);
    }

    @Override
    public int hashCode() {
        return Objects.hash(this.name);
    }

    public void setId(String id) {
        this.id = id;
    }

    public String getId() {
        return id;
    }
}

派手なことは何もありません。注意すべき重要なことは、デフォルトのコンストラクタを持つことはJSONシリアライズレイヤーで必須であるということです。

今、私たちのアプリケーションのビジネス層となる org.acme.mongodb.FruitService を作成し、mongoDB データベースからフルーツを保存/ロードします。

package org.acme.mongodb;

import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoCursor;
import org.bson.Document;

import javax.enterprise.context.ApplicationScoped;
import javax.inject.Inject;
import java.util.ArrayList;
import java.util.List;

@ApplicationScoped
public class FruitService {

    @Inject MongoClient mongoClient;

    public List<Fruit> list(){
        List<Fruit> list = new ArrayList<>();
        MongoCursor<Document> cursor = getCollection().find().iterator();

        try {
            while (cursor.hasNext()) {
                Document document = cursor.next();
                Fruit fruit = new Fruit();
                fruit.setName(document.getString("name"));
                fruit.setDescription(document.getString("description"));
                list.add(fruit);
            }
        } finally {
            cursor.close();
        }
        return list;
    }

    public void add(Fruit fruit){
        Document document = new Document()
                .append("name", fruit.getName())
                .append("description", fruit.getDescription());
        getCollection().insertOne(document);
    }

    private MongoCollection getCollection(){
        return mongoClient.getDatabase("fruit").getCollection("fruit");
    }
}

では、次のように org.acme.mongodb.FruitResource クラスを作成します。

@Path("/fruits")
public class FruitResource {

    @Inject FruitService fruitService;

    @GET
    public List<Fruit> list() {
        return fruitService.list();
    }

    @POST
    public List<Fruit> add(Fruit fruit) {
        fruitService.add(fruit);
        return list();
    }
}

The implementation is pretty straightforward, and you just need to define your endpoints using the JAX-RS annotations and use the FruitService to list/add new fruits.

MongoDBデータベースの設定

The main property to configure is the URL to access to MongoDB. Almost all configuration can be included in the connection URI, so we advise you to do so. You can find more information in the MongoDB documentation: https://docs.mongodb.com/manual/reference/connection-string/

設定のサンプルは以下のようになります。

# configure the mongoDB client for a replica set of two nodes
quarkus.mongodb.connection-string = mongodb://mongo1:27017,mongo2:27017

この例では、ローカルホスト上で実行されている単一のインスタンスを使用しています。

# configure the mongoDB client for a single instance on localhost
quarkus.mongodb.connection-string = mongodb://localhost:27017

その他の設定プロパティーが必要な場合は、このガイドの最後に完全なリストがあります。

By default, Quarkus will restrict the use of JNDI within an application, as a precaution to try and mitigate any future vulnerabilities similar to Log4Shell. Because the mongo+srv protocol often used to connect to MongoDB requires JNDI, this protection is automatically disabled when using the MongoDB client extension.

開発サービス（コンフィグレーション・フリー・データベース）

Quarkus supports a feature called Dev Services that allows you to create various datasources without any config. In the case of MongoDB this support extends to the default MongoDB connection. What that means practically, is that if you have not configured quarkus.mongodb.connection-string Quarkus will automatically start a MongoDB container when running tests or dev mode, and automatically configure the connection.

本番環境のアプリケーションを実行する場合、MongoDBの接続は通常通りに設定する必要があります。本番環境のデータベースの設定を application.properties に含めてDev Servicesを継続して使用する場合は、 %prod. プロファイルを使用してMongoDBの設定を定義することをお勧めします。

ビルド時に固定される設定プロパティ - それ以外の設定プロパティは実行時に上書き可能

Configuration property	タイプ	デフォルト
`quarkus.mongodb.devservices.enabled` If DevServices has been explicitly enabled or disabled. DevServices is generally enabled by default, unless there is an existing configuration present. When DevServices is enabled Quarkus will attempt to automatically configure and start a database when running in Dev or Test mode. Environment variable: `QUARKUS_MONGODB_DEVSERVICES_ENABLED`	boolean
`quarkus.mongodb.devservices.image-name` The container image name to use, for container based DevServices providers. Environment variable: `QUARKUS_MONGODB_DEVSERVICES_IMAGE_NAME`	string
`quarkus.mongodb.devservices.port` Optional fixed port the dev service will listen to. If not defined, the port will be chosen randomly. Environment variable: `QUARKUS_MONGODB_DEVSERVICES_PORT`	int
`quarkus.mongodb.devservices.properties` Generic properties that are added to the connection URL. Environment variable: `QUARKUS_MONGODB_DEVSERVICES_PROPERTIES`	`Map<String,String>`

Configuration property

タイプ

デフォルト

quarkus.mongodb.devservices.enabled

If DevServices has been explicitly enabled or disabled. DevServices is generally enabled by default, unless there is an existing configuration present. When DevServices is enabled Quarkus will attempt to automatically configure and start a database when running in Dev or Test mode.

Environment variable: QUARKUS_MONGODB_DEVSERVICES_ENABLED

boolean

quarkus.mongodb.devservices.image-name

The container image name to use, for container based DevServices providers.

Environment variable: QUARKUS_MONGODB_DEVSERVICES_IMAGE_NAME

string

quarkus.mongodb.devservices.port

Optional fixed port the dev service will listen to. If not defined, the port will be chosen randomly.

Environment variable: QUARKUS_MONGODB_DEVSERVICES_PORT

int

quarkus.mongodb.devservices.properties

Generic properties that are added to the connection URL.

Environment variable: QUARKUS_MONGODB_DEVSERVICES_PROPERTIES

Map<String,String>

複数のMongoDBクライアント

MongoDBでは、複数のクライアントを設定することができます。複数のクライアントを使っても、単一のクライアントを持つのと同じように動作します。

quarkus.mongodb.connection-string = mongodb://login:pass@mongo1:27017/database

quarkus.mongodb.users.connection-string = mongodb://mongo2:27017/userdb
quarkus.mongodb.inventory.connection-string = mongodb://mongo3:27017/invdb,mongo4:27017/invdb

キーに余分なビットがあることに注意してください ( users と inventory のセグメント)。構文は以下の通りです。 quarkus.mongodb.[optional name.][mongo connection property] .名前を省略すると、デフォルトのクライアントを設定します。

The use of multiple MongoDB clients enables multi-tenancy for MongoDB by allowing to connect to multiple MongoDB clusters. + If you want to connect to multiple databases inside the same cluster, multiple clients are not necessary as a single client is able to access all databases in the same cluster (as a JDBC connection is able to access to multiple schemas inside the same database).

名前付きMongoクライアントの注入

複数のクライアントを使用する場合、各 MongoClient は、 io.quarkus.mongodb.MongoClientName の修飾子を使用して注入するクライアントを選択できます。上記のプロパティーを使用して、以下のように3つの異なるクライアントを設定し、それぞれに注入することもできます。

@Inject
MongoClient defaultMongoClient;

@Inject
@MongoClientName("users")
MongoClient mongoClient1;

@Inject
@MongoClientName("inventory")
ReactiveMongoClient mongoClient2;

MongoDB データベースの実行

デフォルトでは、 MongoClient はポート 27017 (デフォルトの MongoDB ポート) でローカルの MongoDB データベースにアクセスするように設定されています。このポートで実行されているローカルのデータベースがある場合は、他に何もする必要はありません!

Dockerを使ってMongoDBデータベースを起動したい場合は、以下のコマンドで起動することができます。

docker run -ti --rm -p 27017:27017 mongo:4.0

Dev Servicesを使用している場合は、手動でコンテナを起動する必要はありません。

フロントエンドの作成

ここで、 FruitResource と対話するための簡単なウェブページを追加してみましょう。Quarkusは、 META-INF/resources ディレクトリーの下にある静的なリソースを自動的に提供します。 src/main/resources/META-INF/resources ディレクトリーに、この fruits.htmlファイルの内容を含む fruits.html ファイルを追加します。

これで、REST サービスと対話できるようになりました。

Quarkusを起動します。

CLI

quarkus dev

Maven

./mvnw quarkus:dev

Gradle

./gradlew --console=plain quarkusDev

http://localhost:8080/fruits.html をブラウザで開く
フォームを使って新しいフルーツをリストに追加します。 :!devtools-wrapped:

リアクティブな MongoDB クライアント

リアクティブなMongoDBクライアントがQuarkusに含まれています。これを使うのは、古典的なMongoDBクライアントを使うのと同じくらい簡単です。先ほどの例を以下のように書き換えて使うことができます。

非推奨

io.quarkus.mongodb.ReactiveMongoClient クライアントは非推奨であり、将来的には削除される予定です。 Mutiny API を提供する io.quarkus.mongodb.reactive.ReactiveMongoClient クライアントに切り替えることをお勧めします。

Mutiny

MongoDBのリアクティブ・クライアントは、Mutinyのリアクティブ・タイプを使用しています。Mutinyに慣れていない方は、 Mutiny - an intuitive reactive programming libraryをご覧ください。

package org.acme.mongodb;

import io.quarkus.mongodb.reactive.ReactiveMongoClient;
import io.quarkus.mongodb.reactive.ReactiveMongoCollection;
import io.smallrye.mutiny.Uni;
import org.bson.Document;

import javax.enterprise.context.ApplicationScoped;
import javax.inject.Inject;
import java.util.List;

@ApplicationScoped
public class ReactiveFruitService {

    @Inject
    ReactiveMongoClient mongoClient;

    public Uni<List<Fruit>> list() {
        return getCollection().find()
                .map(doc -> {
                    Fruit fruit = new Fruit();
                    fruit.setName(doc.getString("name"));
                    fruit.setDescription(doc.getString("description"));
                    return fruit;
                }).collect().asList();
    }

    public Uni<Void> add(Fruit fruit) {
        Document document = new Document()
                .append("name", fruit.getName())
                .append("description", fruit.getDescription());
        return getCollection().insertOne(document)
                .onItem().ignore().andContinueWithNull();
    }

    private ReactiveMongoCollection<Document> getCollection() {
        return mongoClient.getDatabase("fruit").getCollection("fruit");
    }
}

package org.acme.mongodb;

import io.smallrye.mutiny.Uni;

import java.util.List;

import javax.inject.Inject;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.Consumes;
import javax.ws.rs.GET;
import javax.ws.rs.POST;
import javax.ws.rs.core.MediaType;

@Path("/reactive_fruits")
@Produces(MediaType.APPLICATION_JSON)
@Consumes(MediaType.APPLICATION_JSON)
public class ReactiveFruitResource {

    @Inject
    ReactiveFruitService fruitService;

    @GET
    public Uni<List<Fruit>> list() {
        return fruitService.list();
    }

    @POST
    public Uni<List<Fruit>> add(Fruit fruit) {
        return fruitService.add(fruit)
                .onItem().ignore().andSwitchTo(this::list);
    }
}

BSONコーデックを使ってMongoDBクライアントの利用をシンプルにする

Bson Codec を使用することで、MongoDB クライアントは自動的に MongoDB Document への/からのドメインオブジェクトの変換の世話をします。

まず、Bson Codec を作成する必要があります。これは、エンティティーを MongoDB Document に変換する方法を Bson に伝えます。ここでは CollectibleCodec を使用しています。私たちのオブジェクトはデータベースから取得可能なので (MongoDB の識別子を持っています)、そうでなければ Codec を使用します。詳細はコーデックのドキュメントを参照ください: https://mongodb.github.io/mongo-java-driver/3.10/bson/codecs 。

package org.acme.mongodb.codec;

import com.mongodb.MongoClientSettings;
import org.acme.mongodb.Fruit;
import org.bson.Document;
import org.bson.BsonWriter;
import org.bson.BsonValue;
import org.bson.BsonReader;
import org.bson.BsonString;
import org.bson.codecs.Codec;
import org.bson.codecs.CollectibleCodec;
import org.bson.codecs.DecoderContext;
import org.bson.codecs.EncoderContext;

import java.util.UUID;

public class FruitCodec implements CollectibleCodec<Fruit> {

    private final Codec<Document> documentCodec;

    public FruitCodec() {
        this.documentCodec = MongoClientSettings.getDefaultCodecRegistry().get(Document.class);
    }

    @Override
    public void encode(BsonWriter writer, Fruit fruit, EncoderContext encoderContext) {
        Document doc = new Document();
        doc.put("name", fruit.getName());
        doc.put("description", fruit.getDescription());
        documentCodec.encode(writer, doc, encoderContext);
    }

    @Override
    public Class<Fruit> getEncoderClass() {
        return Fruit.class;
    }

    @Override
    public Fruit generateIdIfAbsentFromDocument(Fruit document) {
        if (!documentHasId(document)) {
            document.setId(UUID.randomUUID().toString());
        }
        return document;
    }

    @Override
    public boolean documentHasId(Fruit document) {
        return document.getId() != null;
    }

    @Override
    public BsonValue getDocumentId(Fruit document) {
        return new BsonString(document.getId());
    }

    @Override
    public Fruit decode(BsonReader reader, DecoderContext decoderContext) {
        Document document = documentCodec.decode(reader, decoderContext);
        Fruit fruit = new Fruit();
        if (document.getString("id") != null) {
            fruit.setId(document.getString("id"));
        }
        fruit.setName(document.getString("name"));
        fruit.setDescription(document.getString("description"));
        return fruit;
    }
}

そして、この Codec を Fruit クラスにリンクさせるための CodecProvider を作成する必要があります。

package org.acme.mongodb.codec;

import org.acme.mongodb.Fruit;
import org.bson.codecs.Codec;
import org.bson.codecs.configuration.CodecProvider;
import org.bson.codecs.configuration.CodecRegistry;

public class FruitCodecProvider implements CodecProvider {
    @Override
    public <T> Codec<T> get(Class<T> clazz, CodecRegistry registry) {
        if (clazz.equals(Fruit.class)) {
            return (Codec<T>) new FruitCodec();
        }
        return null;
    }

}

Quarkusは、 CodecProvider を @Singleton スコープのCDIビーンとして登録する作業を行います。

最後に、データベースから MongoCollection を取得するとき、 Document の代わりに Fruit クラスを直接使用することができます。コーデックは自動的に Document を Fruit クラスにマッピングします。

これが、 MongoCollection を FruitCodec と使用する例です。

package org.acme.mongodb;

import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoCursor;

import javax.enterprise.context.ApplicationScoped;
import javax.inject.Inject;
import java.util.ArrayList;
import java.util.List;

@ApplicationScoped
public class CodecFruitService {

    @Inject MongoClient mongoClient;

    public List<Fruit> list(){
        List<Fruit> list = new ArrayList<>();
        MongoCursor<Fruit> cursor = getCollection().find().iterator();

        try {
            while (cursor.hasNext()) {
                list.add(cursor.next());
            }
        } finally {
            cursor.close();
        }
        return list;
    }

    public void add(Fruit fruit){
        getCollection().insertOne(fruit);
    }

    private MongoCollection<Fruit> getCollection(){
        return mongoClient.getDatabase("fruit").getCollection("fruit", Fruit.class);
    }
}

POJOコーデック

The POJO Codec provides a set of annotations that enable the customization of the way a POJO is mapped to a MongoDB collection and this codec is initialized automatically by Quarkus

このアノテーションのひとつに @BsonDiscriminator アノテーションがありますが、これは、ドキュメントの中にデリミタフィールドを追加することで、複数の Java 型をひとつの MongoDB コレクションに保存できるようにするものです。抽象的な型やインターフェイスを扱うときに便利です。

Quarkusは、 @BsonDiscriminator でアノテーションされたすべてのクラスをPOJOコーデックで自動的に登録します。

POJO Codecでは、 PropertyCodecProvider によるジェネリックサポートが強化されています。Quarkusでは、POJO Codecで PropertyCodecProvider を使用すると自動的に登録されます（これらのクラスは自動的に @Singleton スコープのCDI Beanになります）。ネイティブ実行可能ファイルをビルドしてジェネリック型を使用する場合、リフレクションのために型の引数を登録する必要があるかもしれません。

PanacheでMongoDBをシンプルにする

MongoDB with Panacheエクステンションは、 Hibernate ORM with Panacheにあるようなアクティブレコードスタイルのエンティティ（およびリポジトリ）を提供することで、MongoDBの利用を促進し、Quarkusでエンティティを簡単に楽しく書けるようにすることに重点を置いています。

接続のヘルスチェック

quarkus-smallrye-health エクステンションを使用している場合、 quarkus-mongodb-client はクラスターへの接続を検証するためのReadinessヘルスチェックを自動的に追加します。

そのため、アプリケーションの /q/health/ready エンドポイントにアクセスすると、接続の検証状況に関する情報が表示されます。

この動作は、 application.properties で quarkus.mongodb.health.enabled プロパティーを false に設定することで無効にできます。

メトリクス

quarkus-micrometer または quarkus-smallrye-metrics エクステンションを使用している場合、 quarkus-mongodb-client は接続プールに関するメトリクスを提供することができます。この動作を有効にするには、まず application.properties の quarkus.mongodb.metrics.enabled プロパティーを true に設定する必要があります。

そのため、アプリケーションの /q/metrics エンドポイントにアクセスすると、接続プールの状況に関する情報が表示されます。SmallRye Metricsを使用すると、接続プールのメトリクスは vendor スコープの配下で利用可能になっています。

トレース

quarkus-smallrye-opentracing エクステンションを使用している場合、 quarkus-mongodb-client は実行されたコマンドについてのトレースを登録することができます。この動作を有効にするには、まず application.properties の quarkus.mongodb.tracing.enabled プロパティーを true に設定する必要があり、pom.xmlに`io.opentracing.contrib:opentracing-mongo-common`の依存関係を追加する必要があります (詳細は OpenTracing - MongoDB clientセクションをご覧ください)。

OpenTracingの設定方法やJaegerトレーサーの使用方法については、 OpenTracingガイドをお読みください。

テストヘルパー

ユニットテスト用にMongoDBデータベースを起動するために、Quarkusは Flapdoodle embedded MongoDBに依存する2つの QuarkusTestResourceLifecycleManager を提供しています。

io.quarkus.test.mongodb.MongoTestResource は、ポート27017に単一のインスタンスを起動します。
io.quarkus.test.mongodb.MongoReplicaSetTestResource は、ポート27017とポート27018にある2つのインスタンスでレプリカセットを開始します。

これらを使用するには、 io.quarkus:quarkus-test-mongodb の依存関係を pom.xml に追加する必要があります。

QuarkusTestResourceLifecycleManager の使い方については、 Quarkusのテストリソースをご覧ください。

レガシークライアント

デフォルトではレガシーな MongoDB クライアントは含まれていません。今では引退した MongoDB Java API (DB, DBCollection, … ) と com.mongodb.MongoClient が含まれていますが、今では com.mongodb.client.MongoClient に取って代わられています。

レガシーAPIを使用したい場合は、次の依存関係をビルドファイルに追加する必要があります。

pom.xml

<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>mongodb-driver-legacy</artifactId>
</dependency>

build.gradle

implementation("org.mongodb:mongodb-driver-legacy")

ネイティブ実行可能ファイルの構築

MongoDBクライアントをネイティブ実行可能ファイルで使うことができます。

SSL/TLS 暗号化を使用したい場合は、これらのプロパティを application.properties に追加する必要があります。

quarkus.mongodb.tls=true
quarkus.mongodb.tls-insecure=true # only if TLS certificate cannot be validated

その後、通常のコマンドでネイティブ実行可能ファイルをビルドすることができます。

CLI

quarkus build --native

+

Maven

./mvnw package -Dnative

+

Gradle

./gradlew build -Dquarkus.package.type=native

実行は ./target/mongodb-quickstart-1.0-SNAPSHOT-runner を実行するだけで簡単です。

その後、ブラウザで http://localhost:8080/fruits.html を開き、アプリケーションを使用します。

現在、Quarkusはネイティブモードでの Client-Side Field Level Encryptionをサポートしていません。

アプリケーションをネイティブモードで実行した際に、以下のようなエラーが発生した場合があります。+ Failed to encode 'MyObject'. Encoding 'myVariable' errored with: Can’t find a codec for class org.acme.MyVariable. + これは、 org.acme.MyVariable クラスがGraalVMに知られていないことを意味しています。対策としては、 @RegisterForReflection アノテーションを MyVariable class に追加してください。 @RegisterForReflection アノテーションの詳細については、ネイティブアプリケーションのヒントのページをご覧ください。

mongo+srv://のURLの使用

mongo+srv:// url は、JVM モードではサポートされます。しかし、ネイティブモードでは、MongoDB クライアントが提供するデフォルトの DNS リゾルバは JNDI を使っているので動作しません。

mongo+srv:// をネイティブモードで使用する必要がある場合は、代替の DNS リゾルバを設定することができます。この機能は *実験的な*もので、JVMアプリケーションとネイティブアプリケーションの間に違いが生じる可能性があります。

代替のDNSリゾルバを有効にするには

quarkus.mongodb.native.dns.use-vertx-dns-resolver=true

プロパティ名で示されているように、Vert.xを使用してDNSレコードを取得します。デフォルトでは、 /etc/resolv.conf から最初の nameserver を読み取ろうとします。このファイルが存在する場合は、そのファイルを使用します。また、DNS サーバーを設定することもできます。

quarkus.mongodb.native.dns.use-vertx-dns-resolver=true
quarkus.mongodb.native.dns.server-host=10.0.0.1
quarkus.mongodb.native.dns.server-port=53 # 53 is the default port

また、ルックアップのタイムアウトは、以下の方法で設定できます。

quarkus.mongodb.native.dns.use-vertx-dns-resolver=true
quarkus.mongodb.native.dns.lookup-timeout=10s # the default is 5s

設定リファレンス

ビルド時に固定される設定プロパティ - それ以外の設定プロパティは実行時に上書き可能

Configuration property	タイプ	デフォルト
`quarkus.mongodb.health.enabled` Whether a health check is published in case the smallrye-health extension is present. Environment variable: `QUARKUS_MONGODB_HEALTH_ENABLED`	boolean	`true`
`quarkus.mongodb.metrics.enabled` Whether metrics are published in case a metrics extension is present. Environment variable: `QUARKUS_MONGODB_METRICS_ENABLED`	boolean	`false`
`quarkus.mongodb.tracing.enabled` Whether tracing spans of driver commands are sent in case the smallrye-opentracing extension is present. Environment variable: `QUARKUS_MONGODB_TRACING_ENABLED`	boolean	`false`
`quarkus.mongodb.force-default-clients` If set to true, the default clients will always be created even if there are no injection points that use them Environment variable: `QUARKUS_MONGODB_FORCE_DEFAULT_CLIENTS`	boolean	`false`
`quarkus.mongodb.devservices.enabled` If DevServices has been explicitly enabled or disabled. DevServices is generally enabled by default, unless there is an existing configuration present. When DevServices is enabled Quarkus will attempt to automatically configure and start a database when running in Dev or Test mode. Environment variable: `QUARKUS_MONGODB_DEVSERVICES_ENABLED`	boolean
`quarkus.mongodb.devservices.image-name` The container image name to use, for container based DevServices providers. Environment variable: `QUARKUS_MONGODB_DEVSERVICES_IMAGE_NAME`	string
`quarkus.mongodb.devservices.port` Optional fixed port the dev service will listen to. If not defined, the port will be chosen randomly. Environment variable: `QUARKUS_MONGODB_DEVSERVICES_PORT`	int
`quarkus.mongodb.connection-string` Configures the connection string. The format is: `mongodb://[username:password@]host1[:port1][,host2[:port2],…[,hostN[:portN]]][/[database.collection][?options]]` `mongodb://` is a required prefix to identify that this is a string in the standard connection format. `username:password@` are optional. If given, the driver will attempt to log in to a database after connecting to a database server. For some authentication mechanisms, only the username is specified and the password is not, in which case the ":" after the username is left off as well. `host1` is the only required part of the connection string. It identifies a server address to connect to. `:portX` is optional and defaults to :27017 if not provided. `/database` is the name of the database to log in to and thus is only relevant if the `username:password@` syntax is used. If not specified the `admin` database will be used by default. `?options` are connection options. Note that if `database` is absent there is still a `/` required between the last host and the `?` introducing the options. Options are name=value pairs and the pairs are separated by "&". An alternative format, using the `mongodb+srv` protocol, is: mongodb+srv://[username:password@]host[/[database][?options]] - `mongodb+srv://` is a required prefix for this format. - `username:password@` are optional. If given, the driver will attempt to login to a database after connecting to a database server. For some authentication mechanisms, only the username is specified and the password is not, in which case the ":" after the username is left off as well - `host` is the only required part of the URI. It identifies a single host name for which SRV records are looked up from a Domain Name Server after prefixing the host name with `"_mongodb._tcp"`. The host/port for each SRV record becomes the seed list used to connect, as if each one were provided as host/port pair in a URI using the normal mongodb protocol. - `/database` is the name of the database to login to and thus is only relevant if the `username:password@` syntax is used. If not specified the "admin" database will be used by default. - `?options` are connection options. Note that if `database` is absent there is still a `/` required between the last host and the `?` introducing the options. Options are name=value pairs and the pairs are separated by "&". Additionally with the mongodb+srv protocol, TXT records are looked up from a Domain Name Server for the given host, and the text value of each one is prepended to any options on the URI itself. Because the last specified value for any option wins, that means that options provided on the URI will override any that are provided via TXT records. Environment variable: `QUARKUS_MONGODB_CONNECTION_STRING`	string
`quarkus.mongodb.hosts` Configures the MongoDB server addressed (one if single mode). The addresses are passed as `host:port`. Environment variable: `QUARKUS_MONGODB_HOSTS`	list of string	`127.0.0.1:27017`
`quarkus.mongodb.database` Configure the database name. Environment variable: `QUARKUS_MONGODB_DATABASE`	string
`quarkus.mongodb.application-name` Configures the application name. Environment variable: `QUARKUS_MONGODB_APPLICATION_NAME`	string
`quarkus.mongodb.max-pool-size` Configures the maximum number of connections in the connection pool. Environment variable: `QUARKUS_MONGODB_MAX_POOL_SIZE`	int
`quarkus.mongodb.min-pool-size` Configures the minimum number of connections in the connection pool. Environment variable: `QUARKUS_MONGODB_MIN_POOL_SIZE`	int
`quarkus.mongodb.max-connection-idle-time` Maximum idle time of a pooled connection. A connection that exceeds this limit will be closed. Environment variable: `QUARKUS_MONGODB_MAX_CONNECTION_IDLE_TIME`	Duration
`quarkus.mongodb.max-connection-life-time` Maximum lifetime of a pooled connection. A connection that exceeds this limit will be closed. Environment variable: `QUARKUS_MONGODB_MAX_CONNECTION_LIFE_TIME`	Duration
`quarkus.mongodb.maintenance-frequency` Configures the time period between runs of the maintenance job. Environment variable: `QUARKUS_MONGODB_MAINTENANCE_FREQUENCY`	Duration
`quarkus.mongodb.maintenance-initial-delay` Configures period of time to wait before running the first maintenance job on the connection pool. Environment variable: `QUARKUS_MONGODB_MAINTENANCE_INITIAL_DELAY`	Duration
`quarkus.mongodb.connect-timeout` How long a connection can take to be opened before timing out. Environment variable: `QUARKUS_MONGODB_CONNECT_TIMEOUT`	Duration
`quarkus.mongodb.read-timeout` How long a socket read can take before timing out. Environment variable: `QUARKUS_MONGODB_READ_TIMEOUT`	Duration
`quarkus.mongodb.tls-insecure` If connecting with TLS, this option enables insecure TLS connections. Environment variable: `QUARKUS_MONGODB_TLS_INSECURE`	boolean	`false`
`quarkus.mongodb.tls` Whether to connect using TLS. Environment variable: `QUARKUS_MONGODB_TLS`	boolean	`false`
`quarkus.mongodb.replica-set-name` Implies that the hosts given are a seed list, and the driver will attempt to find all members of the set. Environment variable: `QUARKUS_MONGODB_REPLICA_SET_NAME`	string
`quarkus.mongodb.server-selection-timeout` How long the driver will wait for server selection to succeed before throwing an exception. Environment variable: `QUARKUS_MONGODB_SERVER_SELECTION_TIMEOUT`	Duration
`quarkus.mongodb.local-threshold` When choosing among multiple MongoDB servers to send a request, the driver will only send that request to a server whose ping time is less than or equal to the server with the fastest ping time plus the local threshold. Environment variable: `QUARKUS_MONGODB_LOCAL_THRESHOLD`	Duration
`quarkus.mongodb.heartbeat-frequency` The frequency that the driver will attempt to determine the current state of each server in the cluster. Environment variable: `QUARKUS_MONGODB_HEARTBEAT_FREQUENCY`	Duration
`quarkus.mongodb.read-concern` Configures the read concern. Supported values are: `local\|majority\|linearizable\|snapshot\|available` Environment variable: `QUARKUS_MONGODB_READ_CONCERN`	string
`quarkus.mongodb.read-preference` Configures the read preferences. Supported values are: `primary\|primaryPreferred\|secondary\|secondaryPreferred\|nearest` Environment variable: `QUARKUS_MONGODB_READ_PREFERENCE`	string
`quarkus.mongodb.health.database` The database used during the readiness health checks Environment variable: `QUARKUS_MONGODB_HEALTH_DATABASE`	string	`admin`
`quarkus.mongodb.native.dns.use-vertx-dns-resolver` The default DNS resolver used to handle `mongo+srv://` urls cannot be used in a native executable. This option enables a fallback to use Vert.x to resolve the server names instead of JNDI. IMPORTANT: The resolution may be different in JVM mode using the default (JNDI-based) DNS resolver, and in native mode. This feature is experimental. Environment variable: `QUARKUS_MONGODB_NATIVE_DNS_USE_VERTX_DNS_RESOLVER`	boolean	`false`
`quarkus.mongodb.native.dns.server-host` If `native.dns.use-vertx-dns-resolver` is set to `true`, this property configures the DNS server. If the server is not set, it tries to read the first `nameserver` from `/etc/resolv.conf` (if the file exists), otherwise fallback to the default. Environment variable: `QUARKUS_MONGODB_NATIVE_DNS_SERVER_HOST`	string
`quarkus.mongodb.native.dns.server-port` If `native.dns.use-vertx-dns-resolver` is set to `true`, this property configures the DNS server port. If not set, uses the system DNS resolver. Environment variable: `QUARKUS_MONGODB_NATIVE_DNS_SERVER_PORT`	int	`53`
`quarkus.mongodb.native.dns.lookup-timeout` If `native.dns.use-vertx-dns-resolver` is set to `true`, this property configures the DNS lookup timeout duration. Environment variable: `QUARKUS_MONGODB_NATIVE_DNS_LOOKUP_TIMEOUT`	Duration	`5S`
`quarkus.mongodb.native.dns.log-activity` If `native.dns.use-vertx-dns-resolver` is set to `true`, this property enables the logging ot the DNS lookup. It can be useful to understand why the lookup fails. Environment variable: `QUARKUS_MONGODB_NATIVE_DNS_LOG_ACTIVITY`	boolean	`false`
`quarkus.mongodb.devservices.properties` Generic properties that are added to the connection URL. Environment variable: `QUARKUS_MONGODB_DEVSERVICES_PROPERTIES`	`Map<String,String>`
`quarkus.mongodb."mongo-client-configs".connection-string` Configures the connection string. The format is: `mongodb://[username:password@]host1[:port1][,host2[:port2],…[,hostN[:portN]]][/[database.collection][?options]]` `mongodb://` is a required prefix to identify that this is a string in the standard connection format. `username:password@` are optional. If given, the driver will attempt to log in to a database after connecting to a database server. For some authentication mechanisms, only the username is specified and the password is not, in which case the ":" after the username is left off as well. `host1` is the only required part of the connection string. It identifies a server address to connect to. `:portX` is optional and defaults to :27017 if not provided. `/database` is the name of the database to log in to and thus is only relevant if the `username:password@` syntax is used. If not specified the `admin` database will be used by default. `?options` are connection options. Note that if `database` is absent there is still a `/` required between the last host and the `?` introducing the options. Options are name=value pairs and the pairs are separated by "&". An alternative format, using the `mongodb+srv` protocol, is: mongodb+srv://[username:password@]host[/[database][?options]] - `mongodb+srv://` is a required prefix for this format. - `username:password@` are optional. If given, the driver will attempt to login to a database after connecting to a database server. For some authentication mechanisms, only the username is specified and the password is not, in which case the ":" after the username is left off as well - `host` is the only required part of the URI. It identifies a single host name for which SRV records are looked up from a Domain Name Server after prefixing the host name with `"_mongodb._tcp"`. The host/port for each SRV record becomes the seed list used to connect, as if each one were provided as host/port pair in a URI using the normal mongodb protocol. - `/database` is the name of the database to login to and thus is only relevant if the `username:password@` syntax is used. If not specified the "admin" database will be used by default. - `?options` are connection options. Note that if `database` is absent there is still a `/` required between the last host and the `?` introducing the options. Options are name=value pairs and the pairs are separated by "&". Additionally with the mongodb+srv protocol, TXT records are looked up from a Domain Name Server for the given host, and the text value of each one is prepended to any options on the URI itself. Because the last specified value for any option wins, that means that options provided on the URI will override any that are provided via TXT records. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__CONNECTION_STRING`	string
`quarkus.mongodb."mongo-client-configs".hosts` Configures the MongoDB server addressed (one if single mode). The addresses are passed as `host:port`. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__HOSTS`	list of string	`127.0.0.1:27017`
`quarkus.mongodb."mongo-client-configs".database` Configure the database name. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__DATABASE`	string
`quarkus.mongodb."mongo-client-configs".application-name` Configures the application name. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__APPLICATION_NAME`	string
`quarkus.mongodb."mongo-client-configs".max-pool-size` Configures the maximum number of connections in the connection pool. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__MAX_POOL_SIZE`	int
`quarkus.mongodb."mongo-client-configs".min-pool-size` Configures the minimum number of connections in the connection pool. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__MIN_POOL_SIZE`	int
`quarkus.mongodb."mongo-client-configs".max-connection-idle-time` Maximum idle time of a pooled connection. A connection that exceeds this limit will be closed. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__MAX_CONNECTION_IDLE_TIME`	Duration
`quarkus.mongodb."mongo-client-configs".max-connection-life-time` Maximum lifetime of a pooled connection. A connection that exceeds this limit will be closed. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__MAX_CONNECTION_LIFE_TIME`	Duration
`quarkus.mongodb."mongo-client-configs".maintenance-frequency` Configures the time period between runs of the maintenance job. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__MAINTENANCE_FREQUENCY`	Duration
`quarkus.mongodb."mongo-client-configs".maintenance-initial-delay` Configures period of time to wait before running the first maintenance job on the connection pool. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__MAINTENANCE_INITIAL_DELAY`	Duration
`quarkus.mongodb."mongo-client-configs".connect-timeout` How long a connection can take to be opened before timing out. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__CONNECT_TIMEOUT`	Duration
`quarkus.mongodb."mongo-client-configs".read-timeout` How long a socket read can take before timing out. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__READ_TIMEOUT`	Duration
`quarkus.mongodb."mongo-client-configs".tls-insecure` If connecting with TLS, this option enables insecure TLS connections. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__TLS_INSECURE`	boolean	`false`
`quarkus.mongodb."mongo-client-configs".tls` Whether to connect using TLS. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__TLS`	boolean	`false`
`quarkus.mongodb."mongo-client-configs".replica-set-name` Implies that the hosts given are a seed list, and the driver will attempt to find all members of the set. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__REPLICA_SET_NAME`	string
`quarkus.mongodb."mongo-client-configs".server-selection-timeout` How long the driver will wait for server selection to succeed before throwing an exception. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__SERVER_SELECTION_TIMEOUT`	Duration
`quarkus.mongodb."mongo-client-configs".local-threshold` When choosing among multiple MongoDB servers to send a request, the driver will only send that request to a server whose ping time is less than or equal to the server with the fastest ping time plus the local threshold. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__LOCAL_THRESHOLD`	Duration
`quarkus.mongodb."mongo-client-configs".heartbeat-frequency` The frequency that the driver will attempt to determine the current state of each server in the cluster. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__HEARTBEAT_FREQUENCY`	Duration
`quarkus.mongodb."mongo-client-configs".read-concern` Configures the read concern. Supported values are: `local\|majority\|linearizable\|snapshot\|available` Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__READ_CONCERN`	string
`quarkus.mongodb."mongo-client-configs".read-preference` Configures the read preferences. Supported values are: `primary\|primaryPreferred\|secondary\|secondaryPreferred\|nearest` Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__READ_PREFERENCE`	string
`quarkus.mongodb."mongo-client-configs".health.database` The database used during the readiness health checks Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__HEALTH_DATABASE`	string	`admin`
Write concern	タイプ	デフォルト
`quarkus.mongodb.write-concern.safe` Configures the safety. If set to `true`: the driver ensures that all writes are acknowledged by the MongoDB server, or else throws an exception. (see also `w` and `wtimeoutMS`). If set fo - `false`: the driver does not ensure that all writes are acknowledged by the MongoDB server. Environment variable: `QUARKUS_MONGODB_WRITE_CONCERN_SAFE`	boolean	`true`
`quarkus.mongodb.write-concern.journal` Configures the journal writing aspect. If set to `true`: the driver waits for the server to group commit to the journal file on disk. If set to `false`: the driver does not wait for the server to group commit to the journal file on disk. Environment variable: `QUARKUS_MONGODB_WRITE_CONCERN_JOURNAL`	boolean	`true`
`quarkus.mongodb.write-concern.w` When set, the driver adds `w: wValue` to all write commands. It requires `safe` to be `true`. The value is typically a number, but can also be the `majority` string. Environment variable: `QUARKUS_MONGODB_WRITE_CONCERN_W`	string
`quarkus.mongodb.write-concern.retry-writes` If set to `true`, the driver will retry supported write operations if they fail due to a network error. Environment variable: `QUARKUS_MONGODB_WRITE_CONCERN_RETRY_WRITES`	boolean	`false`
`quarkus.mongodb.write-concern.w-timeout` When set, the driver adds `wtimeout : ms` to all write commands. It requires `safe` to be `true`. Environment variable: `QUARKUS_MONGODB_WRITE_CONCERN_W_TIMEOUT`	Duration
`quarkus.mongodb."mongo-client-configs".write-concern.safe` Configures the safety. If set to `true`: the driver ensures that all writes are acknowledged by the MongoDB server, or else throws an exception. (see also `w` and `wtimeoutMS`). If set fo - `false`: the driver does not ensure that all writes are acknowledged by the MongoDB server. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__WRITE_CONCERN_SAFE`	boolean	`true`
`quarkus.mongodb."mongo-client-configs".write-concern.journal` Configures the journal writing aspect. If set to `true`: the driver waits for the server to group commit to the journal file on disk. If set to `false`: the driver does not wait for the server to group commit to the journal file on disk. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__WRITE_CONCERN_JOURNAL`	boolean	`true`
`quarkus.mongodb."mongo-client-configs".write-concern.w` When set, the driver adds `w: wValue` to all write commands. It requires `safe` to be `true`. The value is typically a number, but can also be the `majority` string. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__WRITE_CONCERN_W`	string
`quarkus.mongodb."mongo-client-configs".write-concern.retry-writes` If set to `true`, the driver will retry supported write operations if they fail due to a network error. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__WRITE_CONCERN_RETRY_WRITES`	boolean	`false`
`quarkus.mongodb."mongo-client-configs".write-concern.w-timeout` When set, the driver adds `wtimeout : ms` to all write commands. It requires `safe` to be `true`. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__WRITE_CONCERN_W_TIMEOUT`	Duration
Credentials and authentication mechanism	タイプ	デフォルト
`quarkus.mongodb.credentials.username` Configures the username. Environment variable: `QUARKUS_MONGODB_CREDENTIALS_USERNAME`	string
`quarkus.mongodb.credentials.password` Configures the password. Environment variable: `QUARKUS_MONGODB_CREDENTIALS_PASSWORD`	string
`quarkus.mongodb.credentials.auth-mechanism` Configures the authentication mechanism to use if a credential was supplied. The default is unspecified, in which case the client will pick the most secure mechanism available based on the sever version. For the GSSAPI and MONGODB-X509 mechanisms, no password is accepted, only the username. Supported values: null or `GSSAPI\|PLAIN\|MONGODB-X509\|SCRAM_SHA_1\|SCRAM_SHA_256\|MONGODB_AWS` Environment variable: `QUARKUS_MONGODB_CREDENTIALS_AUTH_MECHANISM`	string
`quarkus.mongodb.credentials.auth-source` Configures the source of the authentication credentials. This is typically the database that the credentials have been created. The value defaults to the database specified in the path portion of the connection string or in the 'database' configuration property. If the database is specified in neither place, the default value is `admin`. This option is only respected when using the MONGO-CR mechanism (the default). Environment variable: `QUARKUS_MONGODB_CREDENTIALS_AUTH_SOURCE`	string
`quarkus.mongodb.credentials.auth-mechanism-properties` Allows passing authentication mechanism properties. Environment variable: `QUARKUS_MONGODB_CREDENTIALS_AUTH_MECHANISM_PROPERTIES`	`Map<String,String>`
`quarkus.mongodb."mongo-client-configs".credentials.username` Configures the username. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__CREDENTIALS_USERNAME`	string
`quarkus.mongodb."mongo-client-configs".credentials.password` Configures the password. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__CREDENTIALS_PASSWORD`	string
`quarkus.mongodb."mongo-client-configs".credentials.auth-mechanism` Configures the authentication mechanism to use if a credential was supplied. The default is unspecified, in which case the client will pick the most secure mechanism available based on the sever version. For the GSSAPI and MONGODB-X509 mechanisms, no password is accepted, only the username. Supported values: null or `GSSAPI\|PLAIN\|MONGODB-X509\|SCRAM_SHA_1\|SCRAM_SHA_256\|MONGODB_AWS` Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__CREDENTIALS_AUTH_MECHANISM`	string
`quarkus.mongodb."mongo-client-configs".credentials.auth-source` Configures the source of the authentication credentials. This is typically the database that the credentials have been created. The value defaults to the database specified in the path portion of the connection string or in the 'database' configuration property. If the database is specified in neither place, the default value is `admin`. This option is only respected when using the MONGO-CR mechanism (the default). Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__CREDENTIALS_AUTH_SOURCE`	string
`quarkus.mongodb."mongo-client-configs".credentials.auth-mechanism-properties` Allows passing authentication mechanism properties. Environment variable: `QUARKUS_MONGODB__MONGO_CLIENT_CONFIGS__CREDENTIALS_AUTH_MECHANISM_PROPERTIES`	`Map<String,String>`

Configuration property

タイプ

デフォルト

quarkus.mongodb.health.enabled

Whether a health check is published in case the smallrye-health extension is present.

Environment variable: QUARKUS_MONGODB_HEALTH_ENABLED

boolean

true

quarkus.mongodb.metrics.enabled

Whether metrics are published in case a metrics extension is present.

Environment variable: QUARKUS_MONGODB_METRICS_ENABLED

boolean

false

quarkus.mongodb.tracing.enabled

Whether tracing spans of driver commands are sent in case the smallrye-opentracing extension is present.

Environment variable: QUARKUS_MONGODB_TRACING_ENABLED

boolean

false

quarkus.mongodb.force-default-clients

If set to true, the default clients will always be created even if there are no injection points that use them

Environment variable: QUARKUS_MONGODB_FORCE_DEFAULT_CLIENTS

boolean

false

quarkus.mongodb.devservices.enabled

If DevServices has been explicitly enabled or disabled. DevServices is generally enabled by default, unless there is an existing configuration present. When DevServices is enabled Quarkus will attempt to automatically configure and start a database when running in Dev or Test mode.

Environment variable: QUARKUS_MONGODB_DEVSERVICES_ENABLED

boolean

quarkus.mongodb.devservices.image-name

The container image name to use, for container based DevServices providers.

Environment variable: QUARKUS_MONGODB_DEVSERVICES_IMAGE_NAME

string

quarkus.mongodb.devservices.port

Optional fixed port the dev service will listen to. If not defined, the port will be chosen randomly.

Environment variable: QUARKUS_MONGODB_DEVSERVICES_PORT

int

quarkus.mongodb.connection-string

Configures the connection string. The format is: mongodb://[username:password@]host1[:port1][,host2[:port2],…[,hostN[:portN]]][/[database.collection][?options]] mongodb:// is a required prefix to identify that this is a string in the standard connection format. username:password@ are optional. If given, the driver will attempt to log in to a database after connecting to a database server. For some authentication mechanisms, only the username is specified and the password is not, in which case the ":" after the username is left off as well. host1 is the only required part of the connection string. It identifies a server address to connect to. :portX is optional and defaults to :27017 if not provided. /database is the name of the database to log in to and thus is only relevant if the username:password@ syntax is used. If not specified the admin database will be used by default. ?options are connection options. Note that if database is absent there is still a / required between the last host and the ? introducing the options. Options are name=value pairs and the pairs are separated by "&". An alternative format, using the mongodb+srv protocol, is: mongodb+srv://[username:password@]host[/[database][?options]] - mongodb+srv:// is a required prefix for this format. - username:password@ are optional. If given, the driver will attempt to login to a database after connecting to a database server. For some authentication mechanisms, only the username is specified and the password is not, in which case the ":" after the username is left off as well - host is the only required part of the URI. It identifies a single host name for which SRV records are looked up from a Domain Name Server after prefixing the host name with "_mongodb._tcp". The host/port for each SRV record becomes the seed list used to connect, as if each one were provided as host/port pair in a URI using the normal mongodb protocol. - /database is the name of the database to login to and thus is only relevant if the username:password@ syntax is used. If not specified the "admin" database will be used by default. - ?options are connection options. Note that if database is absent there is still a / required between the last host and the ? introducing the options. Options are name=value pairs and the pairs are separated by "&". Additionally with the mongodb+srv protocol, TXT records are looked up from a Domain Name Server for the given host, and the text value of each one is prepended to any options on the URI itself. Because the last specified value for any option wins, that means that options provided on the URI will override any that are provided via TXT records.