🔨 Intégrations
MongoDB est une base de données orientée vers les documents NoSQL, largement utilisée pour les applications web et autres logiciels basés sur des données. MongoDB est conçu pour être flexible, évolutif et rapide, et est particulièrement adapté pour traiter de grandes quantités de données non structurées ou semi-structurées.
Dans Illa, vous pouvez vous connecter à une base de données MongoDB en utilisant la ressource de requête MongoDB. Cette ressource vous permet d’exécuter des requêtes MongoDB directement à partir d’Illa, sans avoir à écrire de code. Vous pouvez utiliser l’éditeur de requête pour écrire des requêtes dans la langue native de la requête MongoDB qui est basé sur JavaScript et utilise une syntaxe de type JSON pour travailler avec des documents.
Il y a deux façons de créer une ressource dans Illa après la connexion à votre compte Illa.
Connectez-vous à votre compte Illa, sélectionnez **Ressources**
en haut de la page, et cliquez sur le bouton **Créer nouveau**
.
Sélectionnez MongoDB
dans la liste des bases de données.
Connectez-vous à la base de données avec les paramètres requis décrits dans Paramètres de connexion
ci-dessous.
Cliquez sur **Tester la connexion**
pour voir si nous pouvons nous connecter avec succès à la base de données. Si oui, cliquez sur Enregistrer les ressources
, sinon vérifiez que le nom d’hôte, le port, le nom d’utilisateur et le mot de passe sont corrects.
Après avoir créé une ressource, la MongoDB prête s’affichera comme indiqué.
Connectez-vous à votre compte Illa, créez un projet dans Illa Builder dans la page **App**
et accédez à la Liste d'actions
en bas de la page. Cliquez sur **new**
, puis sélectionnez MongoDB
dans la liste des bases de données. Ensuite, connectez-vous à la base de données avec les paramètres requis décrits dans Paramètres de connexion
ci-dessous.
Cliquez sur **Tester la connexion**
pour voir si nous pouvons nous connecter avec succès à la base de données. Si oui, cliquez sur Enregistrer les ressources
, sinon vérifiez que le nom d’hôte, le port, le nom d’utilisateur et le mot de passe sont corrects.
Ici, nous avons besoin de fournir des informations pour se connecter à la base de données MongoDB.
Propriétés | Requis | Libellé |
---|---|---|
Nom | Obligatoire | Le nom de la ressource lors de la création d’actions dans l’ILLA. |
Type de configuration | optionnel | un type de collection utilisé pour stocker des données de configuration pour les clusters découpés. |
Hostname | Obligatoire | L’URL ou l’adresse IP de votre base de données |
Format de connexion | Obligatoire | la syntaxe utilisée pour spécifier la chaîne de connexion pour se connecter à une base de données ou un cluster MongoDB. |
Port | Obligatoire | Le numéro de port de l’hôte que vous devez utiliser pour vous connecter. Si vous ne spécifiez pas de port, le port par défaut est ‘3306’. |
Base de données | Obligatoire | Le nom de la base de données |
Nom d’utilisateur | Obligatoire | le nom d’utilisateur que vous souhaitez utiliser lors de votre connexion au serveur MongoDB. |
Mot de passe | Obligatoire | Utilisez ce mot de passe pour l’authentification. |
Options SSL | optionnel | décide à quel point une connexion sécurisée TCP/IP est priorisée lors de la négociation avec le serveur. |
Nous avons créé une ressource MongoDB, nous pouvons ajouter l’action en sélectionnant MongoDB dans la liste d’action et en choisissant le bouton Créer l'action
.
Maintenant nous avons ajouté le serveur MongoDB comme une action à notre page de construction.
Nom de la méthode | Libellé |
---|---|
Type d’action | agrégate, bulkwrite, count, deleteMany. deleteOne, distinct, trouver, findOne |
Collecte | groupe de documents liés qui sont stockés ensemble dans une base de données |
Transformateur | transformation des données dans le style que vous aimez en utilisant JavaScript |
traiter plusieurs documents et retourner les résultats calculés.
Input
Propriétés | Requis | Libellé |
---|---|---|
Agrégation | optionnel | définit les opérations à effectuer sur les données |
Par exemple, pour obtenir tous les résultats dont la taille est moyenne=>regrouper les résultats par type=>Calculer la somme des prix dans chaque type pour Aggregation
:
[
{
"$match": { "size": "medium" }
},
{
"$group": { "_id": "$type", "totalQuantity": { "$sum": "$price" } }
}
]
Sortie
Un tableau des résultats calculés.
Utilisez {{mongodb1.data[0].result}}
pour tout obtenir.
effectuer plusieurs opérations d’écriture (insertion, mise à jour et suppression) en une seule requête vers le serveur
Input
Propriétés | Requis | Libellé |
---|---|---|
Opérations | optionnel | un objet qui spécifie le type d’opération à effectuer et les données à écrire |
Un exemple pour Opérations
:
[
{ "insertOne": { "document": { "_id": 3, "type": "beef", "size": "medium", "price": 6 } } },
{ "insertOne": { "document": { "_id": 4, "type": "sausage", "size": "large", "price": 10 } } },
{ "updateOne": {
"filter": { "type": "cheese" },
"update": { "$set": { "price": 8 } }
}
}
]
Sortie
Le message mis à jour est affiché ci-dessous.
Puisque cette méthode fait des changements mais ne retourne rien. Il n’y a pas de données de sortie à accéder.
compter le nombre de documents qui correspondent à une requête dans une collection
Input
Propriétés | Requis | Libellé |
---|---|---|
Requête | optionnel | spécifie les critères de sélection pour l’opération de comptage |
Par exemple, pour compter le nombre d’articles avec le type “beef”, nous pouvons mettre le code ci-dessous dans Query
:
{"type":"beef"}
Sortie
Le nombre de documents correspondants.
Utilisez {{mongodb1.data}}
pour l’obtenir.
supprimer plusieurs documents qui correspondent à un filtre donné dans une collection.
Input
Propriétés | Requis | Libellé |
---|---|---|
Filtre | optionnel | spécifie les critères de sélection pour l’opération de suppression, si non spécifiée, tous les documents de cette collection seront supprimés. |
Par exemple, pour supprimer les pommes des articles. Nous pouvons mettre le code ci-dessous sur Filter
.
{"type":"pomme"}
Sortie
Le nombre de documents correspondants.
Utilisez {{mongodb1.data[0].result.DeletedCount}}
pour l’obtenir. Si aucun fichier n’est trouvé, la valeur retournée sera 0.
supprimer un document qui correspond à un filtre dans une collection.
Input
Propriétés | Requis | Libellé |
---|---|---|
Filtre | optionnel | spécifie les critères de sélection pour l’opération de suppression |
Par exemple, pour supprimer une pomme des articles. Nous pouvons mettre le code ci-dessous sur Filter
.
{"type":"pomme"}
Sortie
Supprimer le résultat.
Utilisez {{mongodb1.data[0].result.DeletedCount}}
pour l’obtenir. Si aucun fichier n’est trouvé, la valeur retournée sera 0 (Nous avons supprimé toutes les pommes de deleteMany
, Il n’y a plus de pomme à gauche, donc retourner 0).
récupérer un tableau de valeurs uniques pour un champ spécifié dans une collection
Input
Propriétés | Requis | Libellé |
---|---|---|
Requête | optionnel | spécifie les critères de sélection pour l’opération distincte |
Champ | Obligatoire | spécifie le champ pour récupérer les valeurs distinctes. |
Par exemple, nous pouvons avoir {"type":"orange"}
pour Query
et _id
pour Field
.
Sortie
un tableau de valeurs distinctes
Utilisez {{mongodb1.data[0].result.map(item =>({"result":item}))}}
pour obtenir le tableau.
récupérer les documents d’une collection qui correspondent à un ensemble de critères spécifiés
Input
Propriétés | Requis | Libellé |
---|---|---|
Requête | optionnel | spécifie les critères de sélection pour l’opération de recherche |
Projection | optionnel | spécifie quels champs inclure ou exclure dans les résultats de la requête |
Trier par | optionnel | spécifiez l’ordre de tri des documents retournés |
Limite | optionnel | limiter le nombre de documents retournés, sans limite par défaut. Une limite de 0 est équivalente à aucune limite. |
Ignorer | optionnel | spécifie le nombre de documents à ignorer, par défaut à 0. |
Par exemple, pour trouver l’identifiant, le prix et le type de toutes les oranges triées par leur ID.
Pour Query
, {"type": "orange"}
Pour Projection
, {"_id": 1, "type": 1, "price": 1}
Pour Sort By
, {"_id":1}
Note : remplacez « 1 » par « vrai » encore faites-le !
Sortie
Un tableau d’objets de documents
Utilisez {{mongodb1.data[0].result}}
pour obtenir le tableau.
récupérer le premier document d’une collection qui correspond à un ensemble de critères spécifiés
Input
Propriétés | Requis | Libellé |
---|---|---|
Requête | optionnel | spécifie les critères de sélection pour l’opération de recherche |
Projection | optionnel | spécifie quels champs inclure ou exclure dans les résultats de la requête |
Ignorer | optionnel | spécifie le nombre de documents à ignorer, par défaut à 0. |
Par exemple, pour trouver l’identifiant, le prix et le type de toutes les oranges triées par leur ID.
Pour Query
, {"type": "orange"}
Pour Projection
, {"_id": 1, "type": 1, "prix": 1}
Note : remplacez « 1 » par « vrai » encore faites-le !
Sortie
Un tableau d’objets de documents
Utilisez {{[mongodb1.data[0].result]}}
pour obtenir le tableau.