Cara menyebarkan aplikasi di Kluster Big Data SQL Server

Berlaku untuk: SQL Server 2019 (15.x)

Important

Kluster Big Data Microsoft SQL Server 2019 dihentikan. Dukungan untuk Kluster Big Data SQL Server 2019 berakhir per 28 Februari 2025. Untuk informasi selengkapnya, lihat posting blog pengumuman dan Opsi big data di platform Microsoft SQL Server.

Aplikasi yang disebarkan pada Kluster Big Data SQL Server 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.

Prerequisites

Capabilities

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.

Command	Description
`azdata login`	Masuk ke kluster big data SQL Server
`azdata app create`	Create application.
`azdata app delete`	Delete application.
`azdata app describe`	Describe application.
`azdata app init`	Mulai kerangka aplikasi baru.
`azdata app list`	List application(s).
`azdata app run`	Run application.
`azdata app update`	Update application.

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

azdata app create --help

Bagian berikut ini menjelaskan perintah ini secara lebih rinci.

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:

Salin kode Python berikut ke dalam file ini: Copy the following Python code into this file:
```
#add.py
def add(x, y):
  result = x+y
  return result
result=add(x,y)
```

Salin kode berikut ke dalam file ini: Copy the following code into this file:

#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 tampilan stateWaitingforCreate sebagai contoh berikut:

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

Setelah penyebaran berhasil, Anda akan melihat state berubah menjadi status Ready.

[
  {
    "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 akan melihat output yang mirip dengan contoh berikut:

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

Jelajahi cara mengintegrasikan aplikasi yang disebarkan di Kluster Big Data SQL Server di 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.

Last updated on 2023-12-04