En esta página se muestran los métodos de autenticación admitidos y los clientes, y se muestra el código de ejemplo que puede usar para conectar el clúster de MongoDB Atlas desde los servicios de proceso de Azure mediante Service Connector. Es posible que todavía pueda conectarse al clúster de MongoDB Atlas en otros lenguajes de programación sin usar Service Connector. Esta página también muestra los nombres y valores predeterminados de las variables de entorno que se obtiene al crear la conexión de servicio.
Servicios de proceso admitidos
Service Connector se puede usar para conectar los siguientes servicios de proceso al clúster de MongoDB Atlas:
- Azure App Service
- Azure Container Apps (Aplicaciones de Contenedores de Azure)
- Funciones de Azure
- Azure Kubernetes Service (AKS)
Tipos de autenticación y tipos de cliente admitidos
En la tabla siguiente se muestran las combinaciones de métodos de autenticación y clientes que se admiten para conectar el servicio de proceso al clúster de MongoDB Atlas mediante Service Connector. Un valor "Sí" indica que se admite la combinación, mientras que "No" indica que no se admite.
| Tipo de cliente |
Identidad administrada asignada por el sistema |
Identidad administrada asignada por el usuario |
Secreto/cadena de conexión |
Principal de servicio |
| .RED |
No |
No |
Sí |
No |
| Go (pg) |
No |
No |
Sí |
No |
| Java (JDBC) |
No |
No |
Sí |
No |
| Java: Spring Boot (JDBC) |
No |
No |
Sí |
No |
| Node.js (pg) |
No |
No |
Sí |
No |
| PHP (nativo) |
No |
No |
Sí |
No |
| Python (psycopg2) |
No |
No |
Sí |
No |
| Python-Django |
No |
No |
Sí |
No |
| Ruby (ruby-pg) |
No |
No |
Sí |
No |
| Ninguno |
No |
No |
Sí |
No |
Nombres de variables de entorno predeterminados o propiedades de aplicación y código de ejemplo
Haga referencia a los detalles de conexión y el código de ejemplo de las tablas siguientes, según el tipo de autenticación y el tipo de cliente de la conexión, para conectar los servicios de proceso al clúster de MongoDB Atlas. Para más información sobre las convenciones de nomenclatura, consulte el artículo Sobre los elementos internos de Service Connector .
Cadena de conexión
Advertencia
Microsoft recomienda usar el flujo de autenticación más seguro disponible. El flujo de autenticación que se describe en este procedimiento requiere un alto grado de confianza en la aplicación y conlleva riesgos que no están presentes en otros flujos. Solo debe usar este flujo cuando otros flujos más seguros, como las identidades administradas, no sean viables.
| Nombre de la variable de entorno predeterminado |
Descripción |
Ejemplo de valor |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
Cadena de conexión de .NET MongoDB Atlas |
mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nombre de la variable de entorno predeterminado |
Descripción |
Ejemplo de valor |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
Cadena de conexión de JDBC MongoDB Atlas |
jdbc:mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nombre de la variable de entorno predeterminado |
Descripción |
Ejemplo de valor |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
Cadena de conexión de Python MongoDB Atlas |
mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nombre de la variable de entorno predeterminado |
Descripción |
Ejemplo de valor |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
Cadena de conexión de Django MongoDB Atlas |
mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nombre de la variable de entorno predeterminado |
Descripción |
Ejemplo de valor |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
Cadena de conexión de Go MongoDB Atlas |
mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nombre de la variable de entorno predeterminado |
Descripción |
Ejemplo de valor |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
Cadena de conexión de NodeJS MongoDB Atlas |
mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nombre de la variable de entorno predeterminado |
Descripción |
Ejemplo de valor |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
Cadena de conexión nativa de MongoDB Atlas para PHP |
mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nombre de la variable de entorno predeterminado |
Descripción |
Ejemplo de valor |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
Cadena de conexión de Ruby MongoDB Atlas |
mongodb+srv:/<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nombre de la variable de entorno predeterminado |
Descripción |
Ejemplo de valor |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
Cadena de conexión de MongoDB Atlas |
mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
Código de ejemplo
Consulte los pasos y el código siguientes para conectarse al clúster de MongoDB Atlas mediante una cadena de conexión.
Instalación de la dependencia.
dotnet add package MongoDb.Driver
Obtenga la cadena de conexión de la variable de entorno agregada por Service Connector y conéctese a MongoDB Atlas.
using MongoDB.Driver;
var connectionString = Environment.GetEnvironmentVariable("MONGODBATLAS_CLUSTER_CONNECTIONSTRING");
var client = new MongoClient(connectionString);
Agregue la siguiente dependencia al archivo pom.xml:
<dependency>
<groupId>org.mongodb</groupId>
<artifactId>mongo-java-driver</artifactId>
<version>3.4.2</version>
</dependency>
Obtenga la cadena de conexión de la variable de entorno agregada por Service Connector y conéctese a MongoDB Atlas.
import com.mongodb.MongoClient;
import com.mongodb.MongoClientURI;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import com.mongodb.client.model.Filters;
String connectionString = System.getenv("MONGODBATLAS_CLUSTER_CONNECTIONSTRING");
MongoClientURI uri = new MongoClientURI(connectionString);
MongoClient mongoClient = null;
try {
mongoClient = new MongoClient(uri);
} finally {
if (mongoClient != null) {
mongoClient.close();
}
}
Instalación de la dependencia.
pip install pymongo
Obtenga la cadena de conexión de la variable de entorno agregada por Service Connector y conéctese a MongoDB Atlas.
import os
import pymongo
conn_str = os.environ.get("MONGODBATLAS_CLUSTER_CONNECTIONSTRING")
client = pymongo.MongoClient(conn_str)
- Instalación de la dependencia.
go get go.mongodb.org/mongo-driver/mongo
- Obtenga la cadena de conexión de la variable de entorno agregada por Service Connector y conéctese a MongoDB Atlas.
import (
"context"
"fmt"
"log"
"os"
"go.mongodb.org/mongo-driver/bson"
"go.mongodb.org/mongo-driver/mongo"
"go.mongodb.org/mongo-driver/mongo/options"
)
ctx, cancel := context.WithTimeout(context.Background(), time.Second*10)
defer cancel()
mongoDBConnectionString = os.Getenv("MONGODBATLAS_CLUSTER_CONNECTIONSTRING")
clientOptions := options.Client().ApplyURI(mongoDBConnectionString).SetDirect(true)
c, err := mongo.Connect(ctx, clientOptions)
if err != nil {
log.Fatalf("unable to initialize connection %v", err)
}
err = c.Ping(ctx, nil)
if err != nil {
log.Fatalf("unable to connect %v", err)
}
- Instalación de la dependencia.
npm install mongodb
- Obtenga la cadena de conexión de la variable de entorno agregada por Service Connector y conéctese a MongoDB Atlas.
const { MongoClient, ObjectId } = require('mongodb');
const url = process.env.MONGODBATLAS_CLUSTER_CONNECTIONSTRING;
const client = new MongoClient(url);
Para otros lenguajes, puede usar el punto de conexión de recursos de MongoDB y otras propiedades que Service Connector establece en las variables de entorno para conectarse a MongoDB Atlas. Para más información sobre las variables de entorno, consulte Integración de MongoDB con Service Connector.
Pasos siguientes
Para más información sobre Service Connector, siga los tutoriales que se enumeran a continuación.