Sebarkan Azure SQL Edge

Penting

Azure SQL Edge dihentikan per 30 September 2025. Untuk informasi selengkapnya dan opsi migrasi, lihat Pemberitahuan Penghentian Layanan.

Nota

Azure SQL Edge tidak lagi mendukung platform ARM64.

Azure SQL Edge adalah mesin database relasional yang dioptimalkan yang ditujukan untuk penyebaran IoT dan IoT Edge. Azure SQL Edge memberikan kemampuan untuk membuat penyimpanan data berperforma tinggi dan lapisan pemrosesan untuk aplikasi dan solusi IoT. Quickstart ini menunjukkan kepada Anda cara memulai pembuatan modul Azure SQL Edge melalui Azure IoT Edge menggunakan portal Microsoft Azure.

Sebelum Anda mulai

• Jika Anda tidak memiliki langganan Azure, buat akun gratis.
• Masuk ke portal Azure.
• Buat Azure IoT Hub.
• Buat perangkat Azure IoT Edge.

Nota

Untuk menerapkan Azure Linux VM sebagai perangkat IoT Edge, lihat panduan quickstart ini.

Menyebarkan Modul Azure SQL Edge menggunakan IoT Hub

Azure SQL Edge dapat disebarkan menggunakan instruksi dari Sebarkan modul dari portal Azure. URI gambar untuk Azure SQL Edge adalah mcr.microsoft.com/azure-sql-edge:latest.

1. Pada halaman Tambahkan Modul IoT Edge, tentukan nilai yang diinginkan untuk Nama Modul IoT Edge, URI Gambar, Kebijakan Hidupkan Ulang, dan Status yang Diinginkan.

   Gunakan URI gambar berikut tergantung pada edisi yang ingin Anda sebarkan:

   • Edisi pengembang - mcr.microsoft.com/azure-sql-edge/developer
   • Edisi premium - mcr.microsoft.com/azure-sql-edge/premium

2. Pada bagian Variabel Lingkungan dari halaman Tambahkan Modul IoT Edge, tentukan nilai yang diinginkan untuk variabel lingkungan. Untuk daftar lengkap variabel lingkungan Azure SQL Edge, lihat Mengonfigurasi menggunakan variabel lingkungan.

   Pengaturan	Description
   ACCEPT_EULA	Atur nilai ini ke Y untuk menerima Perjanjian Lisensi Pengguna Akhir
   MSSQL_SA_PASSWORD	Atur nilai untuk menentukan kata sandi yang kuat untuk akun admin SQL Edge.
   MSSQL_LCID	Atur nilai untuk mengatur ID bahasa yang diinginkan untuk digunakan untuk SQL Edge. Misalnya, 1036 adalah Bahasa Perancis.
   MSSQL_COLLATION	Atur nilai untuk mengatur kolase default untuk SQL Edge. Pengaturan ini menggantikan pemetaan default ID bahasa (LCID) ke kolase.

3. Pada bagian Opsi Buat Kontainer dari halaman Tambahkan Modul IoT Edge, atur opsi sesuai persyaratan.

   • Host Port

     Petakan port host yang ditentukan ke port 1433 (port SQL default) dalam kontainer.

   • Ikatan dan Pemasangan

     Jika Anda perlu menyebarkan lebih dari satu modul SQL Edge, pastikan Anda memperbarui opsi pemasangan untuk membuat pasangan sumber dan target baru untuk volume persisten. Untuk informasi selengkapnya tentang pemasangan dan volume, lihat Menggunakan volume pada dokumentasi Docker.

   {
       "HostConfig": {
           "CapAdd": [
               "SYS_PTRACE"
           ],
           "Binds": [
               "sqlvolume:/sqlvolume"
           ],
           "PortBindings": {
               "1433/tcp": [
                   {
                       "HostPort": "1433"
                   }
               ]
           },
           "Mounts": [
               {
                   "Type": "volume",
                   "Source": "sqlvolume",
                   "Target": "/var/opt/mssql"
               }
           ]
       },
       "Env": [
           "MSSQL_AGENT_ENABLED=TRUE",
           "ClientTransportType=AMQP_TCP_Only",
           "PlanId=asde-developer-on-iot-edge"
       ]
   }
   

   Penting

   Atur PlanId variabel lingkungan berdasarkan edisi yang diinstal.

   • Edisi pengembang - asde-developer-on-iot-edge
   • Edisi premium - asde-premium-on-iot-edge

   Jika nilai ini salah diatur, kontainer Azure SQL Edge gagal dimulai.

   Peringatan

   Jika Anda menginstal ulang modul, ingatlah untuk menghapus pengikatan yang ada terlebih dahulu, jika tidak, variabel lingkungan Anda tidak akan diperbarui.

