Cara menyebarkan aplikasi di SQL Server Kluster Big Data

Berlaku untuk: SQL Server 2019 (15.x)

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.

Aplikasi yang disebarkan pada SQL Server Kluster Big Data tidak hanya mendapat manfaat dari banyak keuntungan seperti kekuatan komputasi kluster tetapi juga mengakses data besar yang tersedia di kluster. Ini secara dramatis meningkatkan performa karena aplikasi Anda berada di kluster yang sama tempat data berada.

Aplikasi disebarkan dan dikelola menggunakan Azure Data CLI (azdata).

Artikel ini menyediakan contoh cara menyebarkan aplikasi dari baris perintah di dalam SQL Server Big Data Cluster. Untuk mempelajari cara menggunakannya di Visual Studio Code lihat Ekstensi Visual Studio Code.

Prasyarat

Kemampuan

Di SQL Server 2019 Anda dapat membuat, menghapus, menjelaskan, menginisialisasi, mencantumkan eksekusi, dan memperbarui aplikasi Anda. Tabel berikut menjelaskan perintah penyebaran aplikasi yang bisa Anda gunakan dengan azdata.

Perintah Deskripsi
azdata login Masuk ke kluster big data SQL Server
azdata app create Buat aplikasi.
azdata app delete Hapus aplikasi.
azdata app describe Jelaskan aplikasi.
azdata app init Mulai kerangka aplikasi baru.
azdata app list Mencantumkan aplikasi.
azdata app run Jalankan aplikasi.
azdata app update Perbarui aplikasi.

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

azdata app create --help

Bagian berikut menjelaskan perintah ini secara lebih rinci.

Masuk

Sebelum Anda menyebarkan atau berinteraksi dengan aplikasi, pertama-tama masuk ke kluster big data SQL Server Anda dengan azdata login perintah . Tentukan alamat controller-svc-external IP eksternal layanan (misalnya: https://ip-address:30080) bersama dengan nama pengguna dan kata sandi ke kluster.

azdata login --controller-endpoint https://<ip-address-of-controller-svc-external>:30080 --controller-username <user-name>

Azure Kubernetes Service (AKS)

Jika Anda menggunakan AKS, Anda perlu menjalankan perintah berikut untuk mendapatkan alamat controller-svc-external IP layanan dengan menjalankan perintah ini di jendela bash atau cmd:

kubectl get svc controller-svc-external -n <name of your big data cluster>

Kluster Kubernetes dibuat dengan kubeadm

Jalankan perintah berikut untuk mendapatkan alamat IP untuk masuk ke kluster

kubectl get node --selector='node-role.kubernetes.io/master'

Membuat kerangka aplikasi

Perintah azdata app init menyediakan perancah dengan artefak relevan yang diperlukan untuk menyebarkan aplikasi. Contoh di bawah ini membuat add-app, Anda dapat melakukan ini dengan menjalankan perintah berikut.

azdata app init --name add-app --version v1 --template python

Ini akan membuat folder bernama hello. Anda dapat menggunakan cd perintah ke direktori dan memeriksa file yang dihasilkan di folder. spec.yaml mendefinisikan aplikasi, seperti nama, versi, dan kode sumber. Anda dapat mengedit spesifikasi untuk mengubah nama, versi, input, dan output.

Berikut adalah sampel output dari perintah init yang akan Anda lihat di folder

add-app.py
run-spec.yaml
spec.yaml

Buat aplikasi

Untuk membuat aplikasi, Anda menggunakan Azure Data CLI (azdata) dengan app create perintah . File-file ini berada secara lokal di komputer tempat Anda membuat aplikasi.

Gunakan sintaks berikut untuk membuat aplikasi baru di kluster big data:

azdata app create --spec <directory containing spec file>

Perintah berikut ini memperlihatkan contoh seperti apa perintah ini:

azdata app create --spec ./addpy

Ini mengasumsikan bahwa Anda memiliki aplikasi yang disimpan di addpy folder . Folder ini juga harus berisi file spesifikasi untuk aplikasi, yang disebut spec.yaml. Untuk informasi selengkapnya, lihat halaman Penyebaran Aplikasi pada spec.yaml file.

Untuk menyebarkan aplikasi sampel aplikasi ini, buat file berikut di direktori yang disebut addpy:

  • add.py. Salin kode Python berikut ke dalam file ini:
    #add.py
    def add(x, y):
      result = x+y
      return result
    result=add(x,y)
    
  • spec.yaml. Salin kode berikut ke dalam file ini:
    #spec.yaml
    name: add-app #name of your python script
    version: v1  #version of the app
    runtime: Python #the language this app uses (R or Python)
    src: ./add.py #full path to the location of the app
    entrypoint: add #the function that will be called upon execution
    replicas: 1  #number of replicas needed
    poolsize: 1  #the pool size that you need your app to scale
    inputs:  #input parameters that the app expects and the type
       x: int
       y: int
    output: #output parameter the app expects and the type
       result: int
    

Kemudian, jalankan perintah di bawah ini:

azdata app create --spec ./addpy

Anda dapat memeriksa apakah aplikasi disebarkan menggunakan perintah daftar:

azdata app list

Jika penyebaran tidak selesai, Anda akan melihat peragaan stateWaitingforCreate sebagai contoh berikut:

[
  {
    "name": "add-app",
    "state": "WaitingforCreate",
    "version": "v1"
  }
]

Setelah penyebaran berhasil, Anda akan melihat perubahan Ready statusstate:

[
  {
    "name": "add-app",
    "state": "Ready",
    "version": "v1"
  }
]

Mencantumkan aplikasi

Anda dapat mencantumkan aplikasi apa pun yang berhasil dibuat dengan app list perintah .

Perintah berikut mencantumkan semua aplikasi yang tersedia di kluster big data Anda:

azdata app list

Jika Anda menentukan nama dan versi, itu mencantumkan aplikasi tertentu dan statusnya (Membuat atau Siap):

azdata app list --name <app_name> --version <app_version>

Contoh berikut menunjukkan perintah ini:

azdata app list --name add-app --version v1

Anda harus melihat output yang mirip dengan berikut ini:

[
  {
    "name": "add-app",
    "state": "Ready",
    "version": "v1"
  }
]

Menghapus aplikasi

Untuk menghapus aplikasi dari kluster big data Anda, gunakan sintaks berikut:

azdata app delete --name add-app --version v1

Langkah berikutnya

Jelajahi cara mengintegrasikan aplikasi yang disebarkan pada SQL Server Kluster Big Data di aplikasi Anda sendiri di Menjalankan aplikasi pada kluster big data dan Mengonsumsi aplikasi pada kluster big data untuk informasi lebih lanjut. Anda juga dapat memeriksa sampel tambahan di Sampel Penyebaran Aplikasi.

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