すべてのプロダクト
Search
ドキュメントセンター

Dataphin:Notebook セルの管理

最終更新日:Nov 20, 2025

Notebook セルは、Notebook でコンテンツを構築するために使用される基本的なコンポーネントです。セルを Notebook に追加して、コンテンツを作成および整理できます。セルの種類によって、サポートされる操作や機能が異なります。このトピックでは、各セルタイプのシナリオと管理操作について説明します。

背景情報

Markdown セルでサポートされている Markdown 構文の詳細については、「https://www.markdownguide.org/extended-syntax/」および「https://www.markdownguide.org/basic-syntax/」をご参照ください。

以下の構文はサポートされていません。

  • HTML

  • 定義リスト

  • 絵文字

  • ハイライト

  • 下付き文字

  • 上付き文字

Markdown セル

Markdown セルを使用して、標準の Markdown 構文で Notebook にテキストコンテンツを追加できます。

image

領域

説明

操作領域

Markdown セルをクリックして選択すると、操作エリアで管理できます。操作には、セルタイプの切り替え、現在のセルの下へのセルの追加、セルのコピー、セルの上への移動、セルの下への移動、セルの削除が含まれます。

  • セルの切り替え: 現在の Markdown セルを、Markdown セル、SQL セル、データベース SQL セルなど、別のタイプに切り替えます。

  • セルの追加: 現在の Markdown セルの下に、Markdown セル、SQL セル、データベース SQL セルなどの別のセルを追加します。

  • セルのコピー: 現在の Markdown セルの下に、同じ内容のコピーを作成します。

  • セルの移動: 現在の Markdown セルの位置を変更します。上に移動したり、下に移動したりできます。

  • [セルを削除]: 現在の Markdown セルを削除します。

編集領域

編集エリアで、Markdown 構文を使用して Notebook のコンテンツを作成します。Markdown 構文の詳細については、「Markdown 構文」をご参照ください。

SQL セル

SQL セルを使用して、Notebook でコンピュートエンジン SQL 文を追加して実行できます。

説明

Hadoop コンピュートエンジンの Spark SQL セルの場合、一時テーブルを作成するときに、[管理センター] > [システム設定] > [開発者プラットフォーム] > [テーブル管理設定] で指定されたデフォルトのストレージフォーマットが使用されます。

たとえば、デフォルトのストレージフォーマットが [hudi] に設定されている場合、一時テーブルを作成するときに using hudi 文が追加されます。デフォルトのストレージフォーマットが [エンジンデフォルト] に設定されている場合、一時テーブルを作成するときにストレージフォーマットは指定されません。

image

領域

説明

操作領域

SQL セルをクリックして選択すると、操作エリアで管理できます。操作には、SQL コードの実行、クエリの高速化、セルの折りたたみ、SQL のフォーマット、セルタイプの切り替え、セルの追加、セルのコピー、セルの移動、セルの削除が含まれます。

  • [実行]: 現在の SQL セル内の SQL コードを実行します。

  • [クエリ高速化]: MAXCOMPUTE_SQL、HIVE_SQL、IMPALA_SQL、および SPARK_SQL セルはクエリの高速化をサポートしています。クエリの高速化を有効にした後、高速化メソッドを選択します。

    • 高速化ソース: 高速化ソースを使用してクエリを高速化します。このメソッドを選択した場合は、高速化ソースとリソースグループも選択する必要があります。

      • 高速化ソース: 現在のプロジェクトのコンピュートソースにアタッチされている高速化ソースを選択します。利用可能な高速化ソースがない場合は、[高速化ソースの作成] をクリックして作成ページに移動し、必要に応じて作成します。

      • リソースグループ (オプション): 選択した高速化ソースの下で設定されたリソースグループを選択します。

      説明
      • 高速化メソッドとして [高速化ソース] を選択した場合、ランタイムは選択された高速化ソースタイプの構文に基づいて SQL 文を実行します。SQL 文が構文仕様に準拠していることを確認してください。たとえば、高速化ソースタイプが StarRocks の場合、アドホッククエリノードは StarRocks 構文に基づいて実行されます。

      • 高速化ソースを使用してクエリを高速化する場合、クエリごとに一時テーブルは作成されません。

    • MCQA: MaxCompute Query Acceleration (MCQA)。テナントごとに、MCQA にはジョブ数と同時ジョブ数に制限があります。これにより、高速化が失敗したり、実行エラーが発生したりする可能性があります。詳細については、「クエリ高速化 (MCQA)」をご参照ください。[管理センター] > [システム設定] > [開発者プラットフォーム] > [クエリ高速化] で MCQA 高速化を無効にできます。

    サポートされている高速化メソッドは、コンピュートエンジンとシナリオによって異なります。

    現在のテナントが MaxCompute コンピュートエンジンを使用している場合:

    • クエリ高速化を購入していないが、開発者プラットフォームで有効にしている場合、高速化メソッドは MCQA です。

    • クエリ高速化を購入し、開発者プラットフォームで有効にしており、現在のプロジェクトのコンピュートソースが高速化ソースにアタッチされていない場合、高速化メソッドは MCQA です。

    • クエリ高速化を購入し、プロジェクトのコンピュートソースが高速化ソースにアタッチされている場合、高速化メソッドとして [高速化ソース] または [MCQA] を選択できます。

    現在のテナントが Hadoop コンピュートエンジンを使用している場合: クエリ高速化を購入し、プロジェクトのコンピュートソースに対応するクラスターが高速化ソースにアタッチされている場合、高速化メソッドは [高速化ソース] です。

  • [セルを折りたたむ]: 現在の SQL セルのコード領域を折りたたみます。

  • [SQL をフォーマット]: 現在の SQL セル内の SQL コードをフォーマットします。

  • セルの切り替え: 現在の SQL セルを、Markdown セル、SQL セル、データベース SQL セルなど、別のタイプに切り替えます。

    説明

    コンピュートエンジンが Impala が有効になっている Hive インスタンスにアタッチされている場合、Impala SQL と Hive SQL を切り替えることができます。

  • セルの追加: 現在の SQL セルの下に、Markdown セル、SQL セル、データベース SQL セルなどの別のセルを追加します。

  • セルのコピー: 現在の SQL セルの下に、同じ内容のコピーを作成します。

  • セルの移動: 現在の SQL セルの位置を変更します。上に移動したり、下に移動したりできます。

  • [セルを削除]: 現在の SQL セルを削除します。

