Configurare SQL Edge di Azure

SQL Edge di Azure supporta la configurazione tramite una delle due opzioni seguenti:

• Variabili di ambiente
• Un file mssql.conf presente nella cartella /var/opt/mssql

Configurare con le variabili di ambiente

SQL Edge di Azure espone diverse variabili di ambiente con cui è possibile configurare il contenitore SQL Edge. Queste variabili di ambiente rappresentano, in realtà, un subset di quelle disponibili per SQL Server in Linux. Per altre informazioni sulle variabili di ambiente di SQL Server in Linux, vedere Variabili di ambiente.

In SQL Edge di Azure sono state aggiunte le nuove variabili di ambiente seguenti.

La variabile di ambiente di SQL Server in Linux seguente non è supportata per SQL Edge di Azure. Se definita, questa variabile di ambiente viene ignorata durante l'inizializzazione del contenitore.

Specificare le variabili di ambiente

Specificare le variabili di ambiente per SQL Edge quando si distribuisce il servizio tramite il portale di Azure. È possibile aggiungerle nella sezione Variabili di ambiente della distribuzione del modulo o come parte delle Opzioni di creazione del contenitore.

Aggiungere valori in Variabili di ambiente.

Aggiungere valori in Opzioni di creazione del contenitore.

Configurare usando un file mssql.conf

A differenza di SQL Server in Linux, SQL Edge di Azure non include l'utilità di configurazione mssql-conf. È necessario configurare manualmente il file mssql.conf e inserirlo nell'unità di archiviazione persistente mappata alla cartella /var/opt/mssql/ nel modulo SQL Edge. Quando si distribuisce SQL Edge tramite l'hub IoT di Azure, questo mapping viene specificato come opzioneMontaggi in Opzioni di creazione del contenitore.

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

Sono state aggiunte le nuove opzioni di mssql.conf seguenti per SQL Edge di Azure.

Le opzioni di mssql.conf seguenti non sono applicabili a SQL Edge:

Il file mssql.conf di esempio seguente funziona per SQL Edge. Per altre informazioni sul formato per un file mssql.conf, vedere Formato di 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

Eseguire SQL Edge di Azure come utente non radice

Per impostazione predefinita, i contenitori di SQL Edge di Azure vengono eseguiti con un utente/gruppo non radice. Quando vengono distribuiti tramite l'hub IoT di Azure (o usando docker run), a meno che non venga specificato un altro utente/gruppo, i contenitori di SQL Edge vengono avviati come utente mssql (non radice). Per specificare un utente non radice diverso durante la distribuzione, aggiungere la coppia chiave-valore *"User": "<name|uid>[:<group|gid>]"* nelle opzioni di creazione del contenitore. Nell'esempio seguente SQL Edge è configurato per l'avvio come utente *IoTAdmin*.

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

Per consentire all'utente non radice di accedere ai file di database in volumi montati, assicurarsi che l'utente o il gruppo con cui viene eseguito il contenitore abbia autorizzazioni di lettura e scrittura per l'archivio file permanente. Nell'esempio seguente l'utente non radice viene impostato con user_id di 10001 come proprietario dei file.

chown -R 10001:0 <database file dir>

Eseguire l'aggiornamento dalle versioni CTP precedenti

Le versioni CTP precedenti di SQL Edge di Azure erano configurate per l'esecuzione come utenti radice. Quando si esegue l'aggiornamento da versioni CTP precedenti, sono disponibili le opzioni seguenti.

• Continuare a usare l'utente radice: per continuare a usare l'utente radice, aggiungere la coppia chiave-valore *"User": "0:0"* in Opzioni di creazione del contenitore.

• Usare l'utente mssql predefinito : per usare l'utente mssql predefinito, seguire questa procedura:

  • Aggiungere un utente denominato mssql nell'host Docker. Nell'esempio seguente viene aggiunto un utente mssql con ID 10001. Questo utente viene aggiunto anche al gruppo radice.

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

  • Modificare l'autorizzazione per il volume di directory/montaggio in cui risiede il file di database

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

• Usare un account utente non radice diverso: per usare un account utente diverso non radice

  • Aggiornare le opzioni di creazione del contenitore per specificare l'aggiunta della coppia chiave-valore *"User": "user_name | user_id* nelle opzioni di creazione del contenitore. Sostituire user_name o user_id con un user_name o user_id effettivo dall'host Docker.
  • Modificare le autorizzazioni per il volume di directory/montaggio.

Rendere persistenti i dati

Le modifiche apportate alla configurazione di SQL Edge di Azure e i file di database vengono salvati in modo permanente nel contenitore anche se il contenitore viene riavviato con docker stop e docker start. Tuttavia, se si rimuove il contenitore con docker rm viene eliminato tutto il contenuto al suo interno, inclusi SQL Edge di Azure e i database. La sezione seguente illustra come usare i volumi di dati per rendere persistenti i file di database anche se vengono eliminati i contenitori associati.

Montare una directory host come volume di dati

La prima opzione consiste nel montare una directory nell'host come volume di dati nel contenitore. A tale scopo, usare il comando docker run con il flag -v <host directory>:/var/opt/mssql. In questo modo è possibile ripristinare i dati tra le esecuzioni dei contenitori.

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>' -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=<YourStrong!Passw0rd>" -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

Questa tecnica consente anche di condividere e visualizzare i file nell'host all'esterno di Docker.

Usare i contenitori di volumi di dati

La seconda opzione consiste nell'usare un contenitore di volumi di dati. È possibile creare un contenitore di volumi di dati specificando un nome di volume anziché una directory host con il parametro -v. Nell'esempio seguente viene creato un volume di dati condiviso denominato sqlvolume.

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>' -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=<YourStrong!Passw0rd>" -p 1433:1433 -v sqlvolume:/var/opt/mssql -d mcr.microsoft.com/azure-sql-edge

Anche se si arresta e rimuove il contenitore, il volume di dati è persistente. È possibile visualizzarlo con il comando docker volume ls.

docker volume ls

Se successivamente si crea un altro contenitore con lo stesso nome di volume, il nuovo contenitore userà gli stessi dati di SQL Edge di Azure contenuti nel volume.

Per rimuovere un contenitore di volumi di dati, usare il comando docker volume rm.

Passaggi successivi

• Connettersi a SQL Edge di Azure
• Creare una soluzione IoT end-to-end con SQL Edge