4. Pada halaman Tambahkan Modul IoT Edge, pilih Tambahkan.

5. Pada halaman Atur modul di perangkat, pilih Berikutnya: Rute > jika Anda perlu menentukan rute untuk penyebaran Anda. Jika tidak, pilih Tinjau + Buat. Untuk informasi selengkapnya tentang mengonfigurasi rute, lihat Menerapkan modul dan menetapkan rute di IoT Edge.

6. Pada halaman Atur modul pada perangkat , pilih Buat.

Sambungkan ke Azure SQL Edge

Langkah-langkah berikut menggunakan alat baris perintah Azure SQL Edge, sqlcmd, di dalam kontainer untuk menyambungkan ke Azure SQL Edge.

Nota

Alat baris perintah SQL Server, termasuk sqlcmd, tidak tersedia di dalam kontainer Azure SQL Edge versi ARM64.

1. Menggunakan docker exec -it perintah untuk memulai shell bash interaktif di dalam kontainer Anda yang sedang berjalan. Dalam contoh berikut, AzureSQLEdge adalah nama yang ditentukan oleh Name parameter Modul IoT Edge Anda.

   sudo docker exec -it AzureSQLEdge "bash"
   

2. Setelah berada di dalam kontainer, sambungkan secara lokal dengan alat sqlcmd . sqlcmd tidak berada di jalur secara default, jadi Anda harus menentukan jalur lengkap.

   /opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P "<YourNewStrong@Passw0rd>"
   

   Tip

   Anda dapat menghilangkan kata sandi pada baris perintah yang akan diminta untuk dimasukkan.

3. Jika berhasil, Anda harus sampai ke perintah prompt sqlcmd: 1>.

Membuat dan melakukan kueri data

Bagian berikut ini memandu Anda menggunakan sqlcmd dan Transact-SQL untuk membuat database baru, menambahkan data, dan menjalankan kueri sederhana.

Buat database baru

Langkah-langkah berikut membuat database baru bernama TestDB.

1. Dari perintah prompt sqlcmd, tempelkan perintah Transact-SQL berikut ini untuk membuat database pengujian:

   CREATE DATABASE TestDB;
   GO
   

2. Pada baris berikutnya, tulis kueri untuk mengembalikan nama semua database di server Anda:

   SELECT name from sys.databases;
   GO
   

Sisipkan data

Selanjutnya, buat tabel baru yang disebut Inventory, dan sisipkan dua baris baru.

1. Dari perintah prompt sqlcmd, alihkan konteks ke database baru TestDB:

   USE TestDB;
   

2. Buat tabel baru bernama Inventory:

   CREATE TABLE Inventory (id INT, name NVARCHAR(50), quantity INT)
   

3. Sisipkan data ke dalam tabel baru:

   INSERT INTO Inventory
   VALUES (1, 'banana', 150);
   
   INSERT INTO Inventory
   VALUES (2, 'orange', 154);
   

4. Ketik GO untuk menjalankan perintah sebelumnya:

   GO
   

Pilih data

Sekarang, jalankan kueri untuk mengembalikan data dari Inventory tabel.

1. Dari perintah prompt sqlcmd, masukkan kueri yang mengembalikan baris dari Inventory tabel di mana jumlahnya lebih besar dari 152:

   SELECT * FROM Inventory WHERE quantity > 152;
   

2. Jalankan perintah:

   GO
   

Keluar dari prompt perintah sqlcmd

1. Untuk mengakhiri sesi sqlcmd Anda, ketik QUIT:

   QUIT
   

2. Untuk keluar dari prompt perintah interaktif di kontainer Anda, ketik exit. Kontainer Anda terus berjalan setelah Anda keluar dari shell bash interaktif.

Sambungkan dari luar kontainer

Anda dapat menyambungkan dan menjalankan kueri SQL dengan instans Azure SQL Edge dari alat Linux, Windows, atau macOS eksternal yang mendukung koneksi SQL. Untuk informasi selengkapnya tentang menyambungkan ke kontainer SQL Edge dari luar, lihat Menyambungkan dan Mengkueri Azure SQL Edge.

Dalam quickstart ini, Anda menggunakan Modul Tepi SQL pada perangkat IoT Edge.

Konten terkait

• Pembelajaran Mesin dan Kecerdasan Buatan dengan ONNX di SQL Edge
• Membangun Solusi IoT end to end dengan SQL Edge menggunakan IoT Edge
• Streaming Data di Azure SQL Edge
• Memecahkan masalah kesalahan penerapan