Opções de connection string

Esta página lista todas as opções de conexão para se conectar ao seu banco de dados usando connection strings SRV e connection strings padrões.

As opções de conexão são pares no seguinte formulário: name=value.

A opção name diferencia maiúsculas de minúsculas ao utilizar um condutor.
A opção name diferencia maiúsculas de minúsculas ao utilizar o mongosh.
O(A) value sempre diferencia maiúsculas de minúsculas.

Separar as opções com o caractere ampersand (&) name1=value1&name2=value2. No exemplo a seguir, uma conexão inclui as opções replicaSet e connectTimeoutMS:

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db1.example.net:27017,db2.example.net:2500/?replicaSet=test&connectTimeoutMS=300000

Observação

Separador de ponto e vírgula para argumentos de connection string

Para oferecer compatibilidade com versões anteriores, atualmente, os drivers aceitam ponto e vírgula (;) como separadores de opções.

Opção de conjunto de réplica

A seguinte cadeia de caracteres de conexão conecta a um conjunto de réplica denominado myRepl com membros executando nos hosts especificados. Ele autentica como usuário myDatabaseUser com a senha D1fficultP%40ssw0rd:

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com:27017,db1.example.com:27017,db2.example.com:27017/?replicaSet=myRepl

Opção de conexão

Descrição

replicaSet

Especifica o nome doconjunto de réplicas do , se o mongod for um membro de um conjunto de réplicas. Defina a opção de conexão replicaSet para garantir um comportamento consistente entre drivers.

Ao conectar a um conjunto de réplicas, forneça uma lista de seeds dos membros do conjunto de réplicas para o componente host[:port] do uri. Para obter detalhes específicos, consulte a documentação do driver.

directConnection

Especifica se o cliente se conecta diretamente ao host[:port] no URI da conexão:

true: o cliente envia operações somente para o host especificado. Ele não tenta descobrir nenhum outro membro do conjunto de réplicas.
false: o cliente tenta descobrir todos os servidores no conjunto de réplicas e envia operações para o membro primário. Este é o valor padrão.

IMPORTANTE: quando um conjunto de réplicas é executado no Docker, ele pode expor apenas um endpoint do MongoDB . Nesse caso, o conjunto de réplicas não é detectável e a especificação de directConnection=false pode impedir que seu aplicação se conecte a ele.

Em um ambiente de teste ou desenvolvimento, você pode se conectar ao conjunto de réplicas especificando directConnection=true na URI de conexão. Em um ambiente de produção, recomendamos configurar o cluster para que cada instância do MongoDB seja acessível fora da rede virtual do Docker.

Opções de conexão

Opções de TLS

A seguinte string de conexão com um conjunto de réplicas inclui a opção tls=true. Ela autentica como usuário myDatabaseUser com a senha D1fficultP%40ssw0rd.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&tls=true

Além disso, você também pode utilizar a opção ssl=true equivalente:

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&ssl=true

