Konfigurieren von Azure SQL Edge

Azure SQL Edge unterstützt die Konfiguration mit einer der folgenden beiden Optionen:

• Umgebungsvariablen
• Verwenden der Datei „mssql.conf“, die im Ordner „/var/opt/mssql“ abgelegt wurde.

Konfigurieren mithilfe von Umgebungsvariablen

Azure SQL Edge stellt mehrere verschiedene Umgebungsvariablen bereit, mit denen der SQL Edge-Container konfiguriert werden kann. Diese Umgebungsvariablen sind eine Teilmenge derjenigen, die unter Linux für SQL Server verfügbar sind. Weitere Informationen zu Umgebungsvariablen für SQL Server unter Linux finden Sie unter Umgebungsvariablen.

Die folgenden neuen Umgebungsvariablen wurden zu Azure SQL Edge hinzugefügt.

Die folgenden Umgebungsvariablen für SQL Server unter Linux werden von Azure SQL Edge nicht unterstützt. Falls definiert, werden sie während der Containerinitialisierung ignoriert.

Angeben der Umgebungsvariablen

Geben Sie Umgebungsvariablen für SQL Edge an, wenn Sie den Dienst über das Azure-Portal bereitstellen. Sie können sie entweder im Abschnitt Umgebungsvariablen der Modulbereitstellung oder als Teil der Optionen für die Containererstellung hinzufügen.

Fügen Sie Werte in Umgebungsvariablen hinzu.

Fügen Sie Werte in Optionen für die Containererstellung hinzu.

Konfigurieren mithilfe der Datei mssql.conf

Azure SQL Edge enthält nicht wie SQL Server unter Linux das Konfigurationshilfsprogramm mssql-conf. Sie müssen die Datei „mssql.conf“ manuell konfigurieren und auf dem persistenten Speicherlaufwerk ablegen, das dem Ordner „/var/opt/mssql/“ im Modul „SQL Edge“ zugeordnet ist. Beim Bereitstellen von SQL Edge über Azure IoT Hub wird diese Zuordnung als Option Mounts in den Optionen zur Containererstellung angegeben.

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

Die folgenden neuen „mssql.conf“-Optionen wurden für Azure SQL Edge hinzugefügt.

Die folgenden Optionen von „mssql.conf“ gelten nicht für SQL Edge:

Die folgende Beispieldatei für „mssql.conf“ funktioniert für SQL Edge. Weitere Informationen zum Format der Datei mssql.conf finden Sie unter mssql.conf-Format.

