Introducción
Bienvenido al sitio de documentación del controlador oficial de MongoDB Swift. Puedes agregar el driver a tu aplicación para trabajar con MongoDB en Swift. Descárguelo con el Swift Package Manager 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 conectarte a un MongoDB Atlas clúster, utiliza la cadena de conexión de Atlas de tu 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 tu MongoDB Server se ejecuta localmente, puedes utilizar la cadena de conexión
"mongodb://localhost:<port>" donde <port> es el número de puerto que configuraste para que tu servidor escuche las 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 de MongoDB
La tabla de compatibilidad en esta sección especifica la versión o las versiones recomendadas del controlador MongoDB Swift para su uso con una versión específica de MongoDB.
La primera columna muestra la versión del controlador.
Importante
MongoDB garantiza la compatibilidad entre el MongoDB Server y los drivers durante tres años después de la fecha de fin de vida útil (EOL) de la versión del servidor. Para obtener más información sobre la liberación de MongoDB y las fechas EOL, consulte Cronogramas del ciclo de vida del software de MongoDB.
Leyenda de la tabla de compatibilidad
Icon | Explicación |
|---|---|
✓ | Se admiten todas las funcionalidades. |
⊛ | La versión del driver funcionará con la versión de MongoDB, pero no se admiten todas las nuevas funcionalidades de MongoDB. |
✗ | La versión del controlador no funcionará 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 driver 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 compatibilidad con cifrado a nivel de campos del lado del cliente, GridFS ni 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.