Opção de conexão	Descrição
`tls`	Habilita ou desabilita TLS/SSL para a conexão: `true`: inicia a conexão com TLS/SSL. Padrão para o formato de conexão SRV. `false`: inicie a conexão sem TLS/SSL. Padrão para o formato de string de conexão padrão. A opção `tls` `ssl` é equivalente à opção. Se o shell do `mongosh` especificar opções adicionais de tls/ssl da linha de comando, utilize a opção de linha de comando do `--tls`.
`ssl`	Um booleano para ativar ou desativar TLS/SSL para a conexão: `true`: inicia a conexão com TLS/SSL. Padrão para o formato de conexão SRV. `false`: inicie a conexão sem TLS/SSL. Padrão para o formato de string de conexão padrão. A opção `ssl` `tls` é equivalente à opção. Se o shell do `mongosh` especificar opções adicionais de tls/ssl da linha de comando, utilize a opção de linha de comando do `--ssl`.
`tlsCertificateKeyFile`	Especifica o local de um arquivo `.pem` local que contém o certificado TLS/SSL X.509 do cliente ou o certificado e chave TLS/SSL do cliente. O cliente apresenta este arquivo para a instância `mongod`/`mongos`. O `mongod` / `mongos` registra um aviso na conexão se o certificado x.509 apresentado expirar dentro de `30` dias do horário do sistema host `mongod/mongos`. Esta opção não é compatível com todos os drivers. Consulte a documentação sobre os drivers. Esta opção de connection string não está disponível para o shell `mongo`. Use a opção de linha de comando.
`tlsCertificateKeyFilePassword`	Especifica a `tlsCertificateKeyFile` senha para descriptografar o. Esta opção não é compatível com todos os drivers. Consulte a documentação sobre os drivers. Esta opção de connection string não está disponível para o shell `mongo`. Use a opção de linha de comando.
`tlsCAFile`	Especifica o local de um arquivo de `.pem` local que contém a cadeia de certificados raiz da Autoridade de Certificação. Esse arquivo é usado para validar o certificado apresentado pela instância`mongod` / `mongos`. Esta opção não é compatível com todos os drivers. Consulte a documentação sobre os drivers. Esta opção de connection string não está disponível para o shell `mongo`. Use a opção de linha de comando.
`tlsAllowInvalidCertificates`	Ignora a validação dos certificados apresentados pela instância `mongod` / `mongos` Defina como `true` para se conectar às instâncias do MongoDB mesmo que o servidor apresente certificados inválidos. Esta opção não é compatível com todos os drivers. Consulte a documentação sobre os drivers. Esta opção de connection string não está disponível para o shell `mongo`. Use a opção de linha de comando. AVISO: a desativação da validação do certificado cria uma vulnerabilidade.
`tlsAllowInvalidHostnames`	Desativa a validação do nome de host do certificado apresentado pela instância `mongod` / `mongos`. Configure para `true` para conectar às instâncias MongoDB mesmo que o nome de host nos certificados do servidor não correspondam ao host do servidor. Esta opção não é compatível com todos os drivers. Consulte a documentação sobre os drivers. Esta opção de connection string não está disponível para o shell `mongo`. Use a opção de linha de comando. AVISO: a desativação da validação do certificado cria uma vulnerabilidade.
`tlsInsecure`	Desabilita várias validações de certificado. Configurar para `true` para desabilitar as validações do certificado. As validações exatas desativadas variam de acordo com os drivers. Consulte a documentação sobre os drivers. Esta opção de connection string não está disponível para o shell `mongo`. Use a opção de linha de comando. AVISO: a desativação da validação do certificado cria uma vulnerabilidade.

Opções de tempo limite

Opção de conexão	Descrição
`connectTimeoutMS`	O tempo em milissegundos para tentar uma conexão antes de atingir o tempo limite. O padrão é 10,000 milissegundos, mas drivers específicos podem ter outro padrão. Para obter detalhes, consulte a documentação do driver.
`socketTimeoutMS`	O tempo em milissegundos para tentar enviar ou receber em um soquete antes que a tentativa expire. O padrão é nunca atingir o tempo limite, embora drivers diferentes possam variar. Consulte a documentação do driver.

Opções de compressão

Opção de conexão

Descrição

compressors

String delimitada por vírgula de compressores para habilitar a compressão de rede para comunicação entre este cliente e uma instância mongod / mongos.

Você pode especificar os seguintes compressores:

Se você especificar vários compressores, a ordem na qual você lista os compressores importam, bem como o iniciador de comunicação. Por exemplo, se o cliente especificar os seguintes compressores de rede "zlib,snappy" e o mongod especificar "snappy,zlib", as mensagens entre o cliente e o mongod utilizarão zlib.

As mensagens são compactadas quando ambas as partes habilitam a compactação de rede. Caso contrário, as mensagens entre as partes serão descompactadas.

Se as partes não compartilharem pelo menos um compressor comum, as mensagens entre as partes serão descompactadas.

