-
Notifications
You must be signed in to change notification settings - Fork 56
/
Copy pathchangelog.txt
1040 lines (654 loc) · 26.3 KB
/
changelog.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
.. _mongosh-changelog:
=============
Release Notes
=============
.. default-domain:: mongodb
.. contents:: On this page
:local:
:backlinks: none
:depth: 1
:class: singlecol
v1.8.2
------
*Released April 28, 2023*
- :issue:`MONGOSH-1323` Print content of the string instead of the
string itself in browser-repl
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?version=35957&projectId=17381>`__.
v1.8.1
------
*Released April 24, 2023*
``mongosh`` now uses version 5.3.0 of the :driver:`Node.js driver </node/>`.
- :issue:`MONGOSH-1304` ``rs.reconfig()`` will no longer automatically retry operations
- :issue:`MONGOSH-1413` This is the first release that uploads to PPAs for Amazon 2023 after the distro rename
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=35689>`__.
v1.8.0
------
*Released February 28, 2023*
Autocomplete suggests completions for database level aggregation stages.
Compatibility Changes
~~~~~~~~~~~~~~~~~~~~~
- ``EJSON.stringify`` no longer accepts a ``{{strict}}`` option.
- These methods are removed:
- ObjectId.prototype.generate
- ObjectId.prototype.getInc
- ObjectId.prototype.get_inc
- ObjectId.getInc
- .. include:: /includes/scripting/fact-code-objects.rst
- .. include:: /includes/scripting/fact-enumerable-keys.rst
Updates in 1.8.0
~~~~~~~~~~~~~~~~
- :issue:`MONGOSH-1358` Updates for the 5.1.0 :driver:`Node.js driver
</node/>`.
- :issue:`MONGOSH-1336` Performance improvement some use cases including
the ``--version`` and ``--build-info`` flags.
- :issue:`MONGOSH-1316` Surfaces the ``createEncryptedCollection``
helper method.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=35534>`__.
v1.7.1
------
*Released February 16, 2023*
- :issue:`MONGOSH-1378` Fixes connectivity issues when ``mongosh`` is
installed using Homebrew.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=35548>`__.
v1.7.0
------
*Released February 10, 2023*
- :issue:`MONGOSH-57` Display a warning when connecting to databases
that mimic MongoDB.
- :issue:`MONGOSH-545` To get the current connection string, use
``db.getMongo().getURI()``.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=35363>`__.
v1.6.2
------
*Released January 9, 2023*
- Improves ``mongosh`` startup time.
- ``mongosh`` now uses :github:`Node.js driver 4.13.0
</mongodb/node-mongodb-native/releases/tag/v4.13.0>`.
- Improves error messages.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?version=35137&projectId=17381>`__.
v1.6.1
------
*Released December 1, 2022*
- :issue:`MONGOSH-1320`: Fixes a startup bug related to Docker and
similar environments.
- :issue:`MONGOSH-1050`: Adds support for the
``convertShardKeyToHashed()`` helper method.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=34525>`__.
v1.6.0
------
*Released September 20, 2022*
- :issue:`MONGOSH-1299`: ``mongosh`` now uses :github:`Node.js driver
4.10.0 </mongodb/node-mongodb-native/releases/tag/v4.10.0>`.
- :issue:`MONGOSH-1254`: Adds the ``sh.getShardedDataDistribution()``
helper method. This method runs the ``$shardedDataDistribution``
aggregation stage and returns a cursor for the result.
- :issue:`MONGOSH-1266`: The KeyVault :method:`~KeyVault.getKey()` and
:method:`~KeyVault.getKeyByAltName()` methods now return Documents.
- :issue:`MONGOSH-1249`: Adds a ``--json`` flag for use with
``--eval`` commands.
- :issue:`MONGOSH-1287`: ``cursor.count()`` is now deprecated. Instead,
use :method:`~db.collection.countDocuments()` and
:method:`~db.collection.estimatedDocumentCount()`.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=34315>`__.
v1.5.4
------
*Released July 31, 2022*
Fixes a potential data corruption bug in
:method:`KeyVault.rewrapManyDataKey()` when rotating encrypted data
encryption keys backed by Azure or GCP key services.
In previous versions of ``mongosh``, this bug occurs when an
Azure-backed or GCP-backed data encryption key being rewrapped requires
fetching an access token for decryption of the data encryption key.
As a result of this bug, all data encryption keys being rewrapped are
replaced by new randomly generated material, destroying the original key
material.
To mitigate potential data corruption, upgrade ``mongosh`` to v1.5.4 or
higher before using :method:`KeyVault.rewrapManyDataKey()` to rotate
Azure-backed or GCP-backed data encryption keys. You should always
create a backup of the key vault collection before key rotation.
v1.5.3
------
*Released July 29, 2022*
Updates telemetry internals.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?version=34298&projectId=17381>`__.
v1.5.2
------
*Released July 27, 2022*
``mongosh`` now uses :github:`Node.js driver 4.8.1
</mongodb/node-mongodb-native/releases/tag/v4.8.1>`.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=34143>`__.
v1.5.1
------
*Released July 14, 2022*
- :issue:`MONGOSH-1194` - ``mongosh`` supports multiple :option:`--eval
<mongosh --eval>` arguments.
- ``mongosh`` now uses `Node.js driver 4.8.0
<https://github.com/mongodb/node-mongodb-native/releases/tag/v4.8.0>`__.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?version=33699&projectId=17381>`__.
v1.5.0
------
*Released June 2, 2022*
- :issue:`MONGOSH-1138` – ``mongosh`` now supports Queryable Encryption.
- :issue:`MONGOSH-1169` – ``mongosh`` now supports FIPS-compliant mode.
- ``mongosh`` now uses Node.js version 16.x.
- ``mongosh`` no longer provides per-distribution ``mongosh`` linux packages. You
can still get .rpm, .deb and .tgz packages through your package manager
but the naming convention may change slightly.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=33985>`__.
v1.4.2
------
*Released May 17, 2022*
- :issue:`MONGOSH-1139` - Adds Debian 11 support for ``mongosh``.
- :issue:`MONGOSH-1183` - ``cursor.allowDiskUse()`` now accepts ``true``
or ``false``.
- :issue:`MONGOSH-1204` - Adds visual identifier for Queryable
Encyption collections in ``show collections``.
- :issue:`MONGOSH-1207` - Adds Queryable Encryption helpers.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=33637>`__.
v1.4.1
------
*Released May 12, 2022*
- :issue:`MONGOSH-1118` - Bundles and uses a CSFLE shared library in
place of ``mongocryptd``.
- :issue:`MONGOSH-1217` - Introduces partial support for Queryable
Encryption.
- :issue:`MONGOSH-1178` - Uses `Node.js driver 4.6.0
<https://github.com/mongodb/node-mongodb-native/releases/tag/v4.6.0>`__.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=33226>`__.
v1.3.1
------
*Released March 21, 2022*
- :issue:`MONGOSH-1163` - ``mongosh`` now uses Node.js 14.19.1. Node
14.19.1 includes an OpenSSL version that addresses
`CVE-2022-0778 <https://www.openssl.org/news/secadv/20220315.txt>`__.
v1.3.0
------
*Released March 17, 2022*
- :issue:`MONGOSH-856` - Kerberos feature parity with the legacy shell
is done now, with the last command line option now also working as it
did in the legacy shell.
- :issue:`MONGOSH-1013` - KMIP support for CSFLE. More specifically, you
can provide per-KMS-provider TLS options when creating your
CSFLE-enabled connections now.
- :issue:`MONGOSH-1151` - Support for snapshot reads, now also in
mongosh.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=33190>`__.
v1.2.3
------
*Released March 10, 2022*
- :issue:`MONGOSH-1121` - Support the ``commitQuorum`` parameter for the
:method:`~db.collection.createIndexes()` method.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=32989>`__.
v1.2.2
------
*Released February 25, 2022*
- :issue:`MONGOSH-1134` - Internal bug fix required to re-enable
Homebrew installation.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=32988>`__.
v1.2.1
------
*Released February 24, 2022*
- :issue:`MONGOSH-1063` - You can now create a global ``monogosh``
:ref:`configuration file <mongosh-shell-settings>`.
- :issue:`MONGOSH-959` – You can now use the :ref:`config.reset
<example-reset-setting>` method to reset a configuration setting to
the default value.
- :issue:`MONGOSH-1133` – ``mongosh`` adds a :option:`--tlsUseSystemCA`
option that causes ``mongosh`` to attempt to load system
certificates as well as the built-in certificates.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=32780>`__.
v1.1.9
------
*Released January 18, 2022*
New features in this release:
- :issue:`MONGOSH-1015` – ``mongosh`` no longer overrides ``appName`` if it
was present in the connection string.
- :issue:`MONGOSH-1073` – You can now pass BSON number objects to the
legacy BSON number constructors. For example,
``NumberInt(NumberInt(n))`` now works like it did in the legacy shell.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=32728>`__.
v1.1.8
------
*Released January 11, 2022*
New features in this release:
- ``mongosh`` now uses `Node.js driver 4.3.0
<https://github.com/mongodb/node-mongodb-native/releases/tag/v4.3.0>`__.
- Provides PGP signatures for uploaded tarballs.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=32594>`__.
v1.1.7
------
*Released December 14, 2021*
- ``mongosh`` now uses `Node.js driver 4.2.2
<https://github.com/mongodb/node-mongodb-native/releases/tag/v4.2.2>`__.
- Minor bug fixes.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=32512>`__.
v1.1.6
------
*Released December 2, 2021*
New features in this release:
- ``mongosh`` now uses `Node.js driver 4.2.1
<https://github.com/mongodb/node-mongodb-native/releases/tag/v4.2.1>`__.
Bug fixes in this release:
- Fixes the way ``try``, ``catch``, ``finally`` works if no exception
was thrown in the ``try`` block.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=32498>`__.
v1.1.5
------
*Released December 1, 2021*
Minor bug fixes.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=32485>`__.
v1.1.4
------
*Released November 24, 2021*
Minor bug fixes.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=32336>`__.
v1.1.2
------
*Released November 5, 2021*
New features in this release:
- ``mongosh`` now uses the following driver versions:
- `Node.js driver 4.1.4 <https://github.com/mongodb/node-mongodb-native/releases/tag/v4.1.4>`__.
- `Node.js BSON package 4.5.4
<https://github.com/mongodb/js-bson/releases/tag/v4.5.4>`__.
- ``mongosh`` release tarballs now include manpages.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=32313>`__.
v1.1.1
------
*Released October 28, 2021*
- Provides autocompletion for additional aggregation stages.
- Minor bug fixes.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=32226>`__.
v1.1.0
------
*Released October 7, 2021*
New features in this release:
- Adds support for the ``edit`` command and ``$EDITOR`` variable.
- Auto-complete for databases and collections is now case-insensitive.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=32095>`__.
v1.0.7
------
*Released September 22, 2021*
New features in this release:
``mongosh`` now uses the following driver versions:
- `Node.js driver 4.1.2 <https://github.com/mongodb/node-mongodb-native/releases/tag/v4.1.2>`__.
- `Node.js BSON package 4.5.2 <https://github.com/mongodb/js-bson/releases/tag/v4.5.2>`__.
- `Node.js BSON extension 4.0.1 <https://github.com/mongodb-js/bson-ext/releases/tag/v4.0.1>`__.
- `Node.js driver Kerberos addon 1.1.7 <https://github.com/mongodb-js/kerberos/releases/tag/v1.1.7>`__.
- `Node.js driver CSFLE addon 1.2.7 <https://github.com/mongodb/libmongocrypt/releases/tag/node-v1.2.7>`__.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?version=32032&projectId=17381>`__.
v1.0.6
------
*Released September 14, 2021*
New features in this release:
- You can now run :method:`sh.status()` when not connected to a
``mongos``, for example when connected to a
:manual:`config server </core/sharded-cluster-config-servers/>`.
- ``db.setSecondaryOk()``, ``mongo.setSecondaryOk()``, and
``rs.secondaryOk()`` methods are reintroduced but **deprecated**.
These methods alias to ``mongo.setReadPref()``.
- When you enter multiline input into the shell, single-line
``// comments`` are now preserved as ``/* comments */`` in the
history entry.
- The :ref:`aggregation-pipeline` parameter is now optional for
:method:`db.collection.watch()`, :method:`db.watch()`, and
:method:`Mongo.watch()`.
Bug Fixes in this Release:
- ``mongosh`` now runs aggregations with :pipeline:`$out` or
:pipeline:`$merge` immediately, and not lazily once the result of the
aggregation is accessed.
- Using the legacy ``NumberLong()`` method no longer truncates numbers
outside of the 32-bit range.
`Full release notes available on JIRA
<https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=17381&version=31793>`__.
v1.0.5
------
*Released August 12, 2021*
New features in this release:
- You can use ``config.set('maxTimeMS', <number>)`` to set a default
``maxTimeMS`` value for operations. ``maxTimeMS`` specifies a time
limit in milliseconds within which the operation must complete.
.. note::
``config`` settings persist across sessions.
- On Windows, you can start ``mongosh`` by double-clicking on the
``.exe`` file. When you do, ``mongosh`` prompts you for a connection
string to connect to your deployment.
- The log files created by ``mongosh`` follow the format of the
``mongod``, ``mongos``, or ``mongocryptd``. Meaning, the log files are
newline-delimited JSON with the same set of fields used by the server.
v1.0.4
------
*Released August 4, 2021*
New features in this release:
- ``mongosh`` now uses version ``4.1.0`` of the Node.js driver, with
full support for connections to load balancers and MongoDB Atlas
:atlas:`serverless instances </tutorial/create-new-serverless-instance/>`.
Bug fixes in this release:
- The ``Timestamp()`` argument order is now reversed compared to
previous ``mongosh`` versions.
v1.0.3
------
*Released July 29, 2021*
Bug fixes in this release:
- Passing the exit code to ``quit()`` works like it does in the legacy
shell.
- Instances of ``MaxListenersExceededWarning`` are no longer emitted
when methods like ``console.log()`` are used in loops.
- When an internal error in ``mongosh`` occurs, the error message
points you to the log file for the current ``mongosh`` session.
- When printing the name of a collection (such as in response to
``db.coll``), the database name is included in the output.
v1.0.1
------
*Released July 21, 2021*
New features in this release:
- Adds full support for the ``--host`` flag.
- Adds the ``--build-info`` flag which provides detailed information
about the ``mongosh`` version.
- When using Kerberos, ``mongosh`` will now make use of tokens if they
are still valid. You no longer need to specify a password when using
valid tokens.
Bug fixes in this release:
- An issue that sporadically resulted in an ``AcquireCredentialsHandle``
error on Kerberos was fixed.
- Miscellaneous other improvements.
v1.0
----
*Released July 9, 2021*
New features in this release:
- All the static methods of the Node.js driver BSON classes are now
available. Specifically, you can use
``ObjectId.createFromTime(unixTimestampSeconds)`` instead of the
legacy shell’s ``ObjectId.fromDate(dateObj)``.
- When connected to an Atlas deployment, the default ``mongosh`` prompt
displays ``Atlas`` instead of ``Enterprise``.
- The :manual:`cursor </tutorial/iterate-a-cursor/>` referred to when
using ``it`` is cleared when either ``db`` is reassigned or
``db.auth()`` / ``db.logout()`` is called.
- Minor bug fixes and improvements.
v0.15.4
-------
*Released July 1, 2021*
New features in this release:
- ``mongosh`` now color coordinates matching brackets.
v0.15.3
-------
*Released June 25, 2021*
New features in this release:
- ``mongosh`` now shows the current database name in prompt by default.
v0.15.1
-------
*Released June 22, 2021*
New features in this release:
- ``.tar`` and ``.zip`` ``mongosh`` download archives now include a
parent directory.
- Autocomplete is now aware of the ``--apiStrict`` flag. When
``--apiStrict`` is ``true``, autocomplete only completes methods
that work with your defined API version. For more information, see
:manual:`Stable API </reference/stable-api/>`.
- :ref:`Snippets <snip-overview>`. An experimental feature that
allows users to create custom shell extensions.
Bug fixes in this release:
- ``mongosh`` can now connect to a replica set containing unhealthy nodes.
v0.14.0
-------
*Released May 28, 2021*
New features in this release:
- When you run ``show collections``, the type of collection is shown in
the output.
- Adds ``sh.reshardCollection()`` for resharding support.
- Adds ``inspectCompact`` option to the
:ref:`configuration API <mongosh-shell-settings>` to print each
document field on its own line.
v0.13.1
-------
*Released May 18, 2021*
New features in this release:
- When you use ``Ctrl+C`` to interrupt an operation, you interrupt
operations that are running on the server, and not just local
JavaScript execution.
- :ref:`.editor <mdb-shell-multi-line>` sessions are aggregated into one
item in shell history.
- Build and publish packages for all platforms in the current MongoDB
5.0 server support matrix.
- Publish Windows MSI to the download center.
- Adds a customizable REPL prompt using ``prompt`` (or your
:ref:`.mongoshrc.js <mongoshrc-js>` file).
- When running against a MongoDB 5.0 deployment, shows reasons for
document validation failures.
- Adds basic support for the ``--apiStrict`` flag.
- New connection methods:
- :method:`Mongo.getDBNames()` returns a list of databases.
- :method:`Mongo.getDBs()` returns a document with a list of
databases and metadata.
v0.12.1
-------
*Released April 30, 2021*
New features in this release:
- Adds support for the :method:`db.hello()` shell method and
:dbcommand:`hello` database command. Use these commands in place of
``isMaster``.
- Extends the shell customization API to allow controlling log
verbosity.
- Adds autocomplete for ``show`` and ``use`` commands. For example,
``show collections`` and ``use test``.
Bug fixes in this release:
- :dbcommand:`collStats` now works properly on sharded collections.
v0.12.0
-------
*Released April 23, 2021*
- New async rewriter, allowing for a much wider range of JavaScript
features in the shell.
- Connection failure response is now more prompt if a connection
is deemed unlikely to succeed.
- Adds new API for shell customization.
v0.11.0
-------
*Released April 8, 2021*
Internal improvements and various bug fixes.
v0.10.1
-------
*Released April 1, 2021*
Internal improvements.
v0.10.0
-------
*Released March 31, 2021*
New features in this release:
- Support for loading a ``.mongoshrc.js`` file at startup. Use this
file to bootstrap the shell with customizations and extended
functionality.
- Ability to load scripts from the command line.
- Support for :option:`--eval <mongosh --eval>` option.
- Support for
:option:`--tlsCertificateSelector <mongosh --tlsCertificateSelector>`
on Windows and macOS.
Bug fixes in this release:
- Objects in :manual:`explain output </reference/explain-results/>` now
properly expand.
v0.9.0
------
*Released March 10, 2021*
New features in this release:
- Support for the :ref:`load() <mongosh-native-method-load>` method.
- Support for AWS IAM authentication.
Bug fixes in this release:
- Autocomplete works properly when connected to secondary node.
- :method:`db.createUser()` on ``$external`` database now handles
password properly.
- Miscellaneous other improvements.
v0.8.2
------
*Released February 24, 2021*
Minor internal improvements and bug fixes.
v0.8.1
------
*Released February 22, 2021*
Minor internal improvements and bug fixes.
v0.8.0
------
*Released February 17, 2021*
New features in this release:
- Support for :doc:`field-level-encryption`.
Bug fixes in this release:
- Running ``setReadConcern`` no longer reverses :method:`db.auth()`
authentication operations.
- Pressing the backspace key in the password prompt no longer adds an
asterisk, and now behaves as expected.
- Running ``UUID()`` without a value now generates a random UUID.
v0.7.7
------
*Released February 3, 2021*
New features in this release:
- :method:`~db.collection.explain()` support for the following methods:
- :method:`~db.collection.count()`
- :method:`~db.collection.distinct()`
- :method:`~db.collection.findAndModify()`
- :method:`~db.collection.remove()`
- :method:`~db.collection.update()`
- Support for specifying ``cursor.batchSize()``, and type ``it`` for
more.
- Autocomplete for collection names.
Bug fixes in this release:
- ``mongosh`` no longer fails when connecting to a node in the
``STARTUP2`` state.
- ``mongosh`` now properly displays startup warnings.
- :method:`~db.collection.explain()` on aggregations now return
accurate and complete results.
v0.6.1
------
*Released November 30, 2020*
New features in this release:
- Support for :manual:`readPreference </core/read-preference/>`
methods.
- Support for the :manual:`session object </reference/method/Session/>`
and related session object methods.
- Support for :manual:`transaction </core/transactions>` methods.
Bug fixes and miscellaneous updates in this release:
- Remove support for deprecated 3.6 CRUD methods (``insert()``,
``remove()``, ``save()``, and ``update()``).
- Fix an issue with loading JavaScript files into ``mongosh``.
- Fix an issue where when inserting many documents via a for loop,
the loop would abort before all documents were inserted.
- Fix issue with output when printing result of a cursor.
- Update the Node REPL to use Node version 14.
v0.5.2
------
*Released November 11, 2020*
- Autocomplete now works properly when connected to a MongoDB 4.4.1
deployment.
- The :method:`sh.status()` method now outputs correctly in the browser
shell.
v0.5.0
------
*Released October 12, 2020*
- Adds support for replica set management methods.
- Adds support for sharded cluster management methods.
v0.4.2
------
*Released October 1, 2020*
- Adds support for collection names with a dot. For example, to query
a collection named ``my.collection``, you can run:
.. code-block:: javascript
db.my.collection.findOne()
v0.4.0
------
*Released September 15, 2020*
- Adds support for the following methods:
- :method:`db.collection.mapReduce()`
- :method:`db.collection.validate()`
- Adds support for ``maxAwaitTimeMS`` for cursors.
v0.3.1
------
*Released September 14, 2020*
Improvements
~~~~~~~~~~~~
This release adds support for:
- New ``cursor`` methods
- Query ``planCache`` methods
- Error helper methods
- The following helper commands:
- ``show users``
- ``show profile``
- ``show logs``
- ``show log[<name>]``
This release includes an ``.rpm`` artifact which can be downloaded from
the `MongoDB Download Center
<https://www.mongodb.com/download-center/community?jmp=docs>`__.
Behavior Updates
~~~~~~~~~~~~~~~~
Whenever a command's output includes ``{ ok: 0 }``, ``mongosh`` throws
an exception and does not return the raw output from the server.
The legacy ``mongo`` shell error handling is not consistent between
commands. ``mongosh`` standardizes the user-facing behavior for a
more consistent experience.
Bug Fixes
~~~~~~~~~
- :issue:`MONGOSH-323 <MONGOSH-323>`: getUser() userId field is
outputted as binary.
- :issue:`MONGOSH-337 <MONGOSH-337>`: Linux tarball is not gzipped.
- :issue:`MONGOSH-341 <MONGOSH-341>`: Wrong values with NumberLong for
numbers > Number.MAX_SAFE_INTEGER. As a result of this fix, values
passed to ``NumberLong`` and ``NumberDecimal`` must be strings.
.. important::
The fix for :issue:`MONGOSH-341 <MONGOSH-341>` is a breaking
change when compared to behavior in the legacy ``mongo`` shell.
- :issue:`MONGOSH-346 <MONGOSH-346>`: ``Ctrl+C`` does not terminate the
currently running command in the shell.
.. note::
``Ctrl+C`` terminates the process in the shell, but does not
terminate the process on the MongoDB server.
v0.2.2
------