Dataphin:コンピュートタスク

セクション

説明

①コンピュートタスクディレクトリ

すべてのコンピュートタスクはタスクディレクトリで管理されます。ディレクトリは、次の管理操作をサポートしています：

• ディレクトリツールバー：タスクの [フィルター]、[更新]、[新規フォルダー] の作成、[特定] が可能です。デフォルトでは、[権限のあるディレクトリ] フィルターが選択されており、権限を持つトップレベルディレクトリのみが表示されます。このオプションの選択を解除すると、すべてのディレクトリが表示されます。

• コンピュートタスクの作成： アイコンをクリックしてコンピュートタスクを作成します。利用可能なタスクタイプはコンピュートエンジンによって異なります。サポートされているタスクのリストについては、ページのオプションをご参照ください。マルチエンジンモードでは、作成できるコンピュートタスクの種類は、プロジェクトのコンピュートソースエンジンタイプに依存します。

• ディレクトリ：[権限管理] (トップレベルディレクトリのみ)、[新規フォルダー]、[名前の変更]、[移動]、[削除] をサポートしています。

  権限管理：`Data Management-ディレクトリ権限管理` 権限を持つプロジェクトロールとディレクトリ管理者のみが、トップレベルディレクトリの権限を管理できます。[権限管理] をクリックすると、[可視性設定] を [パブリック] または [指定されたメンバーのみ] に設定できます。[指定されたメンバーのみ] を選択した場合は、[ディレクトリ管理者] と [可視メンバー] も指定する必要があります。構成後、他のメンバーは開発、運用保守 (O&M)、またはリリースでディレクトリ内のタスクを表示できなくなります。

  説明

  リアルタイムタスクはディレクトリの権限管理をサポートしていません。

• コンピュートタスク：[ロックの取得]、[編集]、[クローン]、[名前の変更]、[移動]、[削除]、[オフラインにする]、[オフラインにして削除]、[所有プロジェクトの変更] をサポートしています。

  重要

  • 基本モードプロジェクトの場合、削除操作をコミットすると、タスクは本番環境から直ちに削除されます。注意して進めてください。

  • 開発・本番モードプロジェクトの場合、削除操作をコミットした後、保留中のリリースリストから本番環境に変更をリリースする必要があります。

• [コンピュートタスクリスト]：コンピュートタスクリストをクリックして、リストビューでコンピュートタスクを管理します。

②ツールバー

ツールバーは、保存、事前コンパイル、実行、パラメーターを指定して実行、コミット、リリースに移動、フォーマット、更新、ロックの取得、特定、オフラインにする、オフラインにして削除などの操作をサポートしています。

• バージョンの切り替え：Python タスクの場合、実行バージョンを切り替えることができます。Python 2.7、Python 3.7、Python 3.11 がサポートされています。

• データソースの切り替え：データベース SQL タスクの場合、タスクのデータソースを切り替えることができます。

• データベース/スキーマの切り替え：データベースタイプが AnalyticDB for PostgreSQL、Oracle、Presto、MySQL、StarRocks、Doris、SelectDB、ClickHouse、または OceanBase (MySQL モード) のデータベース SQL タスクの場合、データソースのデータベース/スキーマを切り替えることができます。

• カタログの切り替え：データベースタイプが Presto または Trino のデータベース SQL タスクの場合、データソースのカタログを切り替えることができます。

• 保存：現在のコンピュートタスクを保存します。

• 事前コンパイル：現在のコンピュートタスクを事前コンパイルします。

• 実行：現在のコンピュートタスクを実行します。実行パラメーターを構成した場合、それらは後続の実行で再利用されます。

  テーブルに必要な行レベルの権限がない場合、[権限チェックに失敗しました] ダイアログボックスが表示されます。[権限のリクエスト] アイコンをクリックして、[管理センター] > [権限管理] > [マイパーミッション] > [行レベルの権限] ページに移動します。権限リクエストが承認された後、タスクを再度実行できます。

• パラメーターを指定して実行：既存のパラメーターを使用せずにタスクを実行します。実行するたびに実行パラメーターを再入力する必要があります。

• コミット：コンピュートタスクをリリースセンターまたは運用保守センター (O&M センター) にコミットします。

• リリースに移動：リリースセンターにコミットされたタスクは、リリースセンターからリリースできます。

  プロジェクトの本番アカウントにテーブルに対する必要な行レベルの権限がない場合、システムはリリースをブロックし、権限の詳細を含むメッセージを表示します。タスクをリリースする前に、セキュリティ管理者に連絡して権限を付与してもらう必要があります。

• 運用保守に移動：運用保守センター (O&M センター) にコミットされたタスクは、運用保守センター (O&M センター)で操作を実行できます。詳細については、「運用保守センター (O&M センター)」をご参照ください。

• フォーマット：SQL タスクの場合、コードをフォーマットできます。

• 更新：現在のコンピュートタスクを更新します。