mongosh suporta a opção de string de conexão compressors uri.

zlibCompressionLevel

Um número inteiro que especifica o nível de compressão se utilizar zlib network compressionpara.

Você pode especificar um valor inteiro na faixa entre -1 e 9:

Valor	Notas
`-1`	Nível de compressão padrão, geralmente compressão nível `6`.
`0`	Sem compressão
`1` - `9`	Aumento do nível de compressão, mas ao custo da velocidade, com: `1` fornecendo a melhor velocidade, mas menor compactação, e `9` fornecendo a melhor compressão, mas na velocidade mais lenta.

Compatível com o mongosh.

Opções do pool de conexões

A maioria dos drivers implementa algum tipo de tratamento de pool de conexões. Alguns drivers não oferecem suporte a pool de conexões. Consulte a documentação do driver para obter mais informações sobre a implantação do pool de conexões. Essas opções permitem que os aplicativos configurem o pool de conexão ao se conectar à implantação do MongoDB.

Opção de conexão	Descrição
`maxPoolSize`	O número máximo de conexões no pool de conexões. O valor padrão é `100`.
`minPoolSize`	O número mínimo de conexões no pool de conexões. O valor padrão é `0`. A opção não é suportada por todos os `minPoolSize` drivers. Para obter informações sobre o motorista, consulte a documentação Drivers.
`maxConnecting`	Número máximo de conexões que um pool pode estabelecer simultaneamente. O valor padrão é `2`. `maxConnecting` é compatível com todos os drivers, exceto o driver Rust. Aumentar o valor de `maxConnecting` permite que o cliente estabeleça conexão com o servidor mais rápido, mas aumenta a chance de tempestades de conexão. Se o valor de `maxConnecting` for muito baixo, o pool de conexões poderá sofrer fortes limitações e aumentar a latência da parte final para os clientes que estiverem checando as conexões.
`maxIdleTimeMS`	O número máximo de milissegundos que uma conexão pode permanecer inativa no pool antes de ser removida e fechada. Esta opção não é suportada por todos os drivers.
`waitQueueMultiple`	Um número ao qual o driver multiplica o `maxPoolSize` valor de, para fornecer o número máximo de threads permitidos para aguardar uma conexão se tornar disponível a partir do grupo. Para valores padrão, consulte a documentação do driver. Esta opção não é suportada por todos os drivers.
`waitQueueTimeoutMS`	O tempo máximo em milissegundos que uma thread pode esperar até que uma conexão fique disponível. Para valores padrão, consulte a documentação do driver. Esta opção não é suportada por todos os drivers.

Opções de write concern

A write concern descreve o nível de confirmação solicitado ao MongoDB. A opção write concern é suportada por:

Você pode especificar o write concern na connection string e como um parâmetro para métodos como insert ou update. Se o write concern for especificado em ambos os locais, o método parâmetro substituirá a connection string de configuração.

As connection strings de implantação do MongoDB Atlas usam "majority" por padrão. Se você não especificar o write concern para uma implantação do MongoDB Atlas, o MongoDB Atlas imporá"majority".

A string de conexão a seguir para um conjunto de réplicas especifica a preocupação de gravação de "majority" e um tempo limite de 5 segundos usando o parâmetro de preocupação de gravação wtimeoutMS:

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&w=majority&wtimeoutMS=5000

Opção de conexão	Descrição
`w`	Corresponde à opção de `w` da preocupação de gravação. A opção `w` solicita a confirmação de que a operação de gravação se propagou para um número especificado de instâncias `mongod` ou para instâncias `mongod` com tags especificadas. Você pode especificar um `number`, a string `majority` ou um `tag set`. Para obter detalhes, consulte Opção `w`.
`wtimeoutMS`	Corresponde à preocupação de gravação `wtimeout`. `wtimeoutMS` especifica um limite de tempo, em milissegundos, para a preocupação de gravação. Quando `wtimeoutMS` `0`é, as operações de gravação nunca expiram. Para mais informações,`wtimeout` consulte.
`journal`	Corresponde à `j` opção de Opção de de preocupação de gravação . A opção solicita confirmação do MongoDB de `journal` que a operação de gravação foi gravada no diário. Para obter detalhes, consulte `j` opção. Se você definir `journal` como `true` e especificar um valor de `w` menor 1 que, `journal` prevalecerá.

