Note: This documentation is for the legacy command-line tool odasa.
The final version was released in May 2020. Support for this tool expires in May 2021.

For documentation on the new generation CodeQL CLI, see CodeQL CLI .
In particular, you may find the Notes for legacy QL CLI users useful in planning your migration.

Skip to end of metadata
Go to start of metadata



Use the updateExternalData tool to update the external data stored in a snapshot database from the data stored in the external/data subdirectory of the snapshot directory without rebuilding the entire snapshot database. This is particularly useful when you are experimenting with importing external data into a snapshot database or importing snapshot metadata.


This tool is run from the command line as follows:

odasa updateExternalData [--verbose] [--verbosity <level>] 
 [--project <path>] [--concurrent] [--earliest] [--latest]
 [--ram <memory>] [--delete-relations <file.rel>] <snapshot>


The updateExternalData tool supports the following flags:


Optional. Output more detailed information about actions. This increases the verbosity to level 4.

Default: level verbosity


Optional. Define the precise level of reporting required where 0 suppresses all output and 6 reports all levels of detail available. You can use the --verbose flag as shorthand for --verbosity 4 .

Default: 3


Optional, defines the location of the project configuration file to use with the --earliest or --latest flag.

Default: current directory.

--concurrent--Optional, used in special cases where you need to allow more than one command to act on a single snapshot concurrently. This flag should not be used unless the support team have advised you to do so.

Optional, use to update the oldest snapshot for the project configuration defined using the --project flag. Alternatively, define a snapshot to update.

--latest--Optional, use to update the most recent snapshot for the project configuration defined using the --project flag. Alternatively, define a snapshot to update.

Optional, use to define the <ram> element for the update command.

The value is assumed to be defined in 1024-based megabytes unless a unit is specified. Units are case insensitive.
 Show valid units...
  • k or kb—kilobytes, the value will be rounded to the nearest megabyte
  • m or mb—megabytes, the default unit if none is specified
  • g or gb—gigabytes
  • t or tb—terabytes

sample.relRecommended for internal use only.
<snapshot>-revision-2015-May-24--14-47-01Optional, defines the name of the snapshot to update.


All CSV files stored in the external/data subdirectory of the snapshot directory are imported into the snapshot database, overwriting any existing external data stored in the snapshot.