Before you begin
- Choose the import method that fits your use case. Supported file types vary by method.
- Your file includes a timestamp column in a supported timestamp format.
- You know which Asset and Run the data belongs to, or are prepared to create new ones.
How data file import works
Importing a file creates a Run under an Asset in Sift. An Asset represents the system that generated the data, such as a vehicle or test rig. A Run is a single data collection session. During import, you map the file’s timestamp column and data columns to Channels. You do not need to import every column, only map the ones you intend to analyze. You can use an existing Asset and Run or create new ones during import. If a mapping is wrong or a timestamp format is misidentified, you can archive the Run and reimport without affecting the Asset or other Runs.Import a file using the UI
- On the Sift homepage, click Import data.
- Select your file.
- Configure the import settings. See Import file settings for a full description of each setting.
- Click Upload.
Import a file using the REST API
- Send a configuration request to the
CreateDataImportFromUploadendpoint with your API key. The endpoint accepts a format-specific configuration object depending on your file type.- Remote URL: To import a file from a remote URL instead of uploading it directly, use the
CreateDataImportFromUrlendpoint.
- Remote URL: To import a file from a remote URL instead of uploading it directly, use the
- Upload the file using the returned
uploadUrl. - Optional: Verify the upload using the returned
dataImportId.
Import a file using the Python client
- Install the Python client.
- Configure the client with your API key and Sift URL.
- Upload the file using the appropriate upload service for your format. For code examples, see the Sift public repository.
Import a file using the Sift CLI
Use thesift-cli import command to import a file from the command line. See the Sift CLI getting started guide to learn more.