Direktori Pribadi - DataWorks

Direktori Pribadi adalah ruang pribadi untuk menyimpan, mengelola, dan melakukan debug kode. Lingkungan ini memungkinkan Anda membuat serta memelihara file pribadi dan proyek pengembangan.

Overview

Direktori Pribadi mengorganisasi file ke dalam dua kategori: My Files dan Local Files. Bagian ini menjelaskan masing-masing kategori tersebut.

Directory type	Storage directory	Storage provider	Storage path	Direct terminal access
My Files	Direktori default di dalam Direktori Pribadi.	DataWorks	N/A	No
Local Files	Saat Anda menggunakan instans personal development environment, direktori ini menjadi direktori penyimpanan default. Catatan Anda harus terlebih dahulu membuat instans personal development environment.	Jika set data ditentukan untuk instans personal development environment, penyedia penyimpanannya adalah layanan NAS yang dikonfigurasi untuk set data tersebut.	Ditentukan saat instans personal development environment dibuat.	Yes
		Jika tidak ada set data yang ditentukan untuk instans personal development environment, penyedia penyimpanannya adalah DataWorks.	`/mnt/workspace/.virtual_documents`	Yes
	Jika Anda tidak menggunakan personal development environment, Anda dapat menambahkan path dari mesin lokal ke Direktori Pribadi.	Mesin lokal Anda	Path ditentukan berdasarkan pilihan Anda saat menambahkan folder lokal.	No

File types

Anda dapat membuat file jenis apa pun di Direktori Pribadi. Namun, hanya jenis file berikut yang dapat dijalankan:

.ipynb: File Notebook.
.sh: File Shell.
.py: File Python.
.sql: File SQL.

Catatan

Anda dapat membaca dan menulis file dalam bahasa pemrograman lain yang didukung oleh Visual Studio Code di Direktori Pribadi. Namun, DataWorks tidak menyediakan fitur seperti syntax highlighting, lingkungan pengembangan, atau dukungan eksekusi untuk jenis file tersebut.

Prerequisites

Anda telah membuat Workspace dan mengikat resource komputasi ke dalamnya. Untuk informasi lebih lanjut, lihat Create a workspace dan Associate a computing resource.
Anda telah membuat resource group dan mengikatnya ke Workspace target.

Access Personal Directory

Buka halaman Workspaces di Konsol DataWorks. Di bilah navigasi atas, pilih wilayah yang diinginkan. Temukan workspace yang diinginkan dan pilih Shortcuts > Data Studio di kolom Actions.
Di halaman DataStudio, klik ikon di panel navigasi sebelah kiri. Di halaman pengembangan data yang muncul, klik Personal Directory pada struktur direktori di sebelah kiri.

Add personal files

Anda dapat menambahkan file pribadi ke lokasi berbeda dengan berbagai metode.

Create a personal file

Di Personal Directory, klik My Files. Kemudian, di toolbar, klik ikon untuk membuat file di direktori My Files. Saat membuat file, Anda harus menentukan ekstensi file untuk menentukan jenisnya. Untuk informasi tentang jenis file yang didukung, lihat File types.

Anda juga dapat mengklik ikon untuk mengatur struktur direktori di dalam My Files.

Add local files

Selain menggunakan direktori default My Files, Anda dapat menambahkan folder lokal langsung ke Personal Directory.

Saat tidak menggunakan Personal development environment, klik ikon di toolbar untuk menambahkan folder dari mesin lokal ke Direktori Pribadi. Pilih folder yang ingin Anda tambahkan.
Untuk tindakan ini, Anda harus memberikan izin browser untuk membaca file lokal.
Saat menggunakan personal development environment, klik ikon di toolbar untuk menambahkan folder dari instans ke Direktori Pribadi. Pilih folder yang ingin Anda tambahkan.

Edit a personal file

Setelah menambahkan file pribadi, Anda dapat mengklik nama file untuk membuka editor dan mulai mengedit kontennya. Misalnya, Anda dapat menulis pernyataan SQL di file .sql, seperti pada contoh berikut:

SELECT * FROM dw_work WHERE work_title IS NOT NULL;

Use personal files

Anda dapat menggunakan file pribadi dengan cara berikut:

Anda dapat menjalankan file .sql dan .py dengan mengirimkan kode ke resource komputasi yang diikat ke Workspace.
Semua jenis file yang dapat dijalankan (.ipynb, .sh, .py, dan .sql) dapat dikomit ke Workspace directories, tempat Anda dapat mengonfigurasinya sebagai task periodik untuk lingkungan produksi.
Anda dapat mengirimkan file .py dari Direktori Pribadi sebagai resource atau fungsi MaxCompute untuk digunakan dalam pengembangan pekerjaan MaxCompute.

Method 1: Run files in Personal Directory

Metode ini ideal untuk pengembangan harian, pengujian, dan kueri ad-hoc. Untuk menguji potongan kode kecil, Anda dapat membuat dan menjalankan file temporary di Direktori Pribadi.

Konfigurasikan parameter eksekusi.

Di Direktori Pribadi, temukan file Shell, Python, atau SQL yang ingin dijalankan. Klik file tersebut untuk membuka editor. Di panel Run Configuration di sebelah kanan, konfigurasikan parameter eksekusi untuk task tersebut.

Parameter	Description
Type	Jenis compute resource yang diperlukan untuk menjalankan file tersebut.
Compute resource	Compute resource yang terikat pada Workspace saat ini.
Resource group	Resource group yang digunakan untuk menjalankan file tersebut.

