Personal Directory - DataWorks - Alibaba Cloud ドキュメントセンター

Personal Directory は、コードを保存・管理・デバッグできる非公開スペースです。この環境では、個人用ファイルや開発プロジェクトを作成・管理できます。

概要

Personal Directory では、ファイルを「My Files」と「Local Files」の 2 つのカテゴリに分類して整理します。以下に各カテゴリについて説明します。

ディレクトリタイプ	ストレージディレクトリ	ストレージプロバイダー	ストレージパス	端末への直接アクセス
My Files	Personal Directory 内のデフォルトディレクトリです。	DataWorks	N/A	いいえ
Local Files	個人開発環境インスタンスを使用する場合、そのインスタンスがデフォルトのストレージディレクトリになります。説明最初に個人開発環境インスタンスを作成する必要があります。	個人開発環境インスタンスにデータセットが指定されている場合、ストレージプロバイダーはそのデータセットに設定された NAS サービスになります。	個人開発環境インスタンスの作成時に指定されます。	はい
		個人開発環境インスタンスにデータセットが指定されていない場合、ストレージプロバイダーは DataWorks になります。	`/mnt/workspace/.virtual_documents`	はい
	個人開発環境を使用していない場合、ご利用のローカルマシンから Personal Directory にパスを追加できます。	ご利用のローカルマシン	パスは、ローカルフォルダを追加する際に選択した内容によって決まります。	いいえ

ファイルの種類

Personal Directory では任意のタイプのファイルを作成できます。ただし、実行可能なファイルタイプは以下のとおりです。

.ipynb： Notebook ファイル
.sh： Shell ファイル
.py： Python ファイル
.sql： SQL ファイル

説明

Personal Directory では、Visual Studio Code がサポートする他のプログラミング言語のファイルも読み書きできます。ただし、DataWorks はこれらのファイルタイプに対して構文ハイライト、開発環境、実行サポートなどの機能を提供しません。

前提条件

ワークスペースが作成され、それに計算リソースが関連付けられています。詳細については、「ワークスペースを作成する」および「計算リソースを関連付ける」をご参照ください。
リソースグループを作成し、対象のワークスペースにバインド済みである必要があります。

Personal Directory へのアクセス

DataWorks コンソールのワークスペースページに移動します。上部ナビゲーションバーで目的のリージョンを選択し、目的のワークスペースを見つけ、操作列で ショートカット > Data Studio を選択します。
DataStudio ページで、左側ナビゲーションウィンドウのアイコンをクリックします。表示されるデータ開発ページで、左側のディレクトリツリーから Personal Directory をクリックします。

個人ファイルの追加

さまざまな方法を使用して、個人用ファイルを異なる場所に追加できます。

個人ファイルの作成

Personal Directory で、My Files をクリックします。次に、ツールバーのアイコンをクリックして My Files ディレクトリ内にファイルを作成します。ファイル作成時には、ファイルタイプを決定するために拡張子を指定する必要があります。サポートされているファイルタイプについては、「ファイルタイプ」をご参照ください。

また、アイコンをクリックして、[マイファイル] 内のディレクトリ構造を整理することもできます。

ローカルファイルの追加

デフォルトの My Files ディレクトリに加えて、ローカルフォルダを直接 Personal Directory に追加することもできます。

個人開発環境を使用していない場合、ツールバーのアイコンをクリックして、ご利用のローカルマシンから Personal Directory にフォルダを追加します。追加するフォルダを選択してください。
この操作を行うには、ブラウザにローカルファイルの読み取り権限を付与する必要があります。
個人開発環境を使用している場合、ツールバーのアイコンをクリックして、インスタンスから Personal Directory にフォルダを追加します。追加するフォルダを選択してください。

個人ファイルの編集

個人ファイルを追加後、ファイル名をクリックしてエディターを開き、内容の編集を開始できます。たとえば、.sql ファイルに SQL 文を記述できます。次の例をご参照ください。

SELECT * FROM dw_work WHERE work_title IS NOT NULL;

個人ファイルの利用

個人ファイルは以下の方法で利用できます。

.sql ファイルおよび .py ファイルは、ワークスペースにバインドされた計算リソースにコードを送信することで実行できます。
サポートされているすべての実行可能ファイルタイプ（.ipynb、.sh、.py、および .sql）は、ワークスペースディレクトリにコミットでき、本番環境向けの定期タスクとして設定できます。
Personal Directory にある .py ファイルを MaxCompute リソースまたは関数として送信し、MaxCompute ジョブ開発で利用できます。

方法 1：Personal Directory でのファイル実行

この方法は、日常的な開発、テスト、アドホッククエリに最適です。小さなコードをテストするには、Personal Directory に一時ファイルを作成して実行できます。

実行パラメーターを設定します。

Personal Directory で実行する Shell、Python、または SQL ファイルを見つけ、ファイルをクリックしてエディターを開きます。右側の Run Configuration ペインで、タスクの実行パラメーターを設定します。

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

