Obtaining a snapshot

Before you can write and run queries to analyze a project, you need a snapshot of that project. Each snapshot contains a database for a single language and a copy of the code to show your query results on. If a project uses multiple languages, then you can have a snapshot for each language.

Here are a few ways to obtain a snapshot to use in QL for Eclipse:

Downloading a snapshot from LGTM

You can download snapshots to analyze in the licensed version of QL for Eclipse from any project that is visible to you in LGTM Enterprise using the Integrations tab on the project page. The QL snapshot for local analysis section contains the available snapshots for each language that has been detected.

You can also download snapshots from any project on LGTM.com for analysis in both the free-to-use and licensed versions of QL for Eclipse.


You may find that some snapshots available to download from LGTM.com have been built by a more recent analysis process than the one available in your licensed version of QL for Eclipse. If this is the case, you may not be able to run queries against these snapshots.

However, even if a new snapshot is not compatible with your licensed version of QL for Eclipse, you can still analyze it using the most recent free-to-use version of QL for Eclipse. If you do want to install both the free-to-use and licensed versions of QL for Eclipse, we recommend that you use separate Eclipse installations, so that you still can use both versions to analyze snapshots.

Once you have a snapshot, see Importing a snapshot to find out how to use it in QL for Eclipse.

Exporting a database using the QL command-line tools

If you use the licensed QL for Eclipse, you can also create a snapshot locally using the QL command-line tools. You can convert this snapshot into the correct format for QL for Eclipse using the export command. For more information, see Exporting data for QL plugins and extensions and LGTM in the QL command-line tools help.

What next?

Once you have obtained and imported a snapshot, you are ready to start running QL queries.

To find out more about snapshots, and how they are created, see What is a snapshot?

Related Topics Link IconRelated Topics