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

AnalyticDB:ノートブックエディタ

最終更新日:Nov 25, 2024

AnalyticDB for MySQLは、インタラクティブなデータ分析および開発プラットフォームを使用して、ジョブの編集、データ分析、およびデータの視覚化を特徴とするノートブック開発を提供します。 ノートブックエディターでは、SparkアプリケーションをSpark SQLおよびPython言語で記述できます。

前提条件

  • AnalyticDB for MySQLData Lakehouse Editionクラスターが作成されます。

  • 最大コンピューティングリソースの8つ以上のAnalyticDBコンピューティングユニット (ACU) を持つジョブリソースグループが作成されます。 詳細については、「リソースグループの作成」をご参照ください。

  • AnalyticDB for MySQLクラスター用のデータベースアカウントが作成されます。

  • Object Storage Service (OSS) バケットが同じリージョンに作成され、AnalyticDB for MySQLクラスターと同じAlibaba Cloudアカウントに属しています。

  • AnalyticDB for MySQLは、AliyunADBSparkProcessingDataRoleロールを引き受けて他のクラウドリソースにアクセスする権限があります。 詳細については、「権限付与の実行」をご参照ください。

使用上の注意

ノートブック開発機能は2024年5月10日よりご利用いただけなくなります。

  • 2024年5月10日より前にノートブックを作成した場合でも、この機能を使用できます。

  • 2024年5月10日より前にノートブックを作成しなかった場合、AnalyticDB for MySQLコンソールでこの機能を使用することはできません。

ノートブックの作成

  1. AnalyticDB for MySQL コンソールにログインします。 ホームページの左上でリージョンを選択します。 左側のナビゲーションウィンドウで、クラスターリスト をクリックします。 クラスターリスト ページで、エディションタブをクリックします。 管理するクラスターを確認し、クラスター ID をクリックします。

  2. 左側のナビゲーションウィンドウで、[ジョブの開発] > [ノートブックの開発] を選択します。

  3. [ノートブック開発] ページで、右上隅の [ノートブックの作成] をクリックします。

  4. [ログ設定] ダイアログボックスで、ログパスの [デフォルト] または [カスタム] を選択し、[OK] をクリックします。

    説明

    初めてノートブックを作成すると、Sparkランタイムログを保存するためのログパスが設定されているかどうかが確認されます。 ログパスを設定した場合、この手順はスキップされます。 それ以外の場合は、ダイアログボックスが表示されます。

  5. [ノートブックの作成] パネルで、次の表に示すパラメーターを設定します。

    パラメーター

    説明

    リソースグループ

    ノートブックの作成に使用されるリソースグループ。 ドロップダウンリストからジョブリソースグループを選択します。 ジョブリソースグループは、次の要件を満たす必要があります。

    • リソースグループが実行中の状態です。

    • コンピューティングリソースの最大量は8 ACU以上です。

    (仕事) ノート

    名前

    ノートブックの名前。

    • 長さは最大 64 文字です。

    • 名前には、英数字、アンダースコア (_) 、およびハイフン (-) を使用できます。

    • 名前は一意にする必要があります。

    ノートブックテスト

    説明

    ノートブックの説明。

    機能テスト

  6. [OK]をクリックします。

ノートブックの開発

[ノートブックの開発] ページで、開発するノートブックの名前をクリックし、[段落] セクションで開発を実行します。

book123

次の表では、[ノートブックの開発] ページのセクションとそのパラメーターについて説明します。

① メニューバー

パラメーター

説明

リソースグループ

リソースグループの作成

ジョブリソースグループを作成できます。 詳細については、「リソースグループの作成」をご参照ください。

リソースグループの変更

ノートブックのリソースグループを変更できます。 ノートブックのリソースグループを変更する前に、次の要件が満たされていることを確認してください。

  • リソースグループはジョブタイプです。

  • リソースグループが実行中の状態です。

  • コンピューティングリソースの最大量は8 ACU以上です。

重要

リソースグループの変更により、ノートブックカーネルが再起動します。 再起動プロセスの完了には約3分かかり、実行中のノートブックジョブはプロセス中に失敗します。

カーネル

カーネルの再起動

ノートブックカーネルを再起動できます。 再起動プロセスの完了には約3分かかり、実行中のノートブックジョブはプロセス中に失敗します。

カーネルを殺す

ノートブックカーネルを強制終了できます。 ノートブックカーネルを強制終了すると、実行中のノートブックジョブは失敗します。

② ツールバー

パラメーター

説明

保存

ノートブックジョブを保存できます。 ノートブックジョブを保存するには、次の方法もあります。

  • システムは5秒間隔でノートブックジョブを保存します。

  • Ctrl + Sキーを押すと、ノートブックジョブを保存できます。

新增段落

段落を作成できます。 2つの段落の間の中央部分にポインターを移動して、[+ 段落の作成] をクリックすることもできます。添加段落

运行代码

すべての段落でコードを実行できます。

暂停运行

すべての段落でコードの実行を一時停止できます。

重要

実行状態のノートブックジョブを一時停止することはできません。

清除

すべての段落の結果をクリアできます。

设置

ノートブックジョブの起動パラメータを設定できます。 詳細については、「Sparkアプリケーション設定パラメーター」をご参照ください。

