ANNOUNCEMENT: Voyage AI joins MongoDB to power more accurate and trustworthy AI applications on Atlas.
Learn more
Menu Docs

Driver Swift MongoDB

Boas-vindas ao site de documentação do driver Swift oficial do MongoDB. Você pode adicionar o driver ao seu aplicativo para trabalhar com o MongoDB no Swift. Baixe com o Swift Package Manager ou configure um projeto executável com exemplos do nosso Guia de Uso.

Importante

O driver Swift não está em desenvolvimento desde 2022.

Consulte Instalação

Para se conectar a um cluster do MongoDB Atlas, use a string de conexão do Atlas para seu cluster:

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

Observação

Para obter informações sobre como se conectar ao Atlas Serverless, consulte a página Limitações de instâncias sem servidor para obter a versão mínima do driver de que você precisa.

Se você precisar executar um servidor MongoDB em seu computador local para fins de desenvolvimento, em vez de usar um cluster do Atlas, será necessário concluir o seguinte:

  1. Baixe a versão Comunidade ou Enterprise do MongoDB Server.

  2. Instale e configure o servidor MongoDB.

  3. Inicie o servidor.

Importante

Sempre proteja seu servidor do MongoDB contra ataques maliciosos. Consulte nossa Lista de verificação de segurança para obter uma lista de recomendações de segurança.

Depois de iniciar com êxito o servidor MongoDB, especifique a connection string no código de conexão do driver.

Se o servidor MongoDB estiver sendo executado localmente, você poderá usar a connection string "mongodb://localhost:<port>", em que <port> é o número da porta que você configurou no servidor para escutar as conexões de entrada.

Se você precisar especificar um nome de host ou endereço IP diferente, consulte a entrada do Manual do servidor sobre strings de conexão.

Para testar se você pode se conectar ao servidor, substitua a string de conexão no exemplo de código Connect to MongoDB Atlas e execute-a.

A tabela de compatibilidade nesta seção especifica a versão recomendada ou versões do driver do MongoDB Swift para uso com uma versão específica do MongoDB.

A primeira coluna lista a versão do driver.

Importante

O MongoDB garante a compatibilidade entre o MongoDB Server e os drivers por três anos após a data de fim da vida útil (EOL) da versão do servidor. Para saber mais sobre a versão do MongoDB e as datas de EOL, consulte Agendamentos do ciclo de vida do software MongoDB.

Icon
Explicação

Todas as funcionalidades são suportadas.

A versão Driver funcionará com a versão MongoDB, mas nem todos os novos recursos MongoDB são suportados.

Sem marca

A versão Driver não é testada com a versão MongoDB.

Versão do driver 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]

Como o driver Swift não está em desenvolvimento ativo, ele não foi testado com as versões 7.0 ou posterior do Servidor MongoDB.

O driver Swift não é compatível com versões do servidor MongoDB anteriores à 3.6.

[1](1, 2) As versões 1.2 e 1.3 não são compatíveis com criptografia no nível de campo do cliente, GridFS e autenticação usando funções da AWS IAM.
[2](1, 2) As versões 1.0 e 1.1 não são compatíveis com OCSP, criptografia no nível de campo do cliente, GridFS e autenticação usando funções da AWS IAM.

O driver do MongoDB Swift exige o Swift 5.1 ou posterior.

Para obter mais informações sobre como ler as tabelas de compatibilidade, consulte nosso guia de tabelas de compatibilidade do MongoDB.