AnalyticDB for MySQLは、インタラクティブなデータ分析および開発プラットフォームを使用して、ジョブの編集、データ分析、およびデータの視覚化を特徴とするノートブック開発を提供します。 ノートブックエディターでは、SparkアプリケーションをSpark SQLおよびPython言語で記述できます。
前提条件
AnalyticDB for MySQLData Lakehouse Editionクラスターが作成されます。
最大コンピューティングリソースの8つ以上のAnalyticDBコンピューティングユニット (ACU) を持つジョブリソースグループが作成されます。 詳細については、「リソースグループの作成」をご参照ください。
AnalyticDB for MySQLクラスター用のデータベースアカウントが作成されます。
Alibaba Cloudアカウントを使用する場合は、特権アカウントを作成するだけで済みます。 詳細については、「データベースアカウントの作成」トピックの「特権アカウントの作成」セクションをご参照ください。
RAM (Resource Access Management) ユーザーを使用する場合は、特権アカウントと標準アカウントを作成し、標準アカウントをRAMユーザーに関連付ける必要があります。 詳細については、「データベースアカウントの作成」および「データベースアカウントの関連付けまたは関連付けの解除」をご参照ください。
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コンソールでこの機能を使用することはできません。
ノートブックの作成
AnalyticDB for MySQL コンソールにログインします。 ホームページの左上でリージョンを選択します。 左側のナビゲーションウィンドウで、クラスターリスト をクリックします。 クラスターリスト ページで、エディションタブをクリックします。 管理するクラスターを確認し、クラスター ID をクリックします。
左側のナビゲーションウィンドウで、[ジョブの開発] > [ノートブックの開発] を選択します。
[ノートブック開発] ページで、右上隅の [ノートブックの作成] をクリックします。
[ログ設定] ダイアログボックスで、ログパスの [デフォルト] または [カスタム] を選択し、[OK] をクリックします。
説明初めてノートブックを作成すると、Sparkランタイムログを保存するためのログパスが設定されているかどうかが確認されます。 ログパスを設定した場合、この手順はスキップされます。 それ以外の場合は、ダイアログボックスが表示されます。
[ノートブックの作成] パネルで、次の表に示すパラメーターを設定します。
パラメーター
説明
例
リソースグループ
ノートブックの作成に使用されるリソースグループ。 ドロップダウンリストからジョブリソースグループを選択します。 ジョブリソースグループは、次の要件を満たす必要があります。
リソースグループが実行中の状態です。
コンピューティングリソースの最大量は8 ACU以上です。
名前
ノートブックの名前。
長さは最大 64 文字です。
名前には、英数字、アンダースコア (_) 、およびハイフン (-) を使用できます。
名前は一意にする必要があります。
ノートブックテスト
説明
ノートブックの説明。
機能テスト
[OK]をクリックします。
ノートブックの開発
[ノートブックの開発] ページで、開発するノートブックの名前をクリックし、[段落] セクションで開発を実行します。
次の表では、[ノートブックの開発] ページのセクションとそのパラメーターについて説明します。
① メニューバー
パラメーター | 説明 | |
リソースグループ | リソースグループの作成 | ジョブリソースグループを作成できます。 詳細については、「リソースグループの作成」をご参照ください。 |
リソースグループの変更 | ノートブックのリソースグループを変更できます。 ノートブックのリソースグループを変更する前に、次の要件が満たされていることを確認してください。
重要 リソースグループの変更により、ノートブックカーネルが再起動します。 再起動プロセスの完了には約3分かかり、実行中のノートブックジョブはプロセス中に失敗します。 | |
カーネル | カーネルの再起動 | ノートブックカーネルを再起動できます。 再起動プロセスの完了には約3分かかり、実行中のノートブックジョブはプロセス中に失敗します。 |
カーネルを殺す | ノートブックカーネルを強制終了できます。 ノートブックカーネルを強制終了すると、実行中のノートブックジョブは失敗します。 |
② ツールバー
パラメーター | 説明 |
ノートブックジョブを保存できます。 ノートブックジョブを保存するには、次の方法もあります。
| |
段落を作成できます。 2つの段落の間の中央部分にポインターを移動して、[+ 段落の作成] をクリックすることもできます。 | |
すべての段落でコードを実行できます。 | |
すべての段落でコードの実行を一時停止できます。 重要 実行状態のノートブックジョブを一時停止することはできません。 | |
すべての段落の結果をクリアできます。 | |
ノートブックジョブの起動パラメータを設定できます。 詳細については、「Sparkアプリケーション設定パラメーター」をご参照ください。 例:
重要 ノートブックジョブの起動パラメーターを設定すると、ノートブックカーネルが再起動します。 再起動プロセスの完了には約3分かかり、実行中のノートブックジョブはプロセス中に失敗します。 |
③ ステータスバー
パラメーター | 説明 |
ノートブックジョブの保存ステータス。 システムは5秒間隔でノートブックジョブを保存します。 | |
ノートブックカーネルのステータス。 システムは、5秒間隔でノートブックカーネルのステータスを更新します。 有効な値:
|
④ 段落
次の表に、段落セクションのパラメーターを示します。
パラメーター | 説明 |
① | 実行中のステートメントを一意に識別し、課題を識別するために使用されるハンドルのID。 |
② | コード編集ボックス。 構文キーワードは自動的に強調表示され、Spark SQLおよびPython言語がサポートされます。 |
③ | 言語の切り替え、コードのフォーマット、コードの実行、コードの一時停止、結果のクリア、段落の削除を可能にするツールバー。
|
④ | 現在の段落の結果セクション。 コードの実行結果は、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 | ノートブックの段落を作成できませんでした。 |