Notebook ファイルは、個人開発環境でのみ実行できます。詳細については、「Notebook 開発」をご参照ください。

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

方法 2：スケジューリング用ファイルのコミット

Personal Directory のコードを定期的に実行する必要がある場合は、プロジェクトディレクトリにコミットしてスケジューリングノードを作成します。その後、プロジェクトディレクトリの標準的な開発ワークフローに従って、このノードを定期タスクとして設定できます。

コミットプロセスを開始します。
Personal Directory でプロジェクトディレクトリにコミットするファイルを見つけ、ファイル名をダブルクリックしてファイル詳細を開きます。ファイル上部のツールバーで、アイコンをクリックしてファイルをプロジェクトディレクトリにコミットします。

コミットパラメーターを設定します。

パラメーター	説明
ノードタイプの選択	プロジェクトディレクトリに作成するノードのタイプを選択します。選択したノードタイプとコードが互換性を持つことを確認してください。
ノードを作成するパスの選択	プロジェクトディレクトリ内のノードの保存パスを選択します。
ノード名の指定	元のファイル名をノード名として使用するか、新しい名前を指定するかを選択します。

方法 3：Python ファイルをリソースまたは関数として送信

Personal Directory の .py ファイルを MaxCompute リソースまたは関数として送信し、データ開発ノードで利用できます。

送信プロセスを開始します。
Personal Directory で送信する .py ファイルを見つけ、ファイル名をダブルクリックしてファイル詳細を開きます。ツールバーで、アイコンの横にあるドロップダウン矢印をクリックし、関数としてコミット または リソースとしてコミット を選択します。

送信パラメーターを設定します。

パラメーター	説明
タイプ	関数としてコミットを選択した場合、タイプはデフォルトで `MaxCompute 関数` になります。リソースとしてコミットを選択した場合、タイプはデフォルトで `MaxCompute Python` になります。
パス	リソース管理内のリソースまたは関数のパスを選択します。デフォルトは `/` で、リソース管理のルートディレクトリに配置されます。別のディレクトリを使用する場合は、事前にリソース管理でディレクトリを作成し、ここで選択する必要があります。
コミットタイプ	新規：リソース管理の指定パスに新しい関数またはリソースを作成します。このオプションを選択した場合、リソースまたは関数の名前を指定する必要があります。既存ファイルとの関連付け：ファイルを既存のリソースまたは関数に関連付けます。このオプションを選択した場合、既存リソースを指定する必要があります。ファイルを既存の関数に関連付けた場合、現在の `.py` ファイル内の Python コードが、元の関数のコードを置き換えます。ファイルを既存のリソースに関連付けた場合、現在の `.py` ファイルが、元のリソースのファイル内容を置き換えます。

OK をクリックし、画面の指示に従ってプロセスを完了します。
- コミットタイプ を新規に設定した場合、対応するリソースまたは関数の作成ページが表示されます。
- コミットタイプ を 既存ファイルとの関連付け に設定した場合、既存の関数またはリソースの編集ページが表示されます。
MaxCompute 関数およびリソースのパラメーターの詳細については、「MaxCompute リソースおよび関数」をご参照ください。

個人ファイルの管理

Personal Directory 内の任意のファイルを右クリックしてコンテキストメニューを開くことで、ファイルを管理できます。そこから、ファイルのダウンロード、削除、名前の変更などの操作を実行できます。

個人開発環境では、統合端末を通じてファイルを管理することもできます。

統合端末で開く
Local Files ディレクトリで対象ファイルを見つけ、右クリックしてコンテキストメニューから 統合端末で開く を選択します。これにより端末ウィンドウが開き、自動的にファイルのディレクトリに移動します。
ローカルフォルダを Personal Directory に追加
Local Files ディレクトリで対象ファイルを見つけ、右クリックしてコンテキストメニューから ローカルフォルダを Personal Directory に追加... を選択します。これにより、端末で作成したフォルダを Personal Directory に読み込めます。
ローカルフォルダを Personal Directory から削除
Local Files ディレクトリで対象ファイルを見つけ、右クリックしてコンテキストメニューから ローカルフォルダを Personal Directory から削除... を選択します。この操作により、Personal Directory の表示からフォルダが削除されますが、フォルダ自体は削除されません。

付録：Personal Directory の UI

次の表は、DataStudio の Personal Directory で利用可能な UI 機能について説明しています。

機能	説明
	ローカルフォルダを Personal Directory に追加します。個人開発環境を使用していない場合、ツールバーのアイコンをクリックして、ご利用のローカルマシンから Personal Directory にフォルダを追加します。追加するフォルダを選択してください。この操作を行うには、ブラウザにローカルファイルの読み取り権限を付与する必要があります。個人開発環境を使用している場合、ツールバーのアイコンをクリックして、インスタンスから Personal Directory にフォルダを追加します。追加するフォルダを選択してください。
	Notebook を作成します。
	ファイルを作成します。
	フォルダを作成します。
	更新します。
	すべて折りたたみます。