編集領域

編集エリアでコンピュートエンジン SQL を作成します。

データベース SQL セル

データベース SQL セルを使用して、Notebook でデータベース SQL 文を追加して実行できます。

image

エリア

説明

操作エリア

データベース SQL セルをクリックして選択すると、操作エリアで管理できます。操作には、データベース SQL コードの実行、セルの折りたたみ、SQL のフォーマット、セルタイプの切り替え、セルの追加、セルのコピー、セルの移動、セルの削除が含まれます。

  • [実行]: 現在のデータベース SQL セル内の SQL コードを実行します。

    説明

    データベース SQL ランタイムは、分析プロジェクトのデフォルトのリソースグループではなく、選択したデータソースで設定されたデフォルトのリソースグループをデフォルトで使用します。

  • [セルの折りたたみ]: 現在のデータベース SQL セルのコードエリアを折りたたみます。

  • [SQL のフォーマット]: 現在のデータベース SQL セル内の SQL コードをフォーマットします。

  • セルの切り替え: 現在のデータベース SQL セルを、Markdown セル、SQL セル、データベース SQL セルなど、別のタイプに切り替えます。

  • [セルの追加]: 現在のデータベース SQL セルの下に、Markdown セル、SQL セル、データベース SQL セルなどの別のセルを追加します。データベース SQL セルは、MySQL、AnalyticDB for PostgreSQL、AnalyticDB for MySQL 2.0、AnalyticDB for MySQL 3.0、Oracle、Presto、PostgreSQL、StarRocks、ClickHouse、GaussDB (DWS)、Doris、SelectDB、Microsoft SQL Server、Hologres、openGauss、DM、OceanBase、Trino、および PolarDB-X 2.0 をサポートしています。

  • セルのコピー: 現在のデータベース SQL セルの下に、同じ内容のコピーを作成します。

  • セルの移動: 現在のデータベース SQL セルの位置を変更します。上に移動したり、下に移動したりできます。

  • [セルの削除]: 現在のデータベース SQL セルを削除します。

  • データソースの選択: 外部データソースを含むデータソースを選択して、SQL コードを実行します。

  • カタログ: Presto および Trino データソースの場合、カタログを選択する必要があります。

  • データベース/スキーマ: AnalyticDB for PostgreSQL、Oracle、Presto、GaussDB (DWS)、Microsoft SQL Server、Hologres、openGauss、DM、OceanBase (Oracle テナントモード)、Trino、および PolarDB-X 2.0 データソースの場合、データベース/スキーマを選択する必要があります。

編集エリア

編集エリアでデータベース SQL を作成します。

データベース SQL コードの編集が完了したら、[実行] をクリックします。システムはコード内のすべてのオブジェクトを解析して、現在のユーザーがオブジェクトに必要な操作権限を持っているかどうかを確認します。権限検証が成功した場合、ユーザーは必要な権限を持っています。権限検証が失敗した場合、ユーザーは必要な権限を持っておらず、ユーザーが権限を持っていないオブジェクトのリストがダイアログボックスに表示されます。

権限検証に失敗したダイアログボックスには、オブジェクト名、オブジェクトタイプ、権限タイプ、および操作情報が表示されます。

  • オブジェクト名: 権限がないオブジェクトの名前。

  • オブジェクトタイプ: テーブルとグローバル変数。

  • 権限タイプ: スクリプトを実行するために必要な権限。データソーステーブルの場合、テーブルデータをクエリする権限のみが必要です。データソースの場合、実行権限のみが必要です。

  • 操作: オブジェクトのチェックに失敗した場合、1 つ以上のオブジェクトの権限をリクエストできます。

    • 単一オブジェクトの権限をリクエストする: ターゲットオブジェクトの [アクション] 列で、image.png アイコンをクリックしてそのオブジェクトの個人権限をリクエストします。デフォルトの有効期間は 30 日です。

    • バッチで権限をリクエストする: 複数のオブジェクトを選択するか、[すべてのテーブルを選択] を選択してから [権限のリクエスト] をクリックします。

    権限のリクエスト方法の詳細については、「権限のリクエスト」をご参照ください。権限が付与された後、コードを再度実行できます。

    説明

    MySQL および Oracle データソースのみがテーブルレベルの権限コントロールをサポートしています。