例:

{
        "spark.driver.resourceSpec": "small",
        "spark.executor.instances": 2,
        "spark.executor.resourceSpec": "small",
        "spark.adb.eni.vswitchId":"vsw-bp14pj8h0k5p0kwu3****",
        "spark.adb.eni.securityGroupId": "sg-bp14qrdskvwnzels****",
        "spark.hadoop.hive.metastore.uris": "thrift://192.168.XX.XX:9083"
    }
重要

ノートブックジョブの起動パラメーターを設定すると、ノートブックカーネルが再起動します。 再起動プロセスの完了には約3分かかり、実行中のノートブックジョブはプロセス中に失敗します。

③ ステータスバー

パラメーター

説明

保存成功

ノートブックジョブの保存ステータス。 システムは5秒間隔でノートブックジョブを保存します。

kernel

ノートブックカーネルのステータス。 システムは、5秒間隔でノートブックカーネルのステータスを更新します。 有効な値:

  • 未启动(Kernel Not Started ): ノートブックカーネルが起動していません。 [カーネル]> [カーネルの再起動] を選択すると、ノートブックカーネルを再起動できます。

  • 空闲(Kernel Idle ): ノートブックカーネルはアイドル状態で、ノートブックジョブを実行できます。

  • 启动中(Kernel Starting ): ノートブックカーネルが起動中です。 後でもう一度試すことができます。

  • 作业较多(Kernel Busy ): ノートブックカーネルは大量のコードを実行しています。 後でもう一度試すことができます。

  • 启动错误(カーネルエラー ): ノートブックカーネルで起動エラーが発生しました。 後で再試行するか、ノートブックカーネルを再起動できます。

  • karnel已失效(Kernel Invalid ): ノートブックカーネルが無効です。 ノートブックカーネルを再起動できます。

  • kernel已销毁(Kernel Killed ): ノートブックカーネルが殺されました。 ノートブックカーネルを再起動できます。

  • 状态未知(Kernel Unknown ): ノートブックカーネルのステータスが不明です。 ノートブックカーネルを再起動できます。

④ 段落

duanluo

次の表に、段落セクションのパラメーターを示します。

パラメーター

説明

実行中のステートメントを一意に識別し、課題を識別するために使用されるハンドルのID。

コード編集ボックス。 構文キーワードは自動的に強調表示され、Spark SQLおよびPython言語がサポートされます。

言語の切り替え、コードのフォーマット、コードの実行、コードの一時停止、結果のクリア、段落の削除を可能にするツールバー。

  • 下拉框: Spark SQLとPythonの間で言語を切り替えることができます。

  • 格式化: Spark SQLコードのみをフォーマットできます。

  • 运行: 現在の段落でコードを実行できます。

  • 取消: 現在の段落でコードの実行を一時停止できます。

  • 清空: 現在の段落の結果をクリアできます。

  • 删除: 現在の段落を削除できます。

現在の段落の結果セクション。 コードの実行結果は、Spark SQLの場合はテーブル形式で表示され、他の言語の場合はテキスト形式で表示されます。

現在の段落のステータスバーで、実行ステータス、実行時間、最新の更新時刻が含まれます。

エラーコード

エラーコード

エラーメッセージ

解決策

Console.NotebookNamingDuplicate

ノートブック名は既に存在します。

別のノートブック名を指定します。

Console.NotebookParagraphNotRunning

ノートブックコードは実行されません。

ノートブックコードを実行します。

Console.NotebookParagraphMissingProgramCode

ノートブックの段落にはプログラムコードがありません。

ノートブックの段落にプログラムコードを記述します。

Console.NotebookKernelNotStartup

ノートブックカーネルが起動されていません。

ノートブックカーネルを起動します。

Spark.NotebookKernelStarting

ノートブックカーネルが起動中です。

しばらくしてからもう一度お試しください。

Spark.NotebookKernelBusy

ノートブックカーネルには、実行保留中の大量のコードが含まれています。

しばらくしてからもう一度お試しください。

Spark.NotebookKernelExpired

ノートブックカーネルの有効期限が切れています。

ノートブックカーネルを再起動します。

Spark.NotebookKernelInvalidStatus

ノートブックカーネルが無効です。

ノートブックカーネルを再起動します。

Spark.GetNotebookKernelFailed

ノートブックカーネルの起動に失敗しました。

テクニカルサポートに連絡してください。

Spark.GetNotebookKernelStateFailed

ノートブックカーネルのステータスの照会に失敗しました。

Spark.ExecuteNotebookStatementFailed

ノートブックコードの実行に失敗しました。

Spark.CancelNotebookStatementFailed

ノートブックコードの実行を一時停止できませんでした。

Spark.GetNotebookStatementResultFailed

ノートブックコードの結果の照会に失敗しました。

Spark.CloseNotebookKernelFailed

ノートブックカーネルのシャットダウンに失敗しました。

Console.NotebookNotFound

作成したノートブックが見つかりません。

Console.NotebookCreateFailed

ノートブックの作成に失敗しました。

Console.NotebookParagraphNotFound

ノートブックの段落が見つかりません。

Console.NotebookParagraphCreateFailed

ノートブックの段落を作成できませんでした。