Dataphin:コンピュートタスク

エリア

説明

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

コンピュートタスクディレクトリは、作成したコンピュートタスクを集中管理する場所を提供します。ディレクトリは、次の管理操作をサポートしています：

• ディレクトリツールバー：[フィルター]、[更新]、[フォルダの作成]、[特定] をサポートしています。デフォルトでは、[権限のあるディレクトリ] フィルターが選択されており、現在のユーザーがアクセスできる第 1 レベルのディレクトリのみが表示されます。このオプションの選択を解除すると、すべてのディレクトリが表示されます。

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

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

  権限管理: Data Management-ディレクトリ権限管理権限を持つプロジェクトロールとディレクトリ管理者のみが、1 次ディレクトリの権限を管理できます。 [権限管理] をクリックすると、[可視性設定] を [パブリック] または [指定されたメンバーのみ] に設定できます。 [指定されたメンバーのみ] を選択した場合は、[ディレクトリ管理者] と [表示メンバー] も指定する必要があります。 構成が完了すると、他のメンバーは開発、O&M、またはリリース中にディレクトリ内のタスクを表示できません。

  説明

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

• コンピュートタスク：[ロックの取得]、[編集]、[クローン]、[名前の変更]、[移動]、[削除]、[非アクティブ化]、[非アクティブ化して削除]、[所有プロジェクトの変更] をサポートしています。

  重要

  • 基本モードプロジェクトの場合、削除リクエストが正常にコミットされると、システムは即座に変更を本番環境に適用します。この操作は慎重に実行してください。

  • 開発-本番モードプロジェクトの場合、削除リクエストが正常にコミットされた後、リリース待ちリストに移動してオブジェクトを本番環境にリリースします。

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

②ツールバー

ツールバーには、[保存]、[事前コンパイル]、[実行]、[パラメーターを指定して実行]、[コミット]、[リリースに移動]、[フォーマット]、[更新]、[ロックの取得]、[特定]、[非アクティブ化]、[非アクティブ化して削除] などの操作があります。

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

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

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

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

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

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

• 実行：現在のコンピュートタスクを実行します。一度パラメーターを設定すると、その後の実行で再入力する必要はありません。

  現在のユーザーに、関連テーブルに対する必要な[行レベルの権限]がない場合、「権限チェックに失敗しました」というダイアログボックスが表示され、不足している権限が一覧表示されます。[権限を申請]をクリックして、[管理センター] > [権限管理] > [マイ権限] > [行レベルの権限]ページを開き、必要な権限を申請します。権限が付与された後、タスクを再実行します。

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

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

• リリースに移動：リリースセンターにコミットされたタスクについては、リリースセンター に移動してリリースします。

  プロジェクトの本番アカウントが関連テーブルに対して必要な行レベルの権限を持っていない場合、システムはリリースをブロックし、不足している権限をリストアップしたエラーを表示します。セキュリティ管理者に連絡して権限を付与してもらい、その後タスクを再度リリースしてください。

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

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

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

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

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

• 削除、非アクティブ化して削除：現在のコンピュートタスクを削除または非アクティブ化して削除します。

  重要

  • 基本モードプロジェクトの場合、削除リクエストが正常にコミットされると、システムは即座に変更を本番環境に適用します。この操作は慎重に実行してください。

  • 開発-本番モードプロジェクトの場合、削除リクエストが正常にコミットされた後、リリース待ちリストに移動してオブジェクトを本番環境にリリースします。

③エディター

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

• エディターショートカットリスト。

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

④設定と管理

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

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

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

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

    • リアルタイムモード設定の概要。

    • オフラインモード設定の概要。

• 関連：オフラインコンピュートタスクの場合、その関連オブジェクトを表示できます。関連オブジェクトには、タスクが読み取るテーブル、タスクから読み取るテーブル、および現在のタスクを上流依存関係として持つタスクが含まれます。詳細については、「タスクの関連オブジェクトの表示と管理」をご参照ください。

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

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

⑤コンソール

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

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

セクション

説明

① 一般的なコンソール操作

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

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

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

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

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

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

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

② 実行結果の操作

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

• [単一行の詳細]：[単一行の詳細] をクリックすると、各行がフィールドと値のセットとして表示されます。前、次、最初、または最後の行にすばやく移動できます。テーブルビューに戻るには、[リストビュー] をクリックします。

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

• コンテンツ検索： アイコンをクリックして、入力されたキーワードに一致するコンテンツをテーブル全体で検索します。

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

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

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

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