Skip to main content
Use the cdf data download command to download data from Cognite Data Fusion (CDF) to your local machine. This command provides multiple subcommands for downloading different types of data, including raw tables, assets, time series, events, files, hierarchies, instances, and charts. All subcommands have an interactive prompt if you do not specify any arguments, making it easy to select what you want to download.

Prerequisites

Before downloading data, ensure you have:
  • Installed and configured the Cognite Toolkit.
  • Authenticated with CDF using appropriate credentials.
  • Read permissions for the data you want to download.
  • Sufficient disk space for the downloaded files.

Download data

1

Run the interactive download

To download data interactively, run the command for your specific data type without arguments. For example, for raw tables:
cdf data download raw
Follow the prompts to select which raw tables you want to download.
2

Specify resources directly (pptional)

Alternatively, you can specify the resources directly in the command line. For example, to download specific tables from a database:
cdf data download raw my_table1 my_table2 --database my_database

Supported data types

The following data types are currently supported for download:
  • Raw tables
  • Assets
  • Time series
  • Events
  • Files
  • Hierarchies (assets, events, time series, and files)
  • Instances
  • Charts
For an up-to-date list of available data types and their arguments, use the cdf data download --help command.

Further reading