個人ディレクトリは、各開発者がコードを管理およびデバッグするためのプライベートなストレージおよび開発スペースです。このディレクトリで個人のコードを作成および維持できます。
個人ディレクトリの説明
個人ディレクトリ内のファイルは、マイファイルとローカルファイルの 2 種類に分類されます。次の表に、これら 2 つのファイルタイプについて説明します。
ディレクトリタイプ | ストレージディレクトリ | ストレージプロバイダー | ストレージパス | ターミナルからの直接ファイル操作を許可 |
マイファイル | 個人ディレクトリのデフォルトディレクトリ。 | DataWorks | — | いいえ |
ローカルファイル | 個人開発環境インスタンスのデフォルトストレージディレクトリ。 説明 個人開発環境インスタンスを先に作成してください。 | 個人開発環境インスタンスにデータセットが指定されている場合、ストレージプロバイダーはデータセットに構成されている NAS サービスです。 | 個人開発環境インスタンスを作成するときに指定されます。 | はい |
個人開発環境インスタンスにデータセットが指定されていない場合、ストレージプロバイダーは DataWorks です。 |
| はい | ||
個人開発環境を使用しない場合は、現在のデバイスから個人ディレクトリにパスを追加できます。 | ユーザーの現在のデバイス | オンプレミスフォルダを追加するときに選択したパス。 | いいえ |
ファイルタイプ
個人ディレクトリには任意のタイプのファイルを作成できます。ただし、実行できるのは次のタイプのファイルのみです。
.ipynb: Notebook ファイル。.sh: Shell ファイル。.py: Python ファイル。.sql: SQL ファイル。
個人ディレクトリでは、Visual Studio Code でサポートされている他のプログラミング言語のファイルの読み取りと書き込みができます。ただし、これらのファイルには構文のハイライトや開発環境は提供されず、実行することもできません。
前提条件
ワークスペースが作成され、計算リソースがワークスペースにアタッチされています。詳細については、「ワークスペースの作成」および「計算リソースのアタッチ」をご参照ください。
リソースグループが作成され、宛先のワークスペースにアタッチされています。詳細については、「リソースグループを作成してワークスペースにアタッチする」をご参照ください。
個人ディレクトリセクションへ移動
DataWorks コンソールの Workspaces ページに移動します。上部のナビゲーションバーで、目的のリージョンを選択します。目的のワークスペースを見つけ、[Actions] 列で を選択します。
Data Studio ページの左側のナビゲーションウィンドウで、
アイコンをクリックして Data Studio ページに移動します。左側のディレクトリツリーで、[個人ディレクトリ] をクリックします。
個人ファイルの追加
必要に応じて、さまざまな場所に個人ファイルを追加できます。
新しい個人ファイルの作成
[個人ディレクトリ] で、[マイファイル] をクリックします。ツールバーで
アイコンをクリックして、マイファイルフォルダに個人ファイルを作成します。ファイルを作成するときは、ファイル拡張子を指定してファイルタイプを決定します。サポートされているファイルタイプとその説明の詳細については、「ファイルタイプ」をご参照ください。
アイコンをクリックして [マイファイル] にフォルダを作成することもできます。
ローカルファイルの追加
デフォルトの [マイファイル] フォルダに加えて、オンプレミスフォルダ (ファイルとコードリポジトリを含む) を [個人ディレクトリ] に追加できます。
個人開発環境を使用しない場合は、ツールバーの
アイコンをクリックして、ローカルデバイスから個人ディレクトリにフォルダを追加できます。目的のフォルダを選択します。この操作では、ブラウザにローカルファイルの読み取り権限を付与する必要があります。
個人開発環境を使用する場合は、ツールバーの
アイコンをクリックして、個人開発環境インスタンスから個人ディレクトリにフォルダを追加できます。目的のフォルダを選択します。
個人ファイルの編集
個人ファイルを追加した後、ファイル名をクリックしてエディターページを開き、ファイル内容の編集を開始できます。たとえば、以下に示すように、.sql ファイルに SQL 文を記述できます。
SELECT * FROM dw_work WHERE work_title IS NOT NULL;個人ファイルの使用
個人ファイルは、次の方法で使用できます。
.sqlや.pyファイルなどの実行可能なファイルタイプの場合、コードをワークスペースにアタッチされている計算リソースに送信して実行できます。個人ディレクトリでサポートされているすべてのファイルタイプ (
.ipynb、.sh、.py、および.sql) は、プロジェクトディレクトリに送信できます。送信後、スケジューling プロパティを構成し、ファイルを本番環境に公開できます。個人ディレクトリ内の
.pyファイルを MaxCompute リソースまたは関数として送信し、MaxCompute ジョブ開発で使用できます。
方法 1: 個人ディレクトリで実行
この方法は、日常の開発、テスト、および一時的なクエリに適しています。たとえば、少量のコードが期待どおりに機能するかどうかをテストするには、個人ディレクトリに一時ファイルを作成してコードを実行できます。
デバッグパラメーターを構成します。
個人ディレクトリで、実行したい
Shell、Python、またはSQLファイルを見つけます。ファイルをクリックしてエディターで開きます。右側の [デバッグ構成] ペインで、タスクのパラメーターを設定します。パラメーター
説明
タイプ
ファイルの実行に必要な計算リソースのタイプを選択します。
計算リソース
現在のワークスペースにアタッチされている計算リソースを選択します。
リソースグループ
ファイルの実行に使用するリソースグループを選択します。
Notebook ファイルは個人開発環境で実行する必要があります。詳細については、「Notebook の実行」をご参照ください。
コードをデバッグして実行します。
エディターページで、ツールバーの
アイコンをクリックしてタスクを実行します。
方法 2: プロジェクトディレクトリに送信して実行
個人ディレクトリ内のコードを本番環境で定期的にスケジュールする必要がある場合は、プロジェクトディレクトリに送信できます。これにより、個人ファイルからスケジューリングノードをすばやく作成し、プロジェクトディレクトリのワークフロー内に定期タスクを作成できます。
送信プロセスを開始します。
個人ディレクトリで、プロジェクトディレクトリに送信するファイルを見つけ、ファイル名をダブルクリックしてエディターページを開きます。ページ上部のツールバーで、
アイコンをクリックしてファイルをプロジェクトディレクトリに送信します。送信パラメーターを構成します。
構成
説明
ノードタイプの選択
個人ファイルを送信するプロジェクトディレクトリ内のノードタイプを選択します。現在のコードが選択したノードタイプと一致していることを確認してください。
ノードのパスを選択
プロジェクトディレクトリ内のノードのストレージパスを選択します。
ノード名を確認
個人ファイル名をノード名として使用するか、新しいノード名を定義するかを確認します。
方法 3: Python ファイルをリソースまたは関数として送信
DataStudio は、個人ディレクトリから .py ファイルを MaxCompute リソースまたは関数として送信することをサポートしています。これにより、Data Studio でそれらを使用できます。
送信プロセスを開始します。
個人ディレクトリで、送信する
.pyファイルを見つけます。ファイル名をダブルクリックしてエディターページを開きます。ページ上部のツールバーで、
アイコンの横にあるドロップダウン矢印をクリックし、[関数として送信] または [リソースとして送信] を選択します。送信パラメーターを構成します。
構成
説明
タイプ
[関数として送信] を選択した場合、タイプはデフォルトで
MaxCompute Functionになります。[リソースとして送信] を選択した場合、タイプはデフォルトで
MaxCompute Pythonになります。
パス
Resource management でリソースまたは関数のパスを選択します。デフォルトのパスは
/で、Resource Management のルートディレクトリを示します。パスを変更するには、まず Resource Management でディレクトリを手動で作成し、ここで選択します。送信タイプ
[新規]: Resource Management の指定されたパスに新しい関数またはリソースを作成します。このパラメーターを選択した場合は、リソースまたは関数の [名前] を構成する必要があります。
[既存のファイルに関連付け]: 関連付ける既存のリソースまたは関数を選択します。このパラメーターを選択した場合は、[既存のリソース] を構成する必要があります。
既存の関数に関連付けると、現在の
.pyファイルの Python コードが元の関数の [コード] を置き換えます。既存のリソースを関連付けると、現在の
.pyファイルが元のリソースの [ファイルコンテンツ] を置き換えます。
[確認] をクリックし、画面の指示に従ってプロセスを完了します。
[送信タイプ] を [新規] に設定すると、対応するリソースまたは関数の作成ページが表示されます。
[送信タイプ] を [既存のファイルに関連付け] に設定すると、既存の関数またはリソースのエディターページが表示されます。
MaxCompute の関数とリソースの構成パラメーターの詳細については、「MaxCompute のリソースと関数」をご参照ください。
個人ファイルの管理
右クリックメニューを使用して、個人ディレクトリ内のすべてのファイルを管理できます。たとえば、ファイルのダウンロード、削除、名前の変更ができます。
個人開発環境のファイルは、ターミナルからも管理できます。
統合ターミナルで開く
ローカルファイルディレクトリで、オブジェクトファイルを見つけて右クリックします。ショートカットメニューから [統合ターミナルで開く] を選択します。この操作により、ターミナルウィンドウが開き、ファイルのディレクトリに自動的に移動します。
オンプレミスフォルダを個人ディレクトリに追加
ローカルファイルディレクトリで、目的のフォルダを右クリックします。ショートカットメニューから [オンプレミスフォルダを個人ディレクトリに追加...] を選択します。これにより、開発環境のフォルダが DataStudio の個人ディレクトリビューに追加されます。
オンプレミスフォルダを個人ディレクトリから削除
ローカルファイルディレクトリで、フォルダを見つけて右クリックします。ショートカットメニューから [オンプレミスフォルダを個人ディレクトリから削除...] を選択します。この操作により、フォルダは個人ディレクトリビューから削除されますが、完全に削除されるわけではありません。
付録: 個人ディレクトリインターフェイスの機能
次の表に、DataStudio の個人ディレクトリでサポートされている操作を示します。
インターフェイス機能 | 機能説明 |
| オンプレミスフォルダを個人ディレクトリに追加します。
|
| Notebook を作成します。 |
| ファイルを作成します。 |
| フォルダを作成します。 |
| 更新します。 |
| フォルダを折りたたみます。 |
アイコンをクリックして [マイファイル] にフォルダを作成することもできます。