Cara menyebarkan aplikasi di SQL Server Kluster Big Data

  • Artikel

Berlaku untuk: SQL Server 2019 (15.x)

Penting

Add-on Kluster Big Data Microsoft SQL Server 2019 akan dihentikan. Dukungan untuk SQL Server 2019 Kluster Big Data akan berakhir pada 28 Februari 2025. Semua pengguna SQL Server 2019 yang ada dengan Jaminan Perangkat Lunak akan didukung sepenuhnya pada platform dan perangkat lunak akan terus dipertahankan melalui pembaruan kumulatif SQL Server hingga saat itu. Untuk informasi selengkapnya, lihat posting blog pengumuman dan Opsi big data di platform Microsoft SQL Server.

Aplikasi yang disebarkan di SQL Server Kluster Big Data tidak hanya mendapat manfaat dari banyak keuntungan seperti kekuatan komputasi kluster tetapi juga mengakses data besar-besaran 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 Kluster Big Data SQL Server. Untuk mempelajari cara menggunakan ini 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 ini 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 Menghapus aplikasi.
azdata app describe Menjelaskan 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 ini 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 contoh output dari perintah init yang akan Anda lihat di folder

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

Membuat 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 menunjukkan 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 belum selesai, Anda akan melihat peragaan stateWaitingforCreate sebagai contoh berikut:

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

Setelah penyebaran berhasil, Anda akan melihat perubahan Ready ke state status:

[
  {
    "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

Konten terkait

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

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