[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

Ausführen von Azure SQL Edge als Nicht-root-Benutzer

Azure SQL Edge-Container werden standardmäßig als Nicht-root-Benutzer bzw. -Gruppe ausgeführt. Bei der Bereitstellung über Azure IoT Hub (oder mithilfe von docker run) starten SQL Edge-Container als mssql-Benutzer (nicht root), wenn kein anderer Benutzer bzw. keine andere Gruppe angegeben wird. Um während der Bereitstellung einen anderen Nicht-root-Benutzer anzugeben, fügen Sie das *"User": "<name|uid>[:<group|gid>]"*-Schlüssel-Wert-Paar unter den Optionen zum Erstellen von Containern hinzu. Im folgenden Beispiel ist SQL Edge so konfiguriert, dass es als *IoTAdmin*-Benutzer gestartet wird.

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

Um dem Nicht-root-Benutzer den Zugriff auf DB-Dateien zu ermöglichen, die sich auf bereitgestellten Volumes befinden, stellen Sie sicher, dass der Benutzer bzw. die Gruppe, unter dem/r Sie den Container ausführen, Lese- und Schreibberechtigungen für den persistenten Dateispeicher besitzt. Im folgenden Beispiel legen wir den Nicht-root-Benutzer mit user_id von 10001 als Besitzer der Dateien fest.

chown -R 10001:0 <database file dir>

Upgrade von früheren CTP-Versionen

Frühere CTP-Versionen von Azure SQL Edge waren so konfiguriert, dass sie als root-Benutzer ausgeführt wurden. Die folgenden Optionen sind verfügbar, wenn Sie ein Upgrade aus früheren CTP-Versionen durchführen.

• Root-Benutzer weiterhin verwenden: Um weiterhin den root-Benutzer zu verwenden, fügen Sie das *"User": "0:0"*-Schlüssel-Wert-Paar unter den Optionen zum Erstellen von Containern hinzu.

• Mssql-Standardbenutzer verwenden: Um den mssql-Standardbenutzer zu verwenden, führen Sie diese Schritte aus:

  • Fügen Sie einen Benutzer mit dem Namen mssql auf dem Docker-Host hinzu. Im folgenden Beispiel fügen wir einen Benutzer „mssql“ mit der ID 10001 hinzu. Dieser Benutzer wird auch der root-Gruppe hinzugefügt.

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

  • Ändern Sie die Berechtigung für das Verzeichnis/Bereitstellungsvolume, in dem sich die Datenbankdatei befindet.

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

• Ein anderes Nicht-root-Benutzerkonto verwenden: Um ein anderes Nicht-root-Benutzerkonto zu verwenden.

  • Aktualisieren Sie die Optionen zum Erstellen von Containern, um das *"User": "user_name | user_id*-Schlüssel-Wert-Paar unter den Optionen zum Erstellen von Containern hinzuzufügen. Ersetzen Sie user_name oder user_id durch einen tatsächlichen user_name oder eine tatsächliche user_id von Ihrem Docker-Host.
  • Ändern Sie die Berechtigungen für das Verzeichnis/Bereitstellungsvolume.

Beibehalten von Daten

Die Azure SQL Edge-Konfigurationsänderungen und -Datenbankdateien werden im Container beibehalten, auch wenn Sie den Container mit docker stop und docker start neu starten. Wenn Sie den Container jedoch mit docker rm entfernen, werden sämtliche Inhalte des Containers gelöscht, einschließlich Azure SQL Edge und Ihrer Datenbanken. Im folgenden Abschnitt wird erläutert, wie Datenvolumes verwendet werden, um Ihre Datenbankdateien beizubehalten, auch wenn die zugeordneten Container gelöscht werden.

Einbinden eines Hostverzeichnisses als Datenvolume

Die erste Option besteht darin, ein Verzeichnis auf dem Host als Datenvolume in Ihrem Container einzubinden. Verwenden Sie hierzu den Befehl docker run mit dem Flag -v <host directory>:/var/opt/mssql. Dadurch können die Daten zwischen den Containerausführungen wiederhergestellt werden.

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

Mit dieser Methode können Sie die Dateien auch außerhalb von Docker auf dem Host freigeben und anzeigen.

Verwenden von Datenvolumecontainern

Die zweite Option besteht in der Verwendung eines Datenvolumecontainers. Sie können einen Datenvolumecontainer erstellen, indem Sie mit dem Parameter -v einen Volumenamen anstelle eines Hostverzeichnisses angeben. Im folgenden Beispiel wird ein freigegebenes Datenvolume mit dem Namen sqlvolume erstellt.

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

Auch wenn Sie diesen Container anhalten und entfernen, bleibt das Datenvolume erhalten. Sie können es mit dem Befehl docker volume ls anzeigen.

docker volume ls

Wenn Sie dann einen weiteren Container mit dem gleichen Volumenamen erstellen, verwendet der neue Container die gleichen Azure SQL Edge-Daten, die auch im Volume enthalten sind.

Verwenden Sie den Befehl docker volume rm, um einen Datenvolumecontainer zu entfernen.

Zugehöriger Inhalt

• Herstellen einer Verbindung mit Azure SQL Edge
• Erstellen einer End-to-End-IoT-Lösung mit SQL Edge