Skip to content

Commit 16b26c7

Browse files
ajhuh-mdbajhuh-mdb
authored
DOCSP-33198 Clarify that SRV URI has No Port (#4886) (#5068)
* DOCSP-33198 Clarify that SRV URI has No Port * copy * edit examples to remove multiple host names + port * SO feedback * external feedback
1 parent 888683d commit 16b26c7

5 files changed

+42
-37
lines changed

‎source/includes/connection-examples-by-language-onprem-srv-rs.rst

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,83 +5,83 @@
55

66
.. code-block:: bash
77
8-
mongosh "mongodb+srv://mongodb0.example.com:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?authSource=admin&replicaSet=myRepl" --apiVersion 1 --username myDatabaseUser
8+
mongosh "mongodb+srv://mongodb0.example.com/?authSource=admin&replicaSet=myRepl" --apiVersion 1 --username myDatabaseUser
99
1010
.. tab::
1111
:tabid: python
1212

1313
.. code-block:: bash
1414
15-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?authSource=admin&replicaSet=myRepl
15+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin&replicaSet=myRepl
1616
1717
.. tab::
1818
:tabid: java-sync
1919

2020
.. code-block:: bash
2121
22-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?authSource=admin&replicaSet=myRepl
22+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin&replicaSet=myRepl
2323
2424
.. tab::
2525
:tabid: java-async
2626

2727
.. code-block:: bash
2828
29-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?authSource=admin&replicaSet=myRepl
29+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin&replicaSet=myRepl
3030
3131
.. tab::
3232
:tabid: nodejs
3333

3434
.. code-block:: bash
3535
36-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?authSource=admin&replicaSet=myRepl
36+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin&replicaSet=myRepl
3737
3838
.. tab::
3939
:tabid: php
4040

4141
.. code-block:: bash
4242
43-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?authSource=admin&replicaSet=myRepl
43+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin&replicaSet=myRepl
4444
4545
.. tab::
4646
:tabid: perl
4747

4848
.. code-block:: bash
4949
50-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?authSource=admin&replicaSet=myRepl
50+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin&replicaSet=myRepl
5151
.. tab::
5252
:tabid: ruby
5353

5454
.. code-block:: bash
5555
56-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?authSource=admin&replicaSet=myRepl
56+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin&replicaSet=myRepl
5757
5858
.. tab::
5959
:tabid: scala
6060

6161
.. code-block:: bash
6262
63-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?authSource=admin&replicaSet=myRepl
63+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin&replicaSet=myRepl
6464
6565
.. tab::
6666
:tabid: compass
6767

6868
.. code-block:: bash
6969
70-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?authSource=admin&replicaSet=myRepl
70+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin&replicaSet=myRepl
7171
7272
.. tab::
7373
:tabid: csharp
7474

7575
.. code-block:: bash
7676
77-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?authSource=admin&replicaSet=myRepl
77+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin&replicaSet=myRepl
7878
7979
.. tab::
8080
:tabid: go
8181

8282
.. code-block:: bash
8383
84-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?authSource=admin&replicaSet=myRepl
84+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin&replicaSet=myRepl
8585
8686
.. tab::
8787
:tabid: motor

‎source/includes/connection-examples-by-language-onprem-srv-sharded.rst

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,83 +5,83 @@
55

66
.. code-block:: bash
77
8-
mongosh "mongodb+srv://mongos0.example.com:27017,mongos1.example.com:27017,mongos2.example.com:27017/?authSource=admin" --apiVersion 1 --username myDatabaseUser
8+
mongosh "mongodb+srv://mongos0.example.com/?authSource=admin" --apiVersion 1 --username myDatabaseUser
99
1010
.. tab::
1111
:tabid: python
1212

1313
.. code-block:: bash
1414
15-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongos1.example.com:27017,mongos2.example.com:27017/?authSource=admin
15+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
1616
1717
.. tab::
1818
:tabid: java-sync
1919

2020
.. code-block:: bash
2121
22-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongos1.example.com:27017,mongos2.example.com:27017/?authSource=admin
22+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
2323
2424
.. tab::
2525
:tabid: java-async
2626

2727
.. code-block:: bash
2828
29-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongos1.example.com:27017,mongos2.example.com:27017/?authSource=admin
29+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
3030
3131
.. tab::
3232
:tabid: nodejs
3333

3434
.. code-block:: bash
3535
36-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongos1.example.com:27017,mongos2.example.com:27017/?authSource=admin
36+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
3737
3838
.. tab::
3939
:tabid: php
4040

4141
.. code-block:: bash
4242
43-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongos1.example.com:27017,mongos2.example.com:27017/?authSource=admin
43+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
4444
4545
.. tab::
4646
:tabid: perl
4747

4848
.. code-block:: bash
4949
50-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongos1.example.com:27017,mongos2.example.com:27017/?authSource=admin
50+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
5151
.. tab::
5252
:tabid: ruby
5353

5454
.. code-block:: bash
5555
56-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongos1.example.com:27017,mongos2.example.com:27017/?authSource=admin
56+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
5757
5858
.. tab::
5959
:tabid: scala
6060

6161
.. code-block:: bash
6262
63-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongos1.example.com:27017,mongos2.example.com:27017/?authSource=admin
63+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
6464
6565
.. tab::
6666
:tabid: compass
6767

6868
.. code-block:: bash
6969
70-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongos1.example.com:27017,mongos2.example.com:27017/?authSource=admin
70+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
7171
7272
.. tab::
7373
:tabid: csharp
7474

7575
.. code-block:: bash
7676
77-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongos1.example.com:27017,mongos2.example.com:27017/?authSource=admin
77+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
7878
7979
.. tab::
8080
:tabid: go
8181

8282
.. code-block:: bash
8383
84-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017,mongos1.example.com:27017,mongos2.example.com:27017/?authSource=admin
84+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
8585
8686
.. tab::
8787
:tabid: motor

‎source/includes/connection-examples-by-language-onprem-srv-standalone.rst

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,83 +5,83 @@
55

66
.. code-block:: bash
77
8-
mongosh "mongodb+srv://mongodb0.example.com:27017/?authSource=admin" --apiVersion 1 --username myDatabaseUser
8+
mongosh "mongodb+srv://mongodb0.example.com/?authSource=admin" --apiVersion 1 --username myDatabaseUser
99
1010
.. tab::
1111
:tabid: python
1212

1313
.. code-block:: bash
1414
15-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017/?authSource=admin
15+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
1616
1717
.. tab::
1818
:tabid: java-sync
1919

2020
.. code-block:: bash
2121
22-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017/?authSource=admin
22+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
2323
2424
.. tab::
2525
:tabid: java-async
2626

2727
.. code-block:: bash
2828
29-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017/?authSource=admin
29+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
3030
3131
.. tab::
3232
:tabid: nodejs
3333

3434
.. code-block:: bash
3535
36-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017/?authSource=admin
36+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
3737
3838
.. tab::
3939
:tabid: php
4040

4141
.. code-block:: bash
4242
43-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017/?authSource=admin
43+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
4444
4545
.. tab::
4646
:tabid: perl
4747

4848
.. code-block:: bash
4949
50-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017/?authSource=admin
50+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
5151
.. tab::
5252
:tabid: ruby
5353

5454
.. code-block:: bash
5555
56-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017/?authSource=admin
56+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
5757
5858
.. tab::
5959
:tabid: scala
6060

6161
.. code-block:: bash
6262
63-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017/?authSource=admin
63+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
6464
6565
.. tab::
6666
:tabid: compass
6767

6868
.. code-block:: bash
6969
70-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017/?authSource=admin
70+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
7171
7272
.. tab::
7373
:tabid: csharp
7474

7575
.. code-block:: bash
7676
77-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017/?authSource=admin
77+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
7878
7979
.. tab::
8080
:tabid: go
8181

8282
.. code-block:: bash
8383
84-
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]:27017/?authSource=admin
84+
mongodb+srv://myDatabaseUser:D1fficultP%[email protected]/?authSource=admin
8585
8686
.. tab::
8787
:tabid: motor

‎source/includes/list-table-connection-string-components.rst

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,11 @@ A connection string includes the following components:
5252
If the port number is not specified, the default port ``27017``
5353
is used.
5454

55+
.. note::
56+
57+
If you use the SRV URI connection format, you can specify only one
58+
host and no port. Otherwise, the driver or :binary:`~bin.mongosh`
59+
raises a parse error and does not perform DNS resolution.
5560

5661
* - ``/defaultauthdb``
5762

‎source/reference/connection-string.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -150,7 +150,7 @@ The SRV URI connection scheme has the following form:
150150

151151
.. code-block:: none
152152

153-
mongodb+srv://[username:password@]host1[:port1][,...hostN[:portN]][/[defaultauthdb][?options]]
153+
mongodb+srv://[username:password@]host[/[defaultauthdb][?options]]
154154

155155
For more examples, see :ref:`connections-connection-examples`.
156156

0 commit comments

Comments
 (0)