Create and edit notebooks

Create a remote notebook

1. In the Big Data Tools window, right-click any of the configured servers, folder, or note and select Create Note from the context menu or press Alt+Insert.

   

2. In the Create note dialog, enter the name of the notebook. You can use the / symbol to create a notebook within a folder. Click OK.

   

   The newly added notebook appears in the Big Data Tools window.

   

Create a local notebook

1. In the Project tool window, select the project root, press Alt+Insert, and select Zeppelin Notebook.

   

2. In the Create Zeppelin Notebook dialog, enter the notebook name and press Enter.

   

   The newly added local notebook appears in the Project tool window.

   

Search for a notebook

1. Select a target Zeppelin connection in the Big Data Tools window.

2. Click in the Big Data Tools tool window or press Control+F.

3. Type anything in the search box of the Find in window. The matching notebooks will be shown in the list of findings.

   

Work with paragraphs

• Press Enter and start editing your notebook right away.

  IntelliJ IDEA enables coding assistance to facilitate editing and validating code:

  • Code completion helps you complete the names of classes, functions, and variables. Start typing the name of the code construct, and the suggestion list appears.

    

    

    In SQL statements, you can use completion for table and columns names if your Zeppelin server is connected to a database, a Hive Metastore, or an AWS Glue platform.

    

    The completion is based on available schemas that you can disable and enable in the View | Tool Windows | Database tool window.

  • Renaming (Shift+F6) local variables or private methods can be done easily inline since only the limited scope is affected. Renaming classes or public methods could potentially impact a lot of files. Preview potential changes before you refactor.

    

  • The Extract Method (Control+Alt+M) refactoring lets you take a code fragment that can be grouped together, move it into a separated method and replace the old code with a call to the method.

    

    If you have any Scala class in your project, you can extract the Spark method from the note into this class. Select the method code in the note editor, right-click, and select Refactor | Extract Spark Method. Then specify the target Scala class, declare the method, and press Refactor to complete the task.

  • The Find Usages action (Alt+F7) allows you to search for the references of your code element throughout the entire notebook.

    

  • With code inspections, IntelliJ IDEA analyzes your code, searches for ways to optimize it, and detects potential and actual problems. You can always press Alt+Enter to show intention actions and select an available fix.

    

  • You can navigate to the initial declaration of a symbol and symbol's type from its usage. Select a variable and press Control+B.

    

  • For quick navigation between the notebook paragraphs and code constructs, use the Structure tool window. Press Alt+7 to toggle its visibility.

    

  Any time you need to clone, move, or delete the current paragraph, just click to open a menu and select the required action.

  

  You are not limited to adding only Scala code paragraphs. For example, to add any Markdown code, just add %md to the first line of the paragraph or %sql for an SQL statement.

Export and import notebooks

• To import a notebook, right-click any directory, note, or Zeppelin connection node in the Big Data Tools window and select Upload from Disk from the context menu. Specify a path to the target .json or .zpln file.

• To export a notebook, right-click any notebook on a Zeppelin server in the Big Data Tools window and select Save to Disk from the context menu. Specify a path to the directory where you want to save the exported notebook.

Preview notebook contents using minimap

The minimap shows thumbnails of your code next in the editor. You can use it to quickly navigate and preview your code.

• On the right side of your notebook, click to enable or disable the minimap.

  

Preview notebooks in a browser

1. To preview your notebook in the external browser, click on the notebook editor toolbar and select the corresponding option.

   

2. If needed, you can copy the link to the notebook to the clipboard.

Export notebook content into HTML

1. To export your notebook into an HTML file, click on the notebook toolbar and select Export Note Code to HTML.

   

2. Specify the filename and its location in your file system, then confirm the action.

   If you save an HTML file in your project directory, the file appears in the Project tool window. To open it, right-click the file and select a target browser from the menu Open In | Browser.

1. On the notebook editor toolbar, click .

2. In the Interpreter Bindings dialog, use the arrow buttons to alter the priority of an interpreter.

   

You can also deselect an interpreter and explicitly disable it or restart any interpreter when, for example, the corresponding session got expired.