Create a notebook

更新时间: 2026-06-12 06:25:15

This topic explains how to create a notebook on the Dataphin analysis platform.

Permissions

You can select only Dev or Basic projects in your account. The project must be bound to an offline engine, and you must have permission to run ad-hoc queries in the project.

Procedure

  1. In the top navigation bar of the Dataphin console, choose Analyze > Notebook.

  2. In the notebook list, click the image..png icon to open the Create Notebook dialog box.

  3. In the Create Notebook dialog box, configure the following parameters.

    Parameter

    Description

    Notebook Name

    The name can be up to 256 characters long and cannot contain the following characters: vertical bars (|), forward slashes (/), backslashes (\), colons (:), question marks (?), angle brackets (<>), asterisks (*), or double quotation marks (").

    Directory

    Select a directory to store the notebook.

    If a directory does not exist, you can create a new folder. Follow these steps:

    1. Above the notebook list on the left side of the page, click the image icon to open the New Folder dialog box.

    2. In the New Folder dialog box, enter a Name for the folder and optionally select a location.

    3. Click OK.

  4. Click OK to create the notebook.

Multi-engine environments

When you create a notebook in a multi-engine environment, if you select Project Data, you must also select an Execution Project, which involves selecting a cluster and a project. Other parameters are the same as in a single-engine environment. For details about the other parameters, see the preceding sections.

  • Cluster: You can select a cluster from the current tenant or select the Cluster-less Project option. You cannot change the cluster after creating the notebook.

  • Project: Select a project from the selected cluster or a dedicated analysis project. Dedicated analysis projects are named {Cluster Name} Analysis Project for clusters and Cluster-less Independent Analysis Project for cluster-less environments.

After you select an execution project, the engine type of the selected project appears at the bottom of the page.

Next steps

After you create a notebook, you can edit and manage it. To learn more, see Edit and manage a notebook.

上一篇: Create a notebook based on the analytics platform 下一篇: Manage notebook cells
阿里云首页 智能数据建设与治理 Dataphin 相关技术圈