Azure SQL Edge 구성

아티클
02/23/2024

Important

Azure SQL Edge는 더 이상 ARM64 플랫폼을 지원하지 않습니다.

Azure SQL Edge는 다음 두 가지 옵션 중 하나를 통한 구성을 지원합니다.

환경 변수
/var/opt/mssql 폴더에 배치된 mssql.conf 파일

참고 항목

환경 변수를 설정하면 mssql.conf 파일에 지정된 설정이 재정의됩니다.

환경 변수를 사용하여 구성

Azure SQL Edge는 SQL Edge 컨테이너를 구성하는 데 사용할 수 있는 여러 가지 환경 변수를 노출합니다. 이 환경 변수는 SQL Server on Linux에 사용할 수 있는 환경 변수의 하위 집합입니다. SQL Server on Linux 환경 변수에 대한 자세한 내용은 환경 변수를 참조하세요.

다음은 Azure SQL Edge에 추가된 새 환경 변수입니다.

환경 변수	설명	값
PlanId	초기화하는 동안 사용할 Azure SQL Edge SKU를 지정합니다. 이 환경 변수는 Azure IoT Edge를 사용하여 Azure SQL Edge를 배포하는 경우에만 필요합니다.	asde-developer-on-iot-edge 또는 asde-premium-on-iot-edge
MSSQL_TELEMETRY_ENABLED	사용량 및 진단 데이터 수집을 사용하거나 사용하지 않도록 설정합니다.	True 또는 False
MSSQL_TELEMETRY_DIR	사용량 및 진단 데이터 수집 감사 파일의 대상 디렉터리를 설정합니다.	SQL Edge 컨테이너 내의 폴더 위치. 이 폴더는 탑재 지점이나 데이터 볼륨을 사용하여 호스트 볼륨에 매핑할 수 있습니다.
MSSQL_PACKAGE	배포할 dacpac 또는 bacpac 패키지의 위치를 지정합니다.	dacpac 또는 bacpac 패키지가 포함된 폴더, 파일 또는 SAS URL. 자세한 내용은 SQL Edge에 SQL Database DACPAC 및 BACPAC 패키지 배포를 참조하세요.

다음은 Azure SQL Edge에서 지원되지 않는 SQL Server on Linux 환경 변수입니다. 정의된 경우 이 환경 변수는 컨테이너 초기화 중에 무시됩니다.

환경 변수	설명
MSSQL_ENABLE_HADR	가용성 그룹을 사용하도록 설정합니다. 예를 들어, `1`은 사용하도록 설정되고 `0`은 사용하지 않도록 설정됩니다.

Important

SQL Edge에 대한 MSSQL_PID 환경 변수는 Premium 및 Developer를 유효한 값으로 허용합니다. Azure SQL Edge는 제품 키를 사용한 초기화를 지원하지 않습니다.

환경 변수 지정

Azure Portal을 통해 서비스를 배포할 때 SQL Edge의 환경 변수를 지정합니다. 모듈 배포의 환경 변수 섹션에서 또는 컨테이너 만들기 옵션의 일부로 환경 변수를 추가할 수 있습니다.

환경 변수에서 값을 추가합니다.

Screenshot of set by using environment variables list.

컨테이너 만들기 옵션에서 값을 추가합니다.

Screenshot of set by using container create options.

참고 항목

연결이 끊긴 배포 모드에서 docker run 명령의 -e, --env 또는 --env-file 옵션을 사용하여 환경 변수를 지정할 수 있습니다.

`mssql.conf` 파일을 사용하여 구성

Azure SQL Edge는 SQL Server on Linux처럼 mssql-conf 구성 유틸리티를 포함하지 않습니다. mssql.conf 파일을 수동으로 구성하고 SQL Edge 모듈의 /var/opt/mssql/ 폴더에 매핑된 영구적 스토리지 드라이브에 배치해야 합니다. Azure Marketplace에서 SQL Edge를 배포할 때 컨테이너 만들기 옵션의 탑재 옵션으로 이 매핑을 지정합니다.

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

다음은 Azure SQL Edge에 대해 추가된 새로운 mssql.conf 옵션입니다.

옵션	설명
customerfeedback	SQL Server에서 피드백을 Microsoft에 보낼지 여부를 선택합니다. 자세한 내용은 사용량 및 진단 데이터 수집 사용 안 함을 참조하세요.
userrequestedlocalauditdirectory	사용량 및 진단 데이터 수집 감사 파일의 대상 디렉터리를 설정합니다. 자세한 내용은 사용량 및 진단 데이터 수집의 로컬 감사를 참조하세요.

다음은 SQL Edge에 적용할 수 없는 mssql.conf 옵션입니다.

