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 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 state
WaitingforCreate
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.