Para obter mais informações, consulte Preocupação de gravação.

readConcern Options

Para o mecanismo de armazenamento WiredTiger, o MongoDB introduz a opção readConcern para conjuntos de réplicas e fragmentos de conjuntos de réplicas.

Ler Preocupação permite que os clientes escolham um nível de isolamento para suas leituras a partir de conjuntos de réplica.

A seguinte string de conexão para um conjunto de réplica especifica readConcernLevel=majority:

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&readConcernLevel=majority

Opção de conexão	Descrição
`readConcernLevel`	O nível de isolamento. Pode aceitar um dos seguintes valores: `local` `majority` `linearizable` `available` Esta opção de cadeia de conexão não está disponível para `mongosh`. Especifique a preocupação de leitura como uma opção para a operação específica.

Para obter mais informações, consulte Preocupação de leitura.

Opções de read preference

Read preferences descrevem o comportamento das operações de leitura em relação aos conjuntos de réplicas. Esses parâmetros permitem que você especifique preferências de leitura por conexão na connection string.

Por exemplo:

A seguinte string de conexão para um conjunto de réplica especifica o modo de preferência de leitura do secondary e um valor de maxStalenessSeconds de 120 segundos:
```
mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&readPreference=secondary&maxStalenessSeconds=120
```
A seguinte string de conexão para um cluster fragmentado especifica o modo de preferência de leitura do secondary e um valor de maxStalenessSeconds de 120 segundos:
```
mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongos1.example.com,mongos2.example.com/?readPreference=secondary&maxStalenessSeconds=120
```
A string de conexão a seguir para um cluster fragmentado especifica o modo de preferência de leitura secondary, bem como três readPreferenceTags:
```
mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongos1.example.com,mongos2.example.com/?readPreference=secondary&readPreferenceTags=dc:ny,rack:r1&readPreferenceTags=dc:ny&readPreferenceTags=
```

A ordem é importante ao usar vários readPreferenceTags. Os readPreferenceTags são testados em ordem até que uma correspondência seja encontrada. Uma vez encontrada, essa especificação é usada para encontrar todos os membros correspondentes elegíveis e quaisquer readPreferenceTags restantes são ignorados. Para obter detalhes, consulte Ordem de correspondência de tags.

Opção de conexão	Descrição
`readPreference`	Especifica as preferências de leitura para esta conexão. Os valores possíveis são: `primary` (Padrão) `primaryPreferred` `secondary` `secondaryPreferred` `nearest` Transações distribuídas que contêm operações de leitura devem usar a read preference `primary`. Todas as operações em uma determinada transação devem ser roteadas para o mesmo membro. Esta opção de string de conexão não está disponível para a shell `mongo`. Consulte, então, `cursor.readPref()` e `Mongo.setReadPref()`.
`maxStalenessSeconds`	Especifica, em segundos, o quão obsoleto um secundário pode ser antes de o cliente parar de usá-lo para operações de leitura. Para detalhes, consulte Preferência de leitura `maxStalenessSeconds`. Por padrão, não há desatualização máxima e os clientes não consideram o atraso do secundário ao escolher para onde direcionar uma operação de leitura. O `maxStalenessSeconds` valor mínimo de é de 90 segundos. Especificar um valor entre 0 e 90 segundos produz um erro. Os drivers do MongoDB tratam um `maxStalenessSeconds` valor de `-1` como "no max staleness", o mesmo que se `maxStalenessSeconds` fosse omitido.
`readPreferenceTags`	Especifica o documento de tags como uma lista separada por vírgula de pares de valores-chave separados por dois pontos. Por exemplo, Para especificar o documento de etiquetas `{ "dc": "ny", "rack": "r1" }`, utilize `readPreferenceTags=dc:ny,rack:r1` na cadeia de ligação. Para especificar um documento de etiquetas vazias `{ }`, utilize `readPreferenceTags=` sem definir o valor. Para especificar uma lista de documentos de tags, use vários `readPreferenceTags`. Por exemplo, `readPreferenceTags=dc:ny,rack:r1&readPreferenceTags=`. A ordem é importante ao usar vários `readPreferenceTags`. Os `readPreferenceTags` são testados em ordem até que uma correspondência seja encontrada. Para obter detalhes, consulte Ordem de correspondência de tags. Esta opção de string de conexão não está disponível para a shell `mongo`. Consulte, então, `cursor.readPref()` e `Mongo.setReadPref()`.

