Konfigurasi Azure SQL Edge

Azure SQL Edge mendukung konfigurasi melalui salah satu dari dua opsi berikut:

• Variabel lingkungan
• File mssql.conf ditempatkan di folder /var/opt/mssql

Mengonfigurasi dengan menggunakan variabel lingkungan

Azure SQL Edge memaparkan beberapa variabel lingkungan berbeda yang dapat digunakan untuk mengonfigurasi kontainer SQL Edge. Variabel lingkungan ini adalah subset dari variabel yang tersedia untuk SQL Server di Linux. Untuk informasi selengkapnya tentang SQL Server pada variabel lingkungan Linux, lihat Variabel lingkungan.

Variabel lingkungan baru berikut ditambahkan ke Azure SQL Edge.

SQL Server berikut pada variabel lingkungan Linux tidak didukung untuk Azure SQL Edge. Jika ditentukan, variabel lingkungan ini diabaikan selama inisialisasi kontainer.

Tentukan variabel lingkungan

Tentukan variabel lingkungan untuk SQL Edge saat Anda menyebarkan layanan melalui portal Microsoft Azure. Anda dapat menambahkannya baik di bagian Variabel Lingkungan dari penyebaran modul atau sebagai bagian dari Opsi Pembuatan Kontainer.

Menambahkan nilai dalam Variabel Lingkungan.

Tambahkan nilai dalam Opsi Pembuatan Kontainer.

Konfigurasikan dengan menggunakan mssql.conf file

Azure SQL Edge tidak menyertakan utilitas konfigurasi mssql-conf seperti yang dilakukan SQL Server di Linux. Anda perlu mengonfigurasi file mssql.conf secara manual dan menempatkannya di drive penyimpanan persisten yang dipetakan ke folder /var/opt/mssql/ dalam modul SQL Edge. Saat Anda menyebarkan SQL Edge melalui Azure IoT Hub, pemetaan ini ditentukan sebagai opsi Pemasangan di Opsi Buat Kontainer.

{
  "Mounts": [
    {
      "Type": "volume",
      "Source": "sqlvolume",
      "Target": "/var/opt/mssql"
    }
  ]
}

Opsi mssql.conf baru berikut ditambahkan untuk Azure SQL Edge.

Opsi mssql.conf berikut ini tidak berlaku untuk SQL Edge:

Contoh file mssql.conf berikut berfungsi untuk SQL Edge. Untuk informasi selengkapnya tentang format untuk mssql.conffile, lihatformat mssql.conf.

[EULA]
accepteula = Y

[coredump]
captureminiandfull = true
coredumptype = full

[filelocation]
defaultbackupdir = /var/opt/mssql/backup/
defaultdatadir = /var/opt/mssql/data/
defaultdumpdir = /var/opt/mssql/data/
defaultlogdir = /var/opt/mssql/log/

[language]
lcid = 1033

[memory]
memorylimitmb = 6144

[sqlagent]
errorlogfile = /var/opt/mssql/log/sqlagentlog.log
errorlogginglevel = 7

[traceflag]
traceflag0 = 3604
traceflag1 = 3605
traceflag2 = 1204

Jalankan Azure SQL Edge sebagai pengguna non-root

Secara default, kontainer Azure SQL Edge berjalan dengan pengguna/grup non-root. Saat disebarkan melalui Azure IoT Hub (atau menggunakan docker run), kecuali pengguna/grup yang berbeda ditentukan, kontainer SQL Edge dimulai sebagai pengguna mssql (non-root). Untuk menentukan pengguna non-root yang berbeda selama penyebaran, tambahkan pasangan kunci nilai *"User": "<name|uid>[:<group|gid>]"* di bawah opsi pembuatan kontainer. Dalam contoh berikut, SQL Edge dikonfigurasi untuk memulai sebagai pengguna *IoTAdmin*.

{
    ..
    ..
    ..
    "User": "IoTAdmin",
    "Env": [
        "MSSQL_AGENT_ENABLED=TRUE",
        "ClientTransportType=AMQP_TCP_Only",
        "MSSQL_PID=Premium"
    ]
}

Untuk memungkinkan pengguna non-root mengakses file DB yang berada pada volume yang dipasang, pastikan bahwa pengguna/grup yang Anda jalankan kontainer di bawahnya, memiliki izin baca & tulis pada penyimpanan file persisten. Dalam contoh berikut, kami mengatur pengguna non-root dengan user_id 10001 sebagai pemilik file.

