Menu Docs
Página inicial do Docs

Driver Swift MongoDB

Bem-vindo ao site de documentação do driver Swift oficial do MongoDB . Você pode adicionar o driver ao seu aplicação para trabalhar com o MongoDB no Swift. Baixe-o 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

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.

A versão do driver não funcionará com a versão do MongoDB. Tentar conectar-se à versão do MongoDB resultará em erros.

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.

Nesta página