Para mais informações, consulte Preferências de leitura.

Opções de autenticação

A string de conexão a seguir para um conjunto de réplicas especifica o authSource para o banco de dados admin. Ou seja, as credenciais do usuário são autenticadas no banco de dados admin.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongodb0.example.com:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?replicaSet=myRepl&authSource=admin

Se o nome de usuário ou senha incluir os seguintes caracteres, esses caracteres deverão ser convertidos usando codificação percentual:

$ : / ? # [ ] @

Opção de conexão	Descrição
`authSource`	Especifique o nome do banco de dados associado às credenciais do usuário. Se`authSource`não for especificado, `authSource`padronizará para o `defaultauthdb` especificado na string de conexão. Se `defaultauthdb` não for especificado, então `authSource` padroniza `admin` para. Os mecanismos de autenticação `PLAIN` (LDAP), `GSSAPI` (Kerberos) e (IAM) exigem que seja `MONGODB-AWS` `authSource` definido `$external` como, pois esses mecanismos delegam o armazenamento de credenciais a serviços externos. O MongoDB ignora os valores se nenhum nome de usuário for fornecido, seja na string de conexão ou por meio `authSource` do `--username` parâmetro.
`authMechanism` Padrão: SCRAM-SHA-256	Especifique o mecanismo de autenticação que o MongoDB usa para autenticar a conexão. Se você não especificar um `authMechanism`, mas fornecer credenciais de usuário, o MongoDB tentará usar o SCRAM-SHA-256. Se isso falhar, ele volta para SCRAM-SHA-1. SCRAM-SHA-1 SCRAM-SHA-256 MONGODB-X509 `MONGODB-AWS` GSSAPI (Kerberos) PLAIN (LDAP SASL) `MONGODB-OIDC` (OpenID conecta OIDC). Para usar `MONGODB-OIDC`, você deve: Defina a `authMechanismProperties` `ENVIRONMENT` variável . Forneça um chamada de resposta OIDC para o construtor do cliente . Somente instâncias do MongoDB Enterprise `mongod` e `mongos` fornecem mecanismos do `GSSAPI` (Kerberos) e `PLAIN` (LDAP). Para usar o `MONGODB-X509`, você deve ter TLS/SSL ativado. Para usar `MONGODB-AWS`, você deve estar se conectando a um cluster do MongoDB Atlas que tenha sido configurado para permitir autenticação por meio de credenciais do Amazon Web Services IAM (um ID de chave de acesso do Amazon Web Services e uma chave de acesso secreta e, opcionalmente, um token de sessão do Amazon Web Services). O mecanismo de autenticação `MONGODB-AWS` exige que o `authSource` seja configurado para `$external`. Se o ID da chave de acesso da AWS, a chave de acesso secreta ou o token de sessão estiverem definidos em sua plataforma usando suas respectivas variáveis de ambiente da AWS IAM, usará esses valores de variável de ambiente para autenticar automaticamente. Você não precisa especificá-los na string de conexão. Existem outros métodos para fornecer credenciais da AWS, dependendo do seu ambiente de implementação e dos requisitos de`mongosh` segurança. Consulte Conectar-se a um Atlas cluster para obter exemplo de uso do `MONGODB-AWS` mecanismo de autenticação. Consulte Autenticação em implementações autogerenciadas para obter mais informações sobre o sistema de autenticação no MongoDB. Considere também Usar certificados X.509 para autenticar clientes em sistemas autogerenciados para obter mais informações sobre a autenticação x509.
`authMechanismProperties`	Especifique propriedades para o especificado como uma lista separada por vírgula de pares de valores-chave separados por `authMechanism` vírgula. Os possíveis pares de chave-valor são: `SERVICE_NAME:<string>` Defina o nome do serviço Kerberos ao conectar-se a instâncias do MongoDB com suporte do Kerberos. Esse valor deve corresponder ao nome do serviço definido nas instâncias do MongoDB das quais você está se conectando. Válido apenas ao usar o mecanismo de autenticação GSSAPI. `SERVICE_NAME` padrão para `mongodb` para todos os clientes e instâncias MongoDB. Se você alterar a configuração `saslServiceName` em uma instância do MongoDB, deverá definir `SERVICE_NAME` para corresponder a essa configuração. Válido apenas ao usar o mecanismo de autenticação GSSAPI. `CANONICALIZE_HOST_NAME:true\|false` Canonize o nome de host da máquina host do cliente ao conectar ao servidor Kerberos. Isso pode ser necessário quando os hosts relatam nomes de host diferentes do que está no banco de dados Kerberos. Padrão é `false`. Válido apenas ao usar o mecanismo de autenticação GSSAPI. `SERVICE_REALM:<string>` Configure a região Kerberos para o serviço MongoDB. Isso pode ser necessário para suportar a autenticação entre domínios onde o usuário existe em um domínio e o serviço em outro. Válido apenas ao usar o mecanismo de autenticação GSSAPI. `AWS_SESSION_TOKEN:<security_token>` Defina o token de sessão do Amazon Web Services para autenticação com credenciais temporárias ao usar uma solicitação AssumeRole ou ao trabalhar com recursos do Amazon Web Services que especificam esse valor, como Lambda. Válido apenas ao usar o mecanismo de autenticação `MONGODB-AWS`. Você também deve ter um ID de chave de acesso do Amazon Web Services e uma chave de acesso secreta. Consulte Conectar-se a um Atlas cluster para obter exemplo de uso. `ENVIRONMENT:<string>` Defina o ambiente OpenID Connect (OIDC). Para: Microsoft Azure, conjunto `ENVIRONMENT:azure` Google Cloud Platform, conjunto `ENVIRONMENT:gcp` Você também deve `authMechanism` definir `MONGODB-OIDC` como.
`gssapiServiceName`	Defina o nome do serviço Kerberos ao conectar-se a instâncias Kerberized MongoDB. Esse valor deve corresponder ao nome do serviço definido nas instâncias do MongoDB às quais você está se conectando. `gssapiServiceName` padrão é `mongodb` para todos os clientes e instâncias do MongoDB . Se você alterar `saslServiceName` a configuração em uma instância do MongoDB , deverá `gssapiServiceName` definir para corresponder a essa configuração. `gssapiServiceName` é um alias obsoleto para `authMechanismProperties=SERVICE_NAME:mongodb`. Para obter mais informações sobre quais opções seu driver oferece suporte e sua prioridade relativa entre si, consulte a documentação da versão do driver de sua preferência.

