تكوين Azure SQL Edge

يدعم Azure SQL Edge التكوين من خلال أحد الخيارين التاليين:

• متغيرات البيئة
• ملف mssql.conf موضوع في المجلد /var/opt/mssql

التكوين باستخدام متغيرات البيئة

يعرض Azure SQL Edge العديد من متغيرات البيئة المختلفة التي يمكن استخدامها لتكوين حاوية SQL Edge. متغيرات البيئة هذه هي مجموعة فرعية من تلك المتوفرة ل SQL Server على Linux. لمزيد من المعلومات حول SQL Server على متغيرات بيئة Linux، راجع متغيرات البيئة.

تمت إضافة متغيرات البيئة الجديدة التالية إلى Azure SQL Edge.

متغير بيئة SQL Server التالي على Linux غير مدعوم ل Azure SQL Edge. إذا تم تعريفه، يتم تجاهل متغير البيئة هذا أثناء تهيئة الحاوية.

تحديد متغيرات البيئة

حدد متغيرات البيئة ل SQL Edge عند نشر الخدمة من خلال مدخل Microsoft Azure. يمكنك إضافتها إما في قسم متغيرات البيئة من نشر الوحدة النمطية أو كجزء من خيارات إنشاء الحاوية.

إضافة قيم في متغيرات البيئة.

إضافة قيم في Container Create Options.

التكوين باستخدام mssql.conf ملف

لا يتضمن Azure SQL Edge الأداة المساعدة لتكوين mssql-conf مثل SQL Server على Linux. تحتاج إلى تكوين ملف mssql.conf يدويا ووضعه في محرك أقراص التخزين المستمر الذي تم تعيينه إلى المجلد /var/opt/mssql/ في وحدة SQL Edge. عند نشر SQL Edge من خلال Azure IoT Hub، يتم تحديد هذا التعيين كخيار عمليات التحميل في خيارات إنشاء الحاوية.

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

تمت إضافة خيارات mssql.conf الجديدة التالية ل Azure SQL Edge.

لا تنطبق خيارات mssql.conf التالية على SQL Edge:

يعمل نموذج ملف mssql.conf التالي مع SQL Edge. لمزيد من المعلومات حول تنسيق mssql.conf ملف، راجع تنسيق 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

تشغيل Azure SQL Edge كمستخدم غير جذر

بشكل افتراضي، يتم تشغيل حاويات Azure SQL Edge مع مستخدم/مجموعة غير جذر. عند النشر من خلال Azure IoT Hub (أو باستخدام docker run)، ما لم يتم تحديد مستخدم/مجموعة مختلفة، تبدأ حاويات SQL Edge كمستخدم mssql (غير الجذر). لتحديد مستخدم مختلف غير جذري أثناء النشر، أضف *"User": "<name|uid>[:<group|gid>]"* زوج قيمة المفتاح ضمن خيارات إنشاء الحاوية. في المثال التالي، تم تكوين SQL Edge للبدء كمستخدم *IoTAdmin*.

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

للسماح للمستخدم غير الجذر بالوصول إلى ملفات DB الموجودة على وحدات التخزين المثبتة، تأكد من أن المستخدم/المجموعة التي تقوم بتشغيل الحاوية ضمنها، لديه أذونات القراءة والكتابة على تخزين الملفات المستمر. في المثال التالي، قمنا بتعيين المستخدم غير الجذر مع user_id 10001 كمالك الملفات.

chown -R 10001:0 <database file dir>

الترقية من إصدارات CTP السابقة

تم تكوين CTPs السابقة من Azure SQL Edge للتشغيل كمستخدمي الجذر. تتوفر الخيارات التالية عند الترقية من CTPs السابقة.

• استمر في استخدام المستخدم الجذر - لمتابعة استخدام المستخدم الجذر، أضف *"User": "0:0"* زوج قيمة المفتاح ضمن خيارات إنشاء الحاوية.

• استخدم مستخدم mssql الافتراضي - لاستخدام مستخدم mssql الافتراضي، اتبع الخطوات التالية:

  • إضافة مستخدم باسم mssql على مضيف Docker. في المثال أدناه، نضيف مستخدم mssql مع المعرف 10001. تتم إضافة هذا المستخدم أيضا إلى مجموعة الجذر.

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

  • تغيير الإذن على وحدة تخزين الدليل/التحميل حيث يوجد ملف قاعدة البيانات

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

• استخدام حساب مستخدم مختلف غير جذري - لاستخدام حساب مستخدم مختلف غير جذري

  • قم بتحديث خيارات إنشاء الحاوية لتحديد إضافة *"User": "user_name | user_id* زوج قيمة المفتاح ضمن خيارات إنشاء الحاوية. استبدل user_name أو user_id user_name الفعلي أو user_id من مضيف Docker.
  • تغيير الأذونات على وحدة تخزين الدليل/التحميل.

الاحتفاظ ببياناتك

تستمر تغييرات تكوين Azure SQL Edge وملفات قاعدة البيانات في الحاوية حتى إذا قمت بإعادة تشغيل الحاوية باستخدام docker stop و docker start. ومع ذلك، إذا قمت بإزالة الحاوية باستخدام docker rm، يتم حذف كل شيء في الحاوية، بما في ذلك Azure SQL Edge وقواعد البيانات الخاصة بك. يشرح القسم التالي كيفية استخدام وحدات تخزين البيانات لاستمرار ملفات قاعدة البيانات حتى إذا تم حذف الحاويات المقترنة.

تحميل دليل مضيف كحجم بيانات

الخيار الأول هو تحميل دليل على المضيف الخاص بك كحجم بيانات في الحاوية الخاصة بك. للقيام بذلك، استخدم docker run الأمر مع العلامة -v <host directory>:/var/opt/mssql . يسمح هذا باستعادة البيانات بين عمليات تنفيذ الحاوية.

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

تمكنك هذه التقنية أيضا من مشاركة الملفات وعرضها على المضيف خارج Docker.

استخدام حاويات وحدة تخزين البيانات

الخيار الثاني هو استخدام حاوية وحدة تخزين البيانات. يمكنك إنشاء حاوية وحدة تخزين بيانات عن طريق تحديد اسم وحدة تخزين بدلا من دليل مضيف مع المعلمة -v . ينشئ المثال التالي وحدة تخزين بيانات مشتركة تسمى 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

حتى إذا قمت بإيقاف هذه الحاوية وإزالتها، يستمر حجم البيانات. يمكنك عرضه باستخدام docker volume ls الأمر .

docker volume ls

إذا قمت بعد ذلك بإنشاء حاوية أخرى بنفس اسم وحدة التخزين، فإن الحاوية الجديدة تستخدم نفس بيانات Azure SQL Edge المضمنة في وحدة التخزين.

لإزالة حاوية وحدة تخزين بيانات، استخدم docker volume rm الأمر .

المحتوى ذو الصلة

• الاتصال ب Azure SQL Edge
• إنشاء حل IoT شامل باستخدام SQL Edge