FireDAC.Phys.MongoDBWrapper.TMongoConnection
Delphi
TMongoConnection = class(TMongoObject)
C++
class PASCALIMPLEMENTATION TMongoConnection : public TMongoObject
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| class | public | FireDAC.Phys.MongoDBWrapper.pas FireDAC.Phys.MongoDBWrapper.hpp |
FireDAC.Phys.MongoDBWrapper | FireDAC.Phys.MongoDBWrapper |
Description
Représente une connexion à un serveur MongoDB, et fournit un accès à ses bases de données et à ses collections.
Pour obtenir une instance de TMongoConnection, n'en créez pas une directement. A la place, configurez un composant TFDConnection pour établir la connexion à votre serveur MongoDB, assurez-vous qu'il est connecté, et transtypez sa propriété CliObj en TMongoConnection :
Delphi :
FDConnection1.Connected := True;
MyConnection := TMongoConnection(FDConnection1.CliObj);
C++ :
FDConnection1->Connected = true;
TMongoConnection* MyConnection = (TMongoConnection*) FDConnection1->CliObj;
La connexion représentée par TMongoConnection est ouverte par défaut. Utilisez Open pour changer le serveur MongoDB cible de votre connexion ou Close pour fermer la connexion.
Utilisez les membres suivants pour accéder aux données du serveur MongoDB :
- Collections pour obtenir une instance partagée de TMongoCollection ou GetCollection pour obtenir une nouvelle instance.
- Databases pour obtenir une instance partagée de TMongoDatabase ou GetDatabase pour obtenir une nouvelle instance.
- Dereference, pour obtenir un document du serveur MongoDB en fonction de son DBRef.
- ListDatabases, pour obtenir une liste des bases de données dans le serveur MongoDB.
TMongoConnection fournit plusieurs membres pour obtenir des informations sur le serveur MongoDB :
- ServerVersion est la version du serveur MongoDB.
- URI est l'URI du serveur MongoDB.
- GetServerStatus renvoie un document qui fournit un aperçu de l'état du processus de base de données.
- Ping déclenche une exception si le serveur MongoDB ne répond pas aux commandes.
- max_bson_size est la taille maximale possible d'un document stocké dans un serveur MongoDB.
- max_message_size est la taille maximale possible d'une requête envoyée au serveur MongoDB.
Pour exécuter des commandes de base de données (EN), utilisez l'une des méthodes suivantes :
- Command exécute la commande spécifiée et renvoie un curseur pour accéder à tous les documents de résultats.
- CommandSimple exécute la commande spécifiée et renvoie un document qui contient la réponse du serveur.
Pour configurer la sémantique de lecture et d'écriture de l'ensemble de répliques (EN) du serveur MongoDB, utilisez les propriétés suivantes :
- ReadPreference est la préférence de lecture.
- WriteConcern est la garantie d'écriture.
Utilisez SSLInit pour configurer les options SSL de votre client pour des communications sécurisées avec votre serveur MongoDB.
TMongoConnection encapsule une structure mongoc_client_t (EN) de MongoDB.