Seleção de servidor e opções de descoberta

O MongoDB fornece as seguintes opções para configurar como drivers do MongoDB e instâncias do mongos selecionam um servidor para o qual direcionar operações de leitura ou gravação.

Opção de conexão	Descrição
`localThresholdMS`	O tamanho (em milissegundos) da janela de latência para selecionar entre várias instâncias MongoDB adequadas. Padrão: 15 milissegundos. Todos os drivers usam `localThresholdMS`. Utilize o `localThreshold` alias ao especificar o tamanho da janela de latência `mongos` para.
`serverSelectionTimeoutMS`	Especifica por quanto tempo (em milissegundos) bloquear para seleção de servidor antes de lançar uma exceção. Padrão: 30.000 milissegundos.
`serverSelectionTryOnce`	Somente drivers de thread único. Quando o `true`, instrui o driver a verificar a implantação do MongoDB exatamente uma vez após a falha da seleção do servidor e então selecionar um servidor ou levantar um erro. `false`Quando, o driver bloqueia e pesquisa um servidor até o `serverSelectionTimeoutMS` valor. Padrão`true`:. Drivers de threads múltiplas e `mongos` não `serverSelectionTryOnce` suportam.
`heartbeatFrequencyMS`	`heartbeatFrequencyMS` controla quando o driver verifica o estado da implantação do MongoDB. Especifique o intervalo (em milissegundos) entre verificações, contado desde o final da verificação anterior até o início da próxima. Padrão: Drivers de thread único: 60 segundos. Drivers multithread: 10 segundos. `mongos` não oferece suporte à alteração da frequência das verificações de pulsação.
`socketCheckIntervalMS`	Somente clientes de thread único. Controla com que frequência o cliente verifica o estado da conexão CPU com a implantação do MongoDB . Se você especificar um valor mais baixo, o cliente detectará os problemas de rede mais rapidamente, mas usará mais CPU. Padrão: 5 segundos. Esta opção não é compatível com todos os drivers. Consulte a documentação sobre os drivers.