옵션	설명
고객 의견	SQL Server에서 피드백을 Microsoft에 보낼지 여부를 선택합니다.
데이터베이스 메일 프로필	SQL Server on Linux의 기본 데이터베이스 메일 프로필을 설정합니다.
고가용성	가용성 그룹을 사용하도록 설정합니다.
Microsoft Distributed Transaction Coordinator	Linux에서 MSDTC를 구성하고 문제를 해결합니다. 분산 트랜잭션과 관련된 추가 구성 옵션은 SQL Edge에서 지원되지 않습니다. 추가 구성 옵션에 대한 자세한 내용은 MSDTC 구성을 참조하세요.
ML Services EULA	Azure Machine Learning 패키지에 대한 R 및 Python EULA에 동의합니다. SQL Server 2019에만 적용됩니다.
outboundnetworkaccess	Machine Learning Services R, Python 및 Java 확장의 아웃바운드 네트워크 액세스를 사용하도록 설정합니다.

다음은 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 Marketplace를 통해 또는 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 파일에 액세스할 수 있게 하려면 컨테이너를 실행하는 데 사용하는 사용자/그룹에 영구적 파일 스토리지에 대한 읽기 및 쓰기 권한이 있는지 확인합니다. 다음 예에서는 10001의 user_id를 사용하여 루트가 아닌 사용자를 파일 소유자로 설정합니다.

chown -R 10001:0 <database file dir>

이전 CTP 릴리스에서 업그레이드

Azure SQL Edge의 이전 CTP는 루트 사용자로 실행되도록 구성되었습니다. 다음은 이전 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와 데이터베이스를 포함하여 컨테이너의 모든 항목이 삭제됩니다. 다음 섹션에서는 연결된 컨테이너가 삭제된 경우에도 데이터 볼륨을 사용하여 데이터베이스 파일을 유지하는 방법을 설명합니다.

Important

Azure SQL Edge의 경우 Docker의 데이터 지속성을 이해하는 것이 중요합니다. 이 섹션의 설명 외에도 Docker 컨테이너의 데이터를 관리하는 방법에 대한 Docker 설명서를 참조하세요.

호스트 디렉터리를 데이터 볼륨으로 탑재

첫 번째 옵션은 호스트의 디렉터리를 컨테이너에 데이터 볼륨으로 탑재하는 것입니다. 이렇게 하려면 docker run 명령에 -v <host directory>:/var/opt/mssql 플래그를 사용합니다. 그러면 컨테이너 실행 간에 데이터를 복원할 수 있습니다.

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

이 방법을 사용하여 Docker 외부에서 호스트의 파일을 공유하고 볼 수도 있습니다.

Important

Docker on Windows의 호스트 볼륨 매핑은 현재 전체 /var/opt/mssql 디렉터리 매핑을 지원하지 않습니다. 그러나 /var/opt/mssql/data 등의 하위 디렉터리를 호스트 머신에 매핑할 수 있습니다.

Important

Azure SQL Edge 이미지를 사용한 macOS의 Docker에 대한 호스트 볼륨 매핑은 현재 지원되지 않습니다. 대신, 데이터 볼륨 컨테이너를 사용합니다. 이 제한 사항은 /var/opt/mssql 디렉터리에만 적용됩니다. 탑재된 디렉터리에서 읽을 수는 있습니다. 예를 들어, macOS에서 -v를 사용하여 호스트 디렉터리를 탑재하고 호스트에 있는 .bak 파일에서 백업을 복원할 수 있습니다.

데이터 볼륨 컨테이너 사용

두 번째 옵션은 데이터 볼륨 컨테이너를 사용하는 것입니다. -v 매개 변수를 사용하여 호스트 디렉터리 대신 볼륨 이름을 지정하면 데이터 볼륨 컨테이너를 만들 수 있습니다. 다음 예제에서는 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

참고 항목

run 명령에서 암시적으로 데이터 볼륨을 만드는 이 방법은 이전 버전의 Docker에서 작동하지 않습니다. 이 경우에는 Docker 설명서인 데이터 볼륨 컨테이너 만들기 및 탑재에 간략하게 설명된 명시적 단계를 사용합니다.

이 컨테이너를 중지하고 제거해도 데이터 볼륨이 계속 유지됩니다. docker volume ls 명령을 사용하여 데이터 볼륨을 볼 수 있습니다.

docker volume ls

그런 다음, 동일한 볼륨 이름을 사용하여 다른 컨테이너를 만들면 새 컨테이너는 볼륨에 포함된 것과 동일한 Azure SQL Edge 데이터를 사용합니다.

데이터 볼륨 컨테이너를 제거하려면 docker volume rm 명령을 사용합니다.

Warning

데이터 볼륨 컨테이너를 삭제하면 컨테이너의 모든 Azure SQL Edge 데이터가 ‘영구적으로’ 삭제됩니다.

Azure SQL Edge 구성

환경 변수를 사용하여 구성

환경 변수 지정

mssql.conf 파일을 사용하여 구성

루트가 아닌 사용자로 Azure SQL Edge 실행

이전 CTP 릴리스에서 업그레이드

데이터 유지

호스트 디렉터리를 데이터 볼륨으로 탑재

데이터 볼륨 컨테이너 사용

다음 단계

추가 리소스

`mssql.conf` 파일을 사용하여 구성