Uploaded image for project: 'Drivers'
  1. Drivers
  2. DRIVERS-281

Rephrase unsupported/corrupt BSON messages

    • Type: Icon: Improvement Improvement
    • Resolution: Done
    • Priority: Icon: Major - P3 Major - P3
    • None
    • Component/s: None
    • Labels:
      None
    • $i18n.getText("admin.common.words.hide")
      Key Status/Resolution FixVersion
      PERL-606 Done BSON-v1.10.0
      PYTHON-1044 Done 2.9.2, 3.2.1
      PHP-1501 Done 1.6.13
      CDRIVER-1076 Done 1.4.0
      PHPC-554 Done 1.2.0-alpha1, 1.2.0
      RUBY-1084 Done 4.0.4, 12_01_17
      CSHARP-1546 Done 2.2.4
      PHPLIB-169 Done
      JAVA-2100 Done 3.2.2
      CXX-832 Done legacy-1.1.2
      CXX-833 Won't Do
      PERL-1040 Fixed BSON-XS-v0.6.0
      RUST-217 Fixed bson-0.15.0
      $i18n.getText("admin.common.words.show")
      #scriptField, #scriptField *{ border: 1px solid black; } #scriptField{ border-collapse: collapse; } #scriptField td { text-align: center; /* Center-align text in table cells */ } #scriptField td.key { text-align: left; /* Left-align text in the Key column */ } #scriptField a { text-decoration: none; /* Remove underlines from links */ border: none; /* Remove border from links */ } /* Add green background color to cells with FixVersion */ #scriptField td.hasFixVersion { background-color: #00FF00; /* Green color code */ } /* Center-align the first row headers */ #scriptField th { text-align: center; } Key Status/Resolution FixVersion PERL-606 Done BSON-v1.10.0 PYTHON-1044 Done 2.9.2, 3.2.1 PHP-1501 Done 1.6.13 CDRIVER-1076 Done 1.4.0 PHPC-554 Done 1.2.0-alpha1, 1.2.0 RUBY-1084 Done 4.0.4, 12_01_17 CSHARP-1546 Done 2.2.4 PHPLIB-169 Done JAVA-2100 Done 3.2.2 CXX-832 Done legacy-1.1.2 CXX-833 Won't Do PERL-1040 Fixed BSON-XS-v0.6.0 RUST-217 Fixed bson-0.15.0

      Soon – pretty very soon – MongoDB will be introducing new BSON types.
      Although old drivers may not be connecting to MongoDB versions using that BSON types, bson dump files and whatnot will eventually contain these types and these files shoved through old driver versions.

      Currently most drivers fail with very confusing error messages, especially if you are actually connected to a MongoDB supporting these types.

      This ticket is about unifying this error message to be more friendly and possibly alerting the user that newer drivers may support this type and the BSON may not actually be corrupt as currently reported.

      Detected unknown BSON type "\xTYPE" for fieldname "NAME". Are you using the latest driver version?

      Where

      • TYPE is the current field type
      • NAME is the current field name, if possible

      The type name should be represented in hex confirming to our BSON Spec convention '\x00'.

      The field name may not be possible to include in drivers, but drivers SHOULD make BEST EFFORT to include it. It helps our users a great deal as they could potentially project that field out as a poor mans workaround.
      It is not required to provide the fieldname using dotnotation for nested fields. The inner most fieldname is sufficient.

      Please ensure this is done for all currently actively - AND INACTIVELY - maintained drivers.

            Assignee:
            Unassigned Unassigned
            Reporter:
            bjori Hannes Magnusson
            Votes:
            0 Vote for this issue
            Watchers:
            6 Start watching this issue

              Created:
              Updated:
              Resolved: