Di DataWorks, DataService Studio memungkinkan Anda mengekspos tabel data yang telah diproses sebagai REST API untuk berbagi data dengan aplikasi bisnis lainnya. Tutorial ini menjelaskan cara membuat, mengonfigurasi, menguji, dan menerbitkan API yang menyajikan data dari tabel profil pengguna ads_user_info_1d.
Prasyarat
Anda telah membeli exclusive resource group for DataService Studio atau mengalokasikan kuota untuk DataService Studio ke kelompok sumber daya serverless. Pastikan juga kelompok sumber daya tersebut terhubung ke sumber daya komputasi MaxCompute.
Anda telah memproses data dan menghasilkan tabel profil pengguna, sebagaimana dijelaskan dalam Proses data.
Buat API profil pengguna
Setelah Anda menyinkronkan dan memproses data, sebuah tabel data bernama ads_user_info_1d akan dihasilkan. Untuk menyediakan tabel ini kepada layanan lain yang dapat menerima data melalui API, Anda dapat menggunakan fitur API DataWorks DataService Studio untuk menghasilkan layanan API dalam Wizard Mode atau Script Mode.
Langkah 1: Hasilkan API profil pengguna
Masuk ke Konsol DataWorks. Di Wilayah target, klik di panel navigasi kiri. Pilih ruang kerja dari daftar drop-down, lalu klik Go to DataService Studio.
Buat layanan API.
Di halaman DataService Studio, klik ikon
lalu pilih . Di kotak dialog Generate API, pilih Wizard Mode untuk menghasilkan API.CatatanDataService Studio mendukung dua mode untuk menghasilkan API: wizard mode dan script mode.
Untuk informasi selengkapnya tentang wizard mode, lihat Generate an API from a data source (API Gateway).
Untuk informasi selengkapnya tentang script mode, lihat Generate an API in script mode.
Langkah 2: Konfigurasikan API profil pengguna
Konfigurasikan API.
Dalam wizard mode, konfigurasikan parameter berikut untuk membuat API dari sumber data MaxCompute Anda. Untuk informasi selengkapnya, lihat Generate an API from a data source (API Gateway).
Bagian
Parameter
Deskripsi
Contoh
Table
Data Source Type
Pilih jenis sumber data Anda.
CatatanDataService Studio tidak mendukung sumber data Hive. Jenis yang tersedia tercantum dalam menu drop-down.
Tutorial ini menggunakan sumber data MaxCompute.
Data Source Name
Pilih sumber data Anda.
Pilih sumber data bisnis Anda.
Data Source Environment
Production Environment
Development Environment
Pilih Production Environment.
Data Table Name
Pilih tabel yang ingin Anda ekspos melalui API.
Pilih tabel
ads_user_info_1d.Select Parameters
Pagination for Return Results
Menentukan apakah hasil harus dipaginasi. Pengaturan ini memengaruhi parameter permintaan dan respons.
Anda dapat mengatur jumlah maksimum catatan data untuk satu permintaan di pengaturan kelompok sumber daya layanan. Untuk informasi selengkapnya, lihat Generate an API from a data source (API Gateway).
Nonaktifkan Pagination for Return Results.
Set as Req Param
Tetapkan satu atau beberapa bidang dalam tabel sebagai parameter permintaan.
Tetapkan bidang partisi
dtsebagai Request Parameters.Set as Resp Param
Pilih bidang tabel yang akan disertakan dalam respons API.
Tetapkan semua bidang dari tabel
ads_user_info_1dsebagai Response Parameters.Sorting Fields
Parameter ini opsional. Jika Anda perlu mengurutkan hasil, pilih terlebih dahulu bidang yang diinginkan dalam daftar parameter.
Jangan urutkan.
Konfigurasikan kelompok sumber daya layanan
Setelah Anda mengonfigurasi API dalam wizard mode, klik Resource Group for DataService Studio di panel navigasi kanan untuk mengonfigurasi kelompok sumber daya. Untuk informasi selengkapnya, lihat Configure an API service resource group.
Bagian
Parameter
Deskripsi
Resource Group Type
Scheme
Exclusive Resource Group for DataService Studio.
Exclusive Resource Group for DataService Studio
Anda dapat memilih kelompok sumber daya serverless (disarankan) atau exclusive resource group for DataService Studio.
PentingJika Anda telah membeli Grup sumber daya eksklusif untuk DataService Studio, Anda dapat langsung menggunakannya.
Jika Anda belum memiliki kelompok sumber daya, kami menyarankan Anda membeli kelompok sumber daya serverless serbaguna. Untuk informasi selengkapnya, lihat Use a serverless resource group.
Jika kelompok sumber daya serverless yang baru dibeli berwarna abu-abu dan tidak dapat dipilih, Anda harus terlebih dahulu mengalokasikan kuota untuk layanan Data Services ke kelompok sumber daya tersebut. Untuk informasi selengkapnya, lihat Allocate CU quotas to tasks.
Environment Configuration
Timeout
Atur timeout menjadi 30.000 ms.
Maximum Number of Data Records for a Single Request
Atur batas menjadi 2.000.
Langkah 3: Uji dan terbitkan API
Uji API untuk memverifikasi bahwa API mengembalikan parameter yang benar. Untuk informasi selengkapnya, lihat Test an API.
Setelah menyelesaikan konfigurasi, klik ikon Simpan
, lalu klik ikon Uji
untuk membuka halaman pengujian API.Di kotak dialog API Test, masukkan nilai untuk parameter permintaan.
Klik Start Test untuk menjalankan pengujian.
Penerbitan API akan men-deploy API ke API Gateway dan menghasilkan URL titik akhir publik. Untuk informasi selengkapnya, lihat API testing, publishing, and version management.
Setelah API lolos pengujian, kembali ke halaman pengeditan API lalu klik ikon Kirim
. Hal ini akan membuat versi API baru. Klik Version di panel kanan untuk melihat detailnya.
Klik Publish untuk menerbitkan layanan API.
Setelah API diterbitkan, Anda dapat mengelola API dengan mengklik Service Management di panel Versi, atau dengan menavigasi ke . Untuk informasi selengkapnya, lihat Manage and maintain APIs.
Langkah berikutnya
Setelah Anda menerbitkan API, Anda dapat memberi otorisasi aplikasi untuk memanggil API tersebut. Untuk informasi selengkapnya, lihat Authorize an API dan Call an API.