Configurações diversas

Opção de conexão	Descrição
`appName`	Especifique um nome de aplicativo personalizado. O nome do aplicativo aparece em: `mongod` e `mongos` logs o campo `currentOp.appName` no comando `currentOp` e saída do método `db.currentOp()` O campo `system.profile.appName` na saída do analisador de banco de dados A `appName` opção de conexão do está disponível para: MongoDB Drivers `mongosh` começando em `mongosh` 1.1.9 MongoDB Compass começando em Compass 1.28.4
`retryReads`	Habilite leituras repetíveis Os valores possíveis são: `true`. Habilita leituras repetíveis para a conexão. Os drivers oficiais do MongoDB são padronizados como `true`. `false`. Desativa leituras repetíveis para a conexão. `mongosh` não oferece suporte a leituras repetíveis.
`retryWrites`	Habilite gravações repetíveis. Os valores possíveis são: `true`. Permite gravações que podem ser repetidas na conexão. Os drivers oficiais do MongoDB são padronizados como `true`. `false`. Desativa as gravações que podem ser repetidas na conexão. Os drivers do MongoDB tentam novamente a confirmação da transação e abortam as operações, independentemente do valor de `retryWrites`. Para obter mais informações sobre a capacidade de repetição de transações, consulte Tratamento de erros de transação.
`uuidRepresentation`	Os valores possíveis são: `standard` A representação binária padrão. `csharpLegacy` A representação predefinida para o condutor C#. `javaLegacy` A representação padrão para o driver Java. `pythonLegacy` A representação padrão do driver Python. Para saber qual é o padrão, consulte a documentação dos drivers do seu driver. Nem todos os motoristas suportam a `uuidRepresentation` opção. Para obter informações sobre seu motorista, consulte a documentação do motorista.
`loadBalanced`	Especifica se o cliente está se conectando a um balanceador de carga. Esta opção é `false` por padrão. Você só poderá definir esta opção como `true` se atender aos seguintes requisitos: Você especifica apenas um nome de host. Você não está se conectando a um conjunto de réplicas. A opção não está definida ou tem um `srvMaxHosts` valor `0` de. A opção não está definida ou tem um `directConnection` valor `false` de.
`srvMaxHosts`	Especifica o número de conexões `mongos` que podem ser criadas para topologias fragmentadas. Defina esta opção como um número inteiro não negativo. `0` é o valor padrão e significa que não há limite para o número de conexões `mongos` .

Voltar

Cadeias de conexão

Formats