Dataphin でノートブックセルを管理および使用する - Dataphin

サポートされている Markdown 構文

Markdown セルは、基本および拡張 Markdown 構文をサポートしています。

以下の構文は、現時点ではサポートされていません。

HTML
Definition Lists
Emoji
Highlight
Subscript
Superscript

Markdown セル

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

エリア

説明

① アクションバー

Markdown セルを選択すると、以下のアクションバー操作を利用できます。

[セルの切り替え]：セルタイプを Markdown、SQL、またはデータベース SQL に変更します。
[セルの追加]：現在のセルの下に、新しい Markdown、SQL、またはデータベース SQL セルを追加します。
[セルのコピー]：現在のセルのコピーをその下に作成します。
[セルの移動]：現在のセルを上下に移動します。
[セルの削除]：現在のセルを削除します。

② 編集エリア

編集エリアで、Markdown 構文を使用してノートブックコンテンツを記述します。

SQL セル

SQL セルを使用して、コンピューティングエンジン用の SQL コードを記述および実行します。

説明

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

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

エリア

説明

① アクションバー

SQL セルを選択すると、以下のアクションバー操作を利用できます。

[実行]：セル内の SQL コードを実行します。
[クエリ高速化]：MAXCOMPUTE_SQL、HIVE_SQL、IMPALA_SQL、および SPARK_SQL セルでサポートされています。クエリ高速化を有効にした後、高速化方式を選択する必要があります。
- 高速化ソース：高速化ソースを使用してクエリを高速化します。この方式では、高速化ソースとリソースグループを選択する必要があります。
  - 高速化ソース：現在のプロジェクトのコンピューティングソースに紐付けられている高速化ソースを選択します。利用可能な高速化ソースがない場合は、[Create Acceleration Source] をクリックして作成します。
  - リソースグループ (オプション)：選択した高速化ソース配下で設定されたリソースグループを選択します。
  説明
  - 高速化ソースを使用する場合、アドホッククエリは選択したソースタイプの構文に従います。SQL ステートメントが準拠していることを確認してください。たとえば、StarRocks 高速化ソースは StarRocks 構文を使用します。
  - 高速化ソースを使用したクエリでは、クエリごとに一時テーブルは作成されません。
- MCQA： MaxCompute クエリ高速化。テナントレベルのジョブおよび同時実行クエリの制限により、高速化が失敗またはエラーになる場合があります。クエリ高速化 (MCQA)。MCQA を無効にするには、[管理センター] > [システム設定] > [DataStudio] > [クエリ高速化] に移動します。
利用可能な高速化方式は、コンピューティングエンジンとシナリオによって異なります。

現在のテナントが MaxCompute コンピューティングエンジンを使用している場合：
- クエリ高速化が購入されておらず、DataStudio で有効になっている場合、高速化方式は MCQA です。
- クエリ高速化が購入されており DataStudio で有効になっているものの、プロジェクトのコンピューティングソースが高速化ソースに紐付けられていない場合、高速化方式は MCQA です。
- クエリ高速化が購入されており、プロジェクトのコンピューティングソースが高速化ソースに紐付けられている場合、いずれかの方式を選択できます。
現在のテナントが Hadoop コンピューティングエンジンを使用している場合：クエリ高速化が購入されており、プロジェクトクラスタのコンピューティングソースが高速化ソースに紐付けられている場合、高速化方式は高速化ソースです。
[セルの折りたたみ]：セルのコードエリアを折りたたみます。
[SQL のフォーマット]：セル内の SQL コードをフォーマットします。
[セルの切り替え]：SQL セルを Markdown、SQL、またはデータベース SQL タイプに切り替えます。

説明
コンピューティングエンジンが Impala が有効な Hive インスタンスに紐付けられている場合、Impala SQL と Hive SQL を切り替えることができます。
[セルの追加]：現在の SQL セルの下に、Markdown セル、SQL セル、またはデータベース SQL セルなど、別のセルを追加します。
[セルのコピー]：現在の SQL セルのコピーをその下に作成します。
[セルの移動]：現在の SQL セルを上下に移動します。
[セルの削除]：現在の SQL セルを削除します。

② 編集エリア

編集エリアで、コンピューティングエンジン用の SQL コードを記述できます。

データベース SQL セル

データベース SQL セルを使用して、データソースに対する SQL コードを記述および実行します。

エリア

説明

① アクションバー

データベース SQL セルを選択すると、以下のアクションバー操作を利用できます。

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

説明
デフォルトでは、データベース SQL セルの実行には、分析プロジェクトのデフォルトリソースグループではなく、選択したデータソースで設定されたデフォルトリソースグループが使用されます。
[セルの折りたたみ]：現在のデータベース SQL セルのコードエリアを折りたたみます。
[SQL のフォーマット]：現在のデータベース SQL セル内の SQL コードをフォーマットします。
[セルの切り替え]：データベース SQL セルを Markdown、SQL、またはデータベース SQL タイプに切り替えます。
[セルの追加]：現在のセルの下に、Markdown、SQL、またはデータベース SQL セルを追加します。分析プラットフォームでサポートされるデータソース。
[セルのコピー]：現在のデータベース SQL セルのコピーをその下に作成します。
[セルの移動]：現在のデータベース SQL セルを上下に移動します。
[セルの削除]：現在のデータベース SQL セルを削除します。
データソースの選択：SQL コードの実行に使用するデータソース (外部データソースを含む) を選択します。
カタログ：Presto および Trino データソースの場合、カタログを選択する必要があります。
データベース/スキーマ：以下のデータソースタイプの場合、データベースまたはスキーマを選択する必要があります：MySQL、PostgreSQL、Hologres、AnalyticDB for PostgreSQL、OceanBase (Oracle テナントモード)、Lindorm、Oracle、ClickHouse、DM、openGauss、StarRocks、Doris、SelectDB、Presto、GaussDB (DWS)、Trino、PolarDB-X 2.0、および OushuDB。

② 編集エリア

編集エリアで、データベース SQL コードを記述できます。

[実行] をクリックすると、参照されているすべてのオブジェクトに対する権限が検証されます。いずれかのチェックに失敗すると、アクセスできないオブジェクトの一覧がダイアログボックスに表示されます。

ダイアログボックスには、以下の詳細が表示されます。

オブジェクト名：権限のないオブジェクトの名前。
オブジェクトタイプ：テーブルまたはグローバル変数。
権限タイプ：スクリプトを実行するために必要な権限。たとえば、テーブルにはデータクエリ権限が必要であり、データソースには実行権限が必要です。
操作：必要な権限を申請します。
- 単一オブジェクト: [操作] 列のアイコンをクリックして権限を申請します。デフォルトの有効期間は 30 日です。
- 複数のオブジェクト: 対象のオブジェクトを選択するか、[すべてのテーブルを選択] をクリックし、[権限を申請] をクリックします。
権限を申請。権限が付与された後、コードを再度実行します。

説明
MySQL および Oracle データソースのみが、テーブルレベルの権限制御に対応しています。