File Notebook harus dijalankan di personal development environment. Untuk informasi lebih lanjut, lihat Notebook development.

Jalankan kode.
Di halaman detail file, klik ikon di toolbar untuk menjalankan task.

Method 2: Commit files for scheduling

Jika Anda perlu menjalankan kode dari Direktori Pribadi secara berkala, komit kode tersebut ke direktori proyek untuk membuat node penjadwalan. Anda kemudian dapat mengonfigurasi node ini sebagai task periodik dengan mengikuti alur kerja pengembangan standar untuk direktori proyek.

Mulai proses komit.
Di Direktori Pribadi, temukan file yang ingin Anda komit ke direktori proyek dan klik ganda nama file untuk membuka detail file. Di toolbar bagian atas file, klik ikon untuk mengkomit file ke direktori proyek.

Konfigurasikan parameter komit.

Parameter	Description
Select node type	Pilih jenis node yang akan dibuat di direktori proyek. Pastikan kode Anda kompatibel dengan jenis node yang dipilih.
Select the path where you want to create the node	Pilih path penyimpanan untuk node di direktori proyek.
Specify node name	Pilih apakah akan menggunakan nama file asli sebagai nama node atau menentukan nama baru.

Method 3: Submit Python files as resources or functions

Anda dapat mengirimkan file .py dari Direktori Pribadi sebagai resource atau fungsi MaxCompute untuk digunakan dalam node pengembangan data.

Mulai proses pengiriman.
Di Direktori Pribadi, temukan file .py yang ingin Anda kirim dan klik ganda nama file untuk membuka detail file. Di toolbar, klik panah drop-down di samping ikon dan pilih Commit as Function atau Commit as Resource.

Konfigurasikan parameter pengiriman.

Parameter	Description
Type	Jika Anda memilih Commit as Function, jenisnya secara default adalah `MaxCompute Function`. Jika Anda memilih Commit as Resource, jenisnya secara default adalah `MaxCompute Python`.
Path	Pilih path untuk resource atau fungsi di Resource management. Default-nya adalah `/`, yang menempatkannya di direktori root Resource Management. Untuk menggunakan direktori berbeda, Anda harus terlebih dahulu membuatnya di Resource Management lalu memilihnya di sini.
Commit type	New: Membuat fungsi atau resource baru di path yang ditentukan di Resource Management. Jika memilih opsi ini, Anda harus menentukan Name untuk resource atau fungsi tersebut. Associate with existing file: Mengaitkan file dengan sumber daya atau fungsi yang sudah ada. Jika memilih opsi ini, Anda harus menentukan Existing resource. Saat Anda mengaitkan file dengan fungsi yang sudah ada, kode Python di file `.py` saat ini akan menggantikan code fungsi aslinya. Saat Anda mengaitkan file dengan resource yang sudah ada, file `.py` saat ini akan menggantikan file content resource aslinya.

Klik OK dan ikuti petunjuk di layar untuk menyelesaikan proses.
- Jika Anda mengatur Commit type ke New, halaman pembuatan resource atau fungsi yang sesuai akan muncul.
- Jika Anda mengatur Commit type ke Associate with existing file, halaman pengeditan fungsi atau resource yang sudah ada akan muncul.
Untuk deskripsi detail parameter fungsi dan resource MaxCompute, lihat MaxCompute resources and functions.

Manage personal files

Anda dapat mengelola file apa pun di Direktori Pribadi dengan mengklik kanan file tersebut untuk membuka menu konteks. Dari sana, Anda dapat melakukan aksi seperti mengunduh, menghapus, atau mengganti nama file.

Di lingkungan pengembangan pribadi, Anda juga dapat mengelola file melalui terminal terintegrasi.

Open in Integrated Terminal
Di direktori tempat file target berada, klik kanan pada file tersebut, lalu pilih Open in Integrated Terminal dari menu konteks. Tindakan ini akan membuka jendela terminal dan secara otomatis berpindah ke direktori file tersebut.
Add Local Folder to Personal Directory
Di direktori Add Local Folder to Personal Directory..., temukan file target, klik kanan, lalu pilih Add Local Folder to Personal Directory... dari menu konteks. Ini memungkinkan Anda memuat folder yang dibuat di terminal ke dalam Direktori Pribadi Anda.
Remove Local Folder from Personal Directory
Di direktori Remove Local Folder from Personal Directory..., temukan file target, klik kanan, lalu pilih Remove Local Folder from Personal Directory... dari menu konteks. Aksi ini menghapus folder dari tampilan Direktori Pribadi tetapi tidak menghapus folder tersebut.

Appendix: Personal directory UI

Tabel berikut menjelaskan fungsi UI yang tersedia di Direktori Pribadi DataStudio.

Function	Description
	Add a local folder to the Personal Directory. Saat tidak menggunakan Personal development environment, klik ikon di toolbar untuk menambahkan folder dari mesin lokal ke Direktori Pribadi. Pilih folder yang ingin Anda tambahkan. Untuk tindakan ini, Anda harus memberikan izin browser untuk membaca file lokal. Saat menggunakan personal development environment, klik ikon di toolbar untuk menambahkan folder dari instans ke Direktori Pribadi. Pilih folder yang ingin Anda tambahkan.
	Create a Notebook.
	Create a file.
	Create a folder.
	Refresh.
	Collapse All.