Codatum Docs

Appearance

Export and import ​

You can export the content of a notebook as a file, and use an exported file to restore pages or create a new notebook. Exported files can be used as backups or with the Codatum CLI.

Export ​

From the menu in the header inside a notebook, select Export to export in the following formats.

MenuFormatDescription
Export.ymlExports the entire notebook as a file. Use this file for the import steps below.
Export as Markdown file.cnb.mdA notebook file format usable with the Codatum CLI (available in workspaces where the Codatum CLI is enabled).
Export as SQL files.zipExports SQL blocks as .sql files. See the README.md in the output for details.
Export as dbt project.zipExports SQL blocks as a dbt project. See the README.md in the output for details.

Import ​

Import an exported .yml file into either of the following destinations.

  • Import as a new notebook
  • Add pages to the open notebook

In both cases, after you select the file, choose the pages to import under Target pages. All pages are selected by default. Clear the pages you don't need, then select Import.

Import as a new notebook ​

  1. In the folder tree in the left sidebar of the notebook list, open Add notebook or folder.
  2. Select Import from file.
  3. Select Select file and choose the .yml file.
  4. Under Target pages, select the pages to import.
  5. Check the Fallback connection, then select Import.

A new notebook is created that contains only the selected pages.

Add pages to an existing notebook ​

  1. Open the destination notebook.
  2. From the menu in the header, select Import pages.
  3. Select Select file and choose the .yml file.
  4. Under Target pages, select the pages to add.
  5. Check the Fallback connection, then select Import.

The selected pages are appended to the open notebook.

Fallback connection ​

This is the replacement connection used when a connection specified in the notebook isn't available. If you enable Force replace all, every connection is replaced with the fallback connection, regardless of availability.

TIP

You can still export a notebook that has become uneditable because it exceeds the size limit. Import only the pages you need into a new notebook to keep editing.

© Codatum Inc.