Uploaded image for project: 'Couchbase Documentation'
  1. Couchbase Documentation
  2. DOC-6902

6.6 Documentation needed for new Import UI

    XMLWordPrintable

Details

    • Improvement
    • Resolution: Unresolved
    • Major
    • 6.6.0
    • 6.6.0
    • ui
    • None
    • DOC-2020-S11-Jun14, DOC-2020-S12-Jun28
    • 1

    Description

      The 6.6 release includes a new UI feature for importing data into Couchbase. This feature should be described in the documentation.

      Important details are:

      • The Import panel is accessible as a sub-tab of the Documents section. (see first screen shot)
      • This feature is intended to be an easier-to-use alternative to cbimport, though it is about 10x slower and can't handle files > 100MB (and it's pretty slow on files > 30MB).
      • The Import UI can import files in the following formats: tab-separated, comma-separated, JSON, with one JSON document per line in the file, and a JSON list. The user selects a file, and the format is automatically detected. If, however, the detection is wrong, the user can select a different format.
      • After the file is parsed by the UI, the resulting JSON documents are shown, either as a table (default) or raw JSON. If the user wants to verify the original data file, that is viewable also.
      • If the user is happy with how the data was parsed, they then need to select a destination bucket, and what to use for the imported documents IDs. The choices are either a UUID or a single field from data. The menu shows only those fields that are present in every document. (Unlike the screen shots, I have changed the label "GUID" to "UUID" to match the terminology used by cbimport.)
      • Because the UI is about 10x slower than cbimport, the UI also shows the equivalent cbimport command syntax if the user wants to do the import that way.
      • Once the user clicks the "import" button, status is shown in a label below the button. If the import takes a long time, the label on the button changes to "cancel", and the user can cancel the import using that button.

      Attachments

        1. import-button.png
          import-button.png
          8 kB
        2. Import-cbimport-command.png
          Import-cbimport-command.png
          20 kB
        3. import-doc-id.png
          import-doc-id.png
          21 kB
        4. import-file-selector.png
          import-file-selector.png
          114 kB
        5. import-formats.png
          import-formats.png
          15 kB
        6. import-initial-ui.png
          import-initial-ui.png
          303 kB
        7. import-json-data2.png
          import-json-data2.png
          134 kB
        8. import-json-table.png
          import-json-table.png
          431 kB
        9. import-raw-data2.png
          import-raw-data2.png
          273 kB
        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

        Activity

          People

            tony.hillman Tony Hillman (Inactive)
            eben Eben Haber
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:

              Gerrit Reviews

                There are no open Gerrit changes

                PagerDuty