• ロックの取得：コンピュートタスクの編集ロックを取得します。

• 特定：現在のコンピュートタスクをタスクディレクトリで特定します。

• 削除、オフラインにして削除：現在のコンピュートタスクを削除またはオフラインにして削除します。

  重要

  • 基本モードプロジェクトの場合、削除操作をコミットすると、タスクは本番環境から直ちに削除されます。注意して進めてください。

  • 開発・本番モードプロジェクトの場合、削除操作をコミットした後、保留中のリリースリストから本番環境に変更をリリースする必要があります。

③エディタ

コードエディタでコンピュートタスクを開発します。さまざまなキーボードショートカットと生産性向上機能をサポートしています。詳細については、以下をご参照ください：

• エディタのキーボードショートカット。

• エディタのコード効率。

④構成と管理

コンピュートタスクのプロパティ構成、関連オブジェクト、履歴、データリネージを構成および管理します。

• プロパティ構成：コンピュートタスクのプロパティを構成します。プロパティはタスクタイプによって異なります。

  • オフラインコンピュートタスクのプロパティ構成については、「オフラインパイプラインタスクのプロパティ構成」をご参照ください。

  • リアルタイムコンピュートタスクのプロパティ構成については、以下をご参照ください：

    • リアルタイムモードの構成概要。

    • オフラインモードの構成概要。

• 関連：オフラインコンピュートタスクの場合、コンピュートタスクが読み取るテーブル、下流プロセスが読み取るテーブル、現在のタスクに依存するタスクなどの関連オブジェクトを表示できます。詳細については、「関連オブジェクトの表示と管理」をご参照ください。

• 履歴：タスクの履歴バージョンを表示および管理します。詳細については、「リアルタイムタスクの履歴バージョンの表示と管理」をご参照ください。

• データリネージ：Python、Shell、仮想コンピュートタスクの場合、カスタムデータリネージを定義できます。詳細については、「カスタムリネージ構成」をご参照ください。

⑤コンソール

タスクを実行または事前コンパイルすると、実行ログと結果がコンソールに表示されます。

SQL クエリコンピュートタスクの場合、コンソールには `実行結果`、`ログ`、`コード` の 3 つのタブが含まれます。詳細については、「SQL クエリコンピュートタスクのコンソール」をご参照ください。

エリア

説明

①コンソールの操作

• 実行結果の表示：コンソールの左側にある アイコンをクリックして、現在のタスクの実行結果を表示します。

• ログの表示：コンソールの左側にある アイコンをクリックして、現在の実行のログを表示します。

• コードの表示：コンソールの左側にある アイコンをクリックして、現在のタスクのコードを表示します。

• 複数の実行結果の表示と管理：コンソールの右上隅にある アイコンをクリックして、タスクの複数の実行結果を表示します。

• 全画面：コンソールの右上隅にある アイコンをクリックして、コンソールを全画面に展開します。

• コンソールの展開/コンソールの折りたたみ：右上隅の または アイコンをクリックして、コンソールを展開または折りたたみます。コンソールの上端にカーソルを合わせてドラッグしてサイズを変更することもできます。

• コンソールの折りたたみ/コンソールの表示：下部にある [コンソールの折りたたみ] をクリックしてコンソールを非表示にします。折りたたんだ後、[コンソールの表示] をクリックして再度表示できます。

②実行結果の操作

• 列の検索とフィルター：[列の検索とフィルター] をクリックして、現在のテーブルのすべての列名のドロップダウンリストを開きます。列名の横にある アイコンをクリックして、その列を特定してハイライト表示し、見やすくします。リストを使用して表示する列をフィルターすることもできます。選択した列は結果テーブルに表示され、選択解除した列は非表示になります。

• 行の詳細：[行の詳細] をクリックして、各行をフィールドと値のペアのシリーズとして表示します。前、次、最初、または最後の行に移動できます。[リストビュー] をクリックしてテーブル形式に戻ります。

• 列幅の自動調整：結果テーブルの各列の幅を手動で調整できます。[列幅の自動調整] をクリックして、すべての列のコンテンツの長さに応じて自動的にサイズを変更します。

• コンテンツ検索： アイコンをクリックして、テーブル全体でキーワードを検索します。

• データのダウンロード： アイコンをクリックし、[サンプルデータのダウンロード] または [全データのダウンロード] を選択します。詳細については、「結果データのダウンロード」をご参照ください。

• 行列の入れ替え： アイコンをクリックして、現在のテーブルの行と列を入れ替えます。

• 単一列のデータのフィルターとソート：列名の横にある アイコンをクリックして、その列のデータをフィルターまたはソートします。この機能は、結果テーブルのすべての列で利用できます。

• すべて選択：テーブルの左上隅にあるセル をクリックして、ヘッダー行を含むテーブル全体を選択します。その後、右クリックしてテーブル全体をコピーできます。