Menggunakan aplikasi yang disebarkan di SQL Server Kluster Big Data menggunakan layanan web RESTful

Berlaku untuk: SQL Server 2019 (15.x)

Artikel ini menjelaskan cara menggunakan aplikasi yang disebarkan pada kluster big data SQL Server menggunakan layanan web RESTful.

Penting

Add-on Kluster Big Data Microsoft SQL Server 2019 akan dihentikan. Dukungan untuk Kluster Big Data SQL Server 2019 akan berakhir pada 28 Februari 2025. Untuk informasi selengkapnya, lihat Opsi big data di platform Microsoft SQL Server.

Prasyarat

Catatan

Ketika file spesifikasi yaml aplikasi menentukan jadwal, aplikasi akan dipicu melalui pekerjaan cron. Jika kluster big data Anda disebarkan di OpenShift, meluncurkan pekerjaan cron memerlukan kemampuan tambahan. Lihat detail mengenai pertimbangan keamanan di OpenShift untuk instruksi tertentu.

Kemampuan

Setelah menyebarkan aplikasi ke Kluster Big Data SQL Server 2019, Anda dapat mengakses dan menggunakan aplikasi tersebut menggunakan layanan web RESTful. Ini memungkinkan integrasi aplikasi tersebut dari aplikasi atau layanan lain (misalnya, aplikasi seluler atau situs web). Tabel berikut menjelaskan perintah penyebaran aplikasi yang dapat Anda gunakan dengan azdata untuk mendapatkan informasi tentang layanan web RESTful untuk aplikasi Anda.

Perintah Deskripsi
azdata app describe Jelaskan aplikasi.

Anda bisa mendapatkan bantuan dengan --help parameter seperti dalam contoh berikut:

azdata app describe --help

Bagian berikut menjelaskan cara mengambil titik akhir untuk aplikasi dan cara bekerja dengan layanan web RESTful untuk integrasi aplikasi.

Mengambil titik akhir

Kluster Big Data menyediakan titik akhir yang dapat Anda akses dan konsumsi aplikasi tersebut menggunakan layanan web RESTful, tujuan utamanya adalah untuk fasilitas interaksi dengan aplikasi web atau seluler lainnya dan menjadi lebih proaktif untuk arsitektur layanan mikro tersebut. Perintah azdata app describe menyediakan informasi terperinci tentang aplikasi termasuk titik akhir di kluster Anda. Ini biasanya digunakan oleh pengembang aplikasi untuk membangun aplikasi menggunakan klien swagger dan menggunakan layanan web untuk berinteraksi dengan aplikasi dengan cara RESTful.

Jelaskan aplikasi Anda dengan menjalankan perintah yang mirip dengan contoh berikut:

azdata app describe --name add-app --version v1
{
  "input_param_defs": [
    {
      "name": "x",
      "type": "int"
    },
    {
      "name": "y",
      "type": "int"
    }
  ],
  "links": {
    "app": "https://10.1.1.3:30080/app/addpy/v1",
    "swagger": "https://10.1.1.3:30080/app/addpy/v1/swagger.json"
  },
  "name": "add-app",
  "output_param_defs": [
    {
      "name": "result",
      "type": "int"
    }
  ],
  "state": "Ready",
  "version": "v1"
}

Perhatikan alamat IP (10.1.1.3 dalam contoh ini) dan nomor port (30080) dalam output.

Salah satu cara lain untuk mendapatkan informasi ini adalah dengan mengklik kanan Kelola di server di Azure Data Studio tempat Anda akan menemukan titik akhir layanan yang tercantum.

Titik Akhir IKLAN

Membuat token akses JWT

Untuk mengakses layanan web RESTful untuk aplikasi yang telah Anda sebarkan, pertama-tama Anda harus membuat token Akses JWT. URL untuk token akses tergantung pada versi Big Data Cluster.

Versi URL
GDR1 https://[IP]:[PORT]/docs/swagger.json
CU1 dan yang lebih baru https://[IP]:[PORT]/api/v1/swagger.json

