Azure SQL Edge の構成

Azure SQL Edge では、次の 2 つのオプションのいずれかを使用した構成がサポートされています。

• 環境変数
• /var/opt/mssql フォルダーに配置される mssql.conf フォルダー

環境変数を使用して構成する

Azure SQL Edge では、SQL Edge コンテナーの構成に使用できるいくつかの異なる環境変数が公開されています。 これらの環境変数は、SQL Server on Linux で使用できる環境変数のサブセットです。 SQL Server on Linux 環境変数の詳細については、環境変数に関する記事をご覧ください。

次の新しい環境変数が Azure SQL Edge に追加されました。

次の SQL Server on Linux 環境変数は、Azure SQL Edge ではサポートされていません。 この環境変数が定義されている場合でも、コンテナーの初期化中に無視されます。

環境変数を指定する

Azure portal を使用してサービスをデプロイする場合は、SQL Edge 用の環境変数を指定します。 それらは、モジュールのデプロイの [環境変数] セクションに追加することも、[コンテナー作成オプション] の一部として追加することもできます。

[環境変数] に値を追加します。

[コンテナー作成オプション] に値を追加します。

mssql.conf ファイルを使用して構成する

Azure SQL Edge には、SQL Server on Linux に含まれているような mssql-conf 構成ユーティリティは含まれていません。 mssql.conf ファイルを手動で構成し、SQL Edge モジュールの /var/opt/mssql/ フォルダーにマップされている永続的なストレージ ドライブに配置する必要があります。 Azure IoT Hub 経由で SQL Edge をデプロイする場合、このマッピングは [コンテナー作成オプション] の [マウント] オプションとして指定されます。

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

次の新しい mssql.conf オプションが Azure SQL Edge 用に追加されました。

次の mssql.conf のオプションは、SQL Edge には適用されません。

SQL Edge では次の例の mssql.conf ファイルが機能します。 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 リリースからのアップグレード

以前の CTP の Azure SQL Edge は、ルート ユーザーとして実行するように構成されていました。 以前の CTP からアップグレードする場合は、以下のオプションを使用できます

• 引き続きルート ユーザーを使用する - ルート ユーザーを使用し続けるには、コンテナー作成オプションの下に、キーと値のペア *"User": "0:0"* を追加します。

• 既定の mssql ユーザーを使用する - 既定の mssql ユーザーを使用するには、以下の手順に従います。

  • Docker ホストに mssql という名前のユーザーを追加します。 下の例では、ID が 10001 のユーザー mssql を追加しています。 このユーザーは、ルート グループにも追加されます。

    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 は、Docker ホストの実際の user_name または user_id に置き換えてください。
  • ディレクトリまたはマウント ボリュームに対するアクセス許可を変更します。

データを保持する

docker stop と docker start を使用してコンテナーを再起動しても、Azure SQL Edge の構成変更とデータベース ファイルはコンテナーに保持されています。 一方、docker rm を使用してコンテナーを削除すると、Azure SQL Edge とデータベースを含め、コンテナーの内容がすべて削除されます。 次のセクションでは、関連付けられているコンテナーが削除された場合でも、データ ボリュームを使用してデータベース ファイルを保持する方法について説明します。

ホスト ディレクトリをデータ ボリュームとしてマウントする

1 つ目のオプションは、ホスト上のディレクトリをコンテナー内のデータ ボリュームとしてマウントすることです。 これを行うには、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 の外部にあるホスト上のファイルを共有して表示することもできます。

データ ボリューム コンテナーを使用する

2 つ目のオプションは、データ ボリューム コンテナーを使用することです。 -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 に接続する
• SQL Edge を使用してエンドツーエンドの IoT ソリューションを構築する