Bagikan melalui

Sebarkan Azure SQL Edge

  • Artikel

Penting

Azure SQL Edge akan dihentikan pada 30 September 2025. Untuk informasi selengkapnya dan opsi migrasi, lihat Pemberitahuan penghentian.

Catatan

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

Catatan

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.

    Parameter Deskripsi
    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.

Catatan

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 mengkueri 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

Menyisipkan 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

Memilih 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 perintah prompt 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