chown -R 10001:0 <database file dir>

Meningkatkan dari rilis CTP sebelumnya

CTP Azure SQL Edge sebelumnya dikonfigurasi untuk berjalan sebagai pengguna root. Opsi berikut ini tersedia saat meningkatkan dari CTP sebelumnya.

• Lanjutkan menggunakan pengguna root - Untuk terus menggunakan pengguna root, tambahkan pasangan kunci nilai *"User": "0:0"* di bawah opsi pembuatan kontainer.

• Gunakan pengguna mssql default - Untuk menggunakan pengguna mssql default, ikuti langkah-langkah berikut:

  • Tambahkan pengguna bernama mssql di host Docker. Dalam contoh di bawah ini, kami menambahkan mssql pengguna dengan ID 10001. Pengguna ini juga ditambahkan ke grup root.

    sudo useradd -M -s /bin/bash -u 10001 -g 0 mssql
    

  • Mengubah izin pada volume direktori/pemasangan tempat file database berada

    sudo chgrp -R 0 /var/lib/docker/volumes/kafka_sqldata/
    sudo chmod -R g=u /var/lib/docker/volumes/kafka_sqldata/
    

• Menggunakan akun pengguna non-root yang berbeda - Untuk menggunakan akun pengguna non-root yang berbeda

  • Perbarui opsi buat kontainer untuk menentukan dan menambahkan pasangan kunci-nilai *"User": "user_name | user_id* di bawah opsi pembuatan kontainer. Ganti user_name atau user_id dengan user_name atau user_id aktual dari host Docker Anda.
  • Mengubah izin pada volume direktori/pemasangan.

Pertahankan data Anda

Perubahan konfigurasi Azure SQL Edge dan file database Anda tetap ada di kontainer meskipun Anda memulai ulang kontainer dengan docker stop dan docker start. Namun, jika Anda menghapus kontainer dengan docker rm, semua yang ada di kontainer akan dihapus, termasuk Azure SQL Edge dan database Anda. Bagian berikut menjelaskan cara menggunakan volume data untuk mempertahankan file database Anda meskipun kontainer terkait dihapus.

Memasang direktori host sebagai volume data

Opsi pertama adalah memasang direktori pada host Anda sebagai volume data di kontainer Anda. Untuk melakukannya, gunakan perintah docker run dengan bendera -v <host directory>:/var/opt/mssql. Tindakan ini memungkinkan data dipulihkan di antara eksekusi kontainer.

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<password>' -p 1433:1433 -v <host directory>/data:/var/opt/mssql/data -v <host directory>/log:/var/opt/mssql/log -v <host directory>/secrets:/var/opt/mssql/secrets -d mcr.microsoft.com/azure-sql-edge

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" -p 1433:1433 -v <host directory>/data:/var/opt/mssql/data -v <host directory>/log:/var/opt/mssql/log -v <host directory>/secrets:/var/opt/mssql/secrets -d mcr.microsoft.com/azure-sql-edge

Teknik ini juga memungkinkan Anda untuk berbagi dan melihat file di host di luar Docker.

Menggunakan kontainer volume data

Opsi kedua adalah menggunakan kontainer volume data. Anda dapat membuat kontainer volume data dengan menentukan nama volume, bukan direktori host dengan parameter -v. Contoh berikut membuat volume data bersama bernama sqlvolume.

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<password>' -p 1433:1433 -v sqlvolume:/var/opt/mssql -d mcr.microsoft.com/azure-sql-edge

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" -p 1433:1433 -v sqlvolume:/var/opt/mssql -d mcr.microsoft.com/azure-sql-edge

Bahkan jika Anda menghentikan dan menghapus kontainer ini, volume data tetap ada. Anda dapat melihatnya dengan perintah docker volume ls.

docker volume ls

Jika Anda kemudian membuat kontainer lain dengan nama volume yang sama, kontainer baru menggunakan data Azure SQL Edge yang sama yang berada dalam volume.

Untuk menghapus wadah volume data, gunakan perintah docker volume rm.

Konten terkait

• Menyambungkan ke Azure SQL Edge
• Membangun solusi IoT menyeluruh dengan SQL Edge