DataWorks:パーソナルディレクトリ

パーソナルファイルの作成

Personal Directory で、Show My Nodes Only をクリックし、ツールバーの アイコンをクリックして、パーソナル SQL ファイルをすばやく作成します。デフォルトでは、以下の 4 種類のファイルを直接作成および実行できます。

• .sql：SQL ファイル

• .ipynb：ノートブック ファイル

• .py：Python ファイル

• .sh：Shell ファイル

Show My Nodes Only をクリックし、ツールバーの Create File アイコンをクリックして、その他の形式のパーソナルファイルを作成することもできます。ファイル作成時には、ファイルタイプを決定するためにファイル拡張子を指定する必要があります。

ローカルファイルの追加

デフォルトの Show My Nodes Only ディレクトリに加えて、ご利用のローカルフォルダ（およびその中のファイルやコードリポジトリ）を直接 Personal Directory に追加できます。

• 方法 1：ツールバーの アイコンをクリックしてローカルフォルダをパーソナルディレクトリに追加し、追加するフォルダを選択します。

  重要

  パーソナル開発環境が有効になっていない場合、「ローカル」とはご利用のローカルマシンを指し、この操作にはブラウザがローカルファイルを読み取る権限を付与する必要があります。パーソナル開発環境が有効になっている場合、「ローカル」とはパーソナル開発環境インスタンスを指します。

• 方法 2：ローカルファイルディレクトリで右クリックし、コンテキストメニューから Add On-premises Folder を選択します。

  不要になったフォルダは、該当フォルダを右クリックし、コンテキストメニューから Delete を選択して削除できます。この操作により、フォルダはパーソナルディレクトリから削除されますが、元の場所からは完全に削除されません。

パーソナルファイルの共有

Show My Nodes Only からファイルまたはフォルダを他のワークスペースまたはクラウドアカウントユーザーと共有できます。これにより、チームメンバーがご利用のアドホッククエリファイルを閲覧できるようになります。

1. Show My Nodes Only で、共有したいファイルまたはフォルダを右クリックし、コンテキストメニューから Share を選択します。

2. Share ダイアログボックスで、以下のパラメーターを設定します。

   パラメーター	説明
   共有方法	共有先のタイプを選択します。 ワークスペース：指定したワークスペースとファイルを共有します。そのワークスペースのすべてのメンバーがファイルを閲覧できます。 クラウドアカウント：指定したクラウドアカウントユーザーとファイルを共有します。
   共有範囲	選択した共有方法に基づき、現在のテナント内の対象ワークスペースまたはクラウドアカウントを選択します。複数選択できます。

共有ファイルの閲覧

他のユーザーがパーソナルファイルをあなたのワークスペースまたはクラウドアカウントと共有した場合、そのファイルはあなたのパーソナルディレクトリ内の 共有ファイル（読み取り専用） セクションで閲覧できます。

• 共有ファイルは共有者のユーザー名ごとにグループ化されています。ユーザー名を展開すると、そのユーザーが共有しているファイルの一覧を表示できます。

• 共有ファイルは読み取り専用です。編集、削除、名前の変更はできません。

ファイルの検索

パーソナルディレクトリでは、ノードをすばやく検索する複数の方法を提供しており、検索効率を向上させ、データの管理および開発をより効果的に行えるように支援します。

方法 1：パーソナルディレクトリ内で実行

この方法は、日常的な開発、テスト、アドホッククエリに最適です。開発中に小さなコードスニペットが期待どおりに動作するかテストする必要がある場合は、パーソナルディレクトリ内に一時ファイルを作成してテストを実行できます。

1. 実行パラメーターの設定

   • パーソナルディレクトリで実行したい Shell、Python、または SQL ファイルを見つけ、ファイルをクリックしてエディターで開きます。Run Configuration パネル（右側）で、タスクの実行パラメーターを設定します。

     パラメーター	説明
     Type	ファイルを実行するために必要な計算リソースのタイプを選択します。
     Compute Resource	現在のワークスペースにバインドされている計算リソースを選択します。
     Resource Group	ファイルを実行するために使用するリソースグループを選択します。

   • ノートブックファイルはパーソナル開発環境内で実行する必要があります。詳細については、「基本的なノートブック開発」をご参照ください。

2. コードの実行とデバッグ

   ファイルエディターページで、ツールバーの アイコンをクリックしてタスクを実行します。

方法 2：プロジェクトディレクトリに送信

パーソナルディレクトリ内のコードを本番環境で定期的にスケジュール実行する必要がある場合は、プロジェクトディレクトリに送信できます。これにより、ファイルからスケジュールノードが作成され、プロジェクトのワークフロー内で定期タスクとして管理できるようになります。

1. 送信プロセスの開始

   パーソナルディレクトリでプロジェクトディレクトリに送信したいファイルを見つけ、ファイル名をダブルクリックして開きます。ファイルエディター上部のツールバーで、 アイコンをクリックしてファイルをプロジェクトディレクトリに送信します。

2. 送信パラメーターの設定

   構成	説明
   Type	プロジェクトディレクトリ内でファイルから作成されるノードタイプを選択します。システムは現在のファイルタイプに一致するノードタイプを自動的に選択します。 SQL ファイル：デフォルトで MaxCompute SQL ノードとして送信されます。 ノートブックファイル：デフォルトでノートブックノードとして送信されます。 Python ファイル：デフォルトで Python ノードとして送信されます。 Shell ファイル：デフォルトで Shell ノードとして送信されます。
   Path	プロジェクトディレクトリ内のノードの保存パスを選択します。
   Name	パーソナルファイルの名前をノード名として使用するか、新しい名前を入力します。

方法 3：リソースまたは関数として送信

Data Studio では、パーソナルディレクトリの .py ファイルを MaxCompute リソースまたは関数として送信し、データ開発ノードで使用できます。

1. 送信プロセスの開始

   パーソナルディレクトリで送信したい .py ファイルを見つけ、ファイル名をダブルクリックして開きます。ファイルエディター上部のツールバーで、 アイコンの横にあるドロップダウンメニューをクリックし、Submit as Function または Submit as Resource を選択します。

2. 送信パラメーターの設定

   構成	説明
   Type	Submit as Function を選択した場合、タイプはデフォルトで MaxCompute Function になります。 Submit as Resource を選択した場合、タイプはデフォルトで MaxCompute Python になります。
   Path	Resource Management 内のリソースまたは関数のパスを選択します。デフォルトパスは /（ルートディレクトリ）です。パスを変更するには、事前に Resource Management でディレクトリを手動で作成し、ここで選択する必要があります。
   Submission Type	Create：Resource Management の指定パスに新しい関数またはリソースを作成します。このオプションを選択する場合、リソースまたは関数の Name を指定する必要があります。 Associate With Existing File：送信を既存のリソースまたは関数に関連付けます。このオプションを選択する場合、Existing Resource を指定する必要があります。 既存の関数に関連付ける場合、現在の .py ファイルの Python コードが、元の関数の Code を置き換えます。 既存のリソースに関連付ける場合、現在の .py ファイルの内容が、リソースの既存の Document Content を置き換えます。

3. Confirm をクリックし、画面の指示に従ってプロセスを完了します。

   • Submission Type を Create に設定した場合、対応するリソースまたは関数の作成ページに移動します。

   • Submission Type を Associate With Existing File に設定した場合、既存の関数またはリソースのエディターページに移動します。

   MaxCompute 関数およびリソースの構成パラメーターの詳細については、「MaxCompute リソースおよび関数」をご参照ください。