Dari output contoh sebelumnya, rilis CU4 dan alamat IP pengontrol (10.1.1.3 dalam contoh) dan nomor port (30080), URL akan terlihat seperti berikut:

   https://10.1.1.3 :30080/api/v1/swagger.json

Untuk informasi versi, lihat Riwayat rilis.

Buka URL yang sesuai di browser Anda menggunakan alamat IP dan port yang Anda ambil menjalankan perintah di describe atas. Masuk dengan kredensial yang sama dengan yang Anda gunakan untuk azdata login.

Tempelkan konten ke swagger.jsonEditor Swagger untuk memahami metode apa yang tersedia:

API Swagger

app Perhatikan bahwa adalah metode GET dan untuk mendapatkan token akan menggunakan metode POST. Karena autentikasi untuk aplikasi menggunakan token JWT, Anda harus mendapatkan token saya menggunakan alat favorit Anda untuk melakukan panggilan POST ke token metode . Dengan contoh yang sama, URL untuk mendapatkan token JWT akan terlihat seperti berikut:

   https://10.1.1.3 :30080/api/v1/token

Berikut adalah contoh cara melakukannya di Postman:

Postman Token

Output permintaan ini akan memberi Anda JWT access_token, yang harus Anda panggil URL untuk menjalankan aplikasi.

Menjalankan aplikasi menggunakan layanan web RESTful

Ada beberapa cara untuk menggunakan aplikasi di SQL Server Kluster Big Data, Anda dapat memilih untuk menggunakan perintah azdata app run. Bagian ini akan menunjukkan cara menggunakan alat pengembang umum seperti Postman untuk menjalankan aplikasi.

Anda dapat membuka URL untuk swagger yang dikembalikan ketika Anda menjalankan azdata app describe --name [appname] --version [version] di browser Anda, yang seharusnya mirip https://[IP]:[PORT]/app/[appname]/[version]/swagger.jsondengan .

Catatan

Anda harus masuk dengan kredensial yang sama dengan yang Anda gunakan untuk azdata login. Dengan contoh yang sama, perintah akan terlihat seperti berikut:

   azdata app describe --name add-app --version v1

Konten yang swagger.json dapat Anda tempelkan ke Editor Swagger. Anda akan melihat bahwa layanan web mengekspos run metode , dan di bawahnya melalui proksi aplikasi, yang merupakan API web yang mengautentikasi pengguna dan kemudian merutekan permintaan ke aplikasi. Perhatikan bahwa URL Dasar ditampilkan di bagian atas. Anda dapat menggunakan alat pilihan Anda untuk memanggil run metode (https://[IP]:30778/api/app/[appname]/[version]/run), meneruskan parameter dalam isi permintaan POST Anda sebagai json.

Dalam contoh ini, kita akan menggunakan Postman. Sebelum melakukan panggilan, Anda harus mengatur Authorization ke Bearer Token dan menempelkan token yang Anda ambil sebelumnya. Ini akan mengatur header pada permintaan Anda. Lihat cuplikan layar di bawah ini.

Header Eksekusi Postman

Selanjutnya, di isi permintaan, teruskan parameter ke aplikasi yang Anda panggil dan atur content-type ke application/json:

Isi Eksekusi Postman

Saat mengirim permintaan, Anda akan mendapatkan output yang sama seperti saat menjalankan aplikasi melalui azdata app run:

Hasil Eksekusi Postman

Anda sekarang telah berhasil memanggil aplikasi melalui layanan web. Anda dapat mengikuti langkah serupa untuk mengintegrasikan layanan web ini di aplikasi Anda.

Langkah berikutnya

Jelajahi cara Memantau aplikasi pada kluster big data untuk informasi selengkapnya. Anda juga dapat memeriksa sampel tambahan di Sampel Penyebaran Aplikasi.

Untuk informasi selengkapnya tentang SQL Server Kluster Big Data, lihat Apa yang Kluster Big Data SQL Server 2019.