Introducción
Bienvenido al sitio de documentación del controlador oficial de MongoDB Swift. Puede agregar el controlador a su aplicación para trabajar con MongoDB en Swift. Descárguelo con el Gestor de Paquetes de Swift. o configure un proyecto ejecutable con ejemplos de nuestra Guía de uso.
Importante
El controlador Swift ya no está en desarrollo activo desde 2022.
Instalación
Ver Instalación
Conéctese a MongoDB Atlas
Para conectarse a un clúster MongoDB Atlas, utilice la cadena de conexión Atlas para su clúster:
import MongoSwiftSync defer { // free driver resources cleanupMongoSwift() } // replace the following string with your connection uri let uri = "mongodb+srv://<db_username>:<db_password>@<cluster-address>/test?w=majority" let client = try MongoClient(uri) // print a list of database names print (try client.listDatabaseNames()) // your application logic
import MongoSwift import NIO let elg = MultiThreadedEventLoopGroup(numberOfThreads: 4) // replace the following string with your connection uri let uri = "mongodb+srv://<db_username>:<db_password>@<cluster-address>/test?w=majority" let client = try MongoClient( uri, using: elg ) defer { // clean up driver resources try? client.syncClose() cleanupMongoSwift() // shut down EventLoopGroup try? elg.syncShutdownGracefully() } // print a list of database names print(try client.listDatabaseNames().wait()) // your application logic
Realizar la conexión a MongoDB Server en la máquina local
Si necesita ejecutar un servidor MongoDB en su máquina local para fines de desarrollo en lugar de usar un clúster Atlas, debe completar lo siguiente:
Instale y configure MongoDB Server.
Inicia el servidor.
Importante
Se debe proteger siempre el servidor MongoDB de ataques maliciosos. Se debe consultar nuestra Lista de verificación de seguridad para ver una lista de recomendaciones de seguridad.
Después de iniciar MongoDB Server correctamente, se debe especificar la cadena de conexión en el código de conexión del driver.
Si su servidor MongoDB se ejecuta localmente, puede usar la cadena de conexión
"mongodb://localhost:<port>" donde <port> es el número de puerto que configuró su servidor para escuchar conexiones entrantes.
Si debes especificar un nombre de host o una dirección IP diferente, consulta nuestra entrada del Manual del servidor sobre Cadenas de conexión.
Para probar si se puede realizar la conexión al servidor, se debe reemplazar la cadena de conexión en el ejemplo de código Conectar a MongoDB Atlas y ejecútalo.
Compatibilidad
Compatibilidad con MongoDB
La tabla de compatibilidad de esta sección especifica la versión o versiones recomendadas del controlador MongoDB Swift para usar con una versión específica de MongoDB.
La primera columna enumera la versión del controlador.
Importante
MongoDB garantiza la compatibilidad entre el servidor MongoDB y los controladores durante tres años a partir de la fecha de fin de vida útil (EOL) de la versión del servidor. Para obtener más información sobre las fechas de lanzamiento y EOL de MongoDB, consulte los cronogramas del ciclo de vida del software de MongoDB.
Leyenda de la tabla de compatibilidad
Icon | Explicación |
|---|---|
✓ | Todas las funciones son compatibles. |
⊛ | La versión del controlador funcionará con la versión de MongoDB, pero no todas las nuevas funciones de MongoDB son compatibles. |
✗ | La versión del controlador no es compatible con la versión de MongoDB. Intentar conectarse a la versión de MongoDB generará errores. |
Sin marca | La versión del controlador no está probada con la versión de MongoDB. |
Versión del controlador Swift | MongoDB 7.0 | MongoDB 6.0 | MongoDB 5.0 | MongoDB 4.4 | MongoDB 4.2 | MongoDB 4.0 | MongoDB 3.6 |
|---|---|---|---|---|---|---|---|
1.3.0 [1] | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | |
1.2.0 [1] | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | |
1.1.0 [2] | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | |
1.0.0 [2] | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ |
Debido a que el controlador Swift no está en desarrollo activo, no se ha probado con las versiones 7.0 o posteriores de MongoDB Server.
El controlador Swift no es compatible con versiones del servidor MongoDB anteriores a 3.6.
| [1] | (,1 2) Las versiones 1.2 y 1.3 no incluyen soporte para cifrado a nivel de campo del lado del cliente, GridFS y autenticación mediante roles de AWS IAM. |
| [2] | (,1 2) Las versiones 1.0 y 1.1 no incluyen soporte para OCSP,cifrado a nivel de campo del lado del cliente, GridFS y autenticación mediante roles de AWS IAM. |
Compatibilidad de idiomas
El controlador MongoDB Swift requiere Swift 5.1 o posterior.
Cómo obtener ayuda
Solicita ayuda en la página Stack Overflow de MongoDB o en la comunidad de Reddit de MongoDB.
Visita nuestros canales de soporte.
Consulta nuestro proyecto JIRA de SWIFT para informar problemas o solicitar funcionalidades.