Docker를 사용하여 Azure SQL Edge 배포

Important

Azure SQL Edge는 2025년 9월 30일에 사용 중지됩니다. 자세한 내용 및 마이그레이션 옵션은 사용 중지 알림을 참조하세요.

참고 항목

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

이 빠른 시작에서는 Docker를 사용하여 Azure SQL Edge 컨테이너 이미지를 끌어와 실행합니다. 그런 다음, sqlcmd로 연결하여 첫 번째 데이터베이스를 만들고 쿼리를 실행합니다.

이 이미지는 Ubuntu 18.04 기반의 SQL Edge로 구성됩니다. Linux에서는 Docker Engine 1.8 이상에서 사용할 수 있습니다.

Azure SQL Edge 컨테이너는 프로덕션 워크로드에 대해 다음 플랫폼에서 지원되지 않습니다.

• Windows
• macOS
• Windows의 Linux용 Azure IoT Edge(EFLOW)

필수 조건

• 지원되는 모든 Linux 배포판에서 Docker Engine 1.8 이상 실행 자세한 내용은 사용자 Docker 설치를 참조하세요. SQL Edge 이미지는 Ubuntu 18.04를 기반으로 하므로 Ubuntu 18.04 Docker 호스트를 사용하는 것이 좋습니다.
• Docker overlay2 스토리지 드라이버. 대부분의 사용자에게 적용되는 기본값입니다. 이 스토리지 공급자를 사용하지 않고 변경해야 하는 경우 overlay2 구성에 대한 Docker 설명서의 지침 및 경고를 참조하세요.
• 최소 10GB의 디스크 공간.
• 최소 1GB의 RAM.
• Azure SQL Edge의 하드웨어 요구 사항

참고 항목

이 문서에서는 bash 명령으로 sudo를 사용합니다. sudo을 사용하여 Docker를 실행하지 않으려는 경우 Docker 그룹을 구성하고 해당 그룹에 사용자를 추가할 수 있습니다. 자세한 내용은 Linux용 설치 후 단계를 참조하세요.

컨테이너 이미지 풀하기 및 실행

1. Microsoft Container Registry에서 Azure SQL Edge 컨테이너 이미지를 끌어옵니다.

   sudo docker pull mcr.microsoft.com/azure-sql-edge:latest
   

   이전 명령은 최신 SQL Edge 컨테이너 이미지를 끌어옵니다. 사용 가능한 모든 이미지를 보려면 azure-sql-edge Docker 허브 페이지를 참조하세요.

2. Docker를 사용하여 컨테이너 이미지를 실행하려면 bash 셸에서 다음 명령을 사용합니다.

   • Developer Edition으로 실행되는 Azure SQL Edge 인스턴스를 시작합니다.

     sudo docker run --cap-add SYS_PTRACE -e 'ACCEPT_EULA=1' -e 'MSSQL_SA_PASSWORD=<password>' -p 1433:1433 --name azuresqledge -d mcr.microsoft.com/azure-sql-edge
     

   • Premium Edition으로 실행되는 Azure SQL Edge 인스턴스를 시작합니다.

     sudo docker run --cap-add SYS_PTRACE -e 'ACCEPT_EULA=1' -e 'MSSQL_SA_PASSWORD=<password>' -e 'MSSQL_PID=Premium' -p 1433:1433 --name azuresqledge -d mcr.microsoft.com/azure-sql-edge
     

   Important

   암호는 Microsoft SQL Database Engine 기본 암호 정책을 따라야 합니다. 그렇지 않으면 컨테이너가 SQL Database Engine을 설정할 수 없어 작동이 중지됩니다. 기본적으로 암호는 8자 이상이어야 하며 대문자, 소문자, 십진수 숫자 및 기호 네 가지 집합 중 세 집합의 문자를 포함해야 합니다. docker 로그 명령을 실행하여 오류 로그를 검사할 수 있습니다.

   다음 표에서는 이전 docker run 예제의 매개 변수에 대해 설명합니다.

   매개 변수	설명
   -e "ACCEPT_EULA=Y"	최종 사용자 사용권 계약 수락을 확인하기 위해 ACCEPT_EULA 변수를 어떤 값에 설정합니다. SQL Edge 이미지에 대한 필수 설정입니다.
   -e "MSSQL_SA_PASSWORD=<password>"	최소 8자 이상의 강력한 암호를 지정하고 암호 요구 사항을 충족 합니다. SQL Edge 이미지에 대한 필수 설정입니다.
   -p 1433:1433	호스트 환경의 TCP 포트(첫 번째 값)를 컨테이너의 TCP 포트(두 번째 값)로 매핑합니다. 이 예제에서 SQL Edge는 컨테이너의 TCP 1433에서 수신 대기하고 호스트의 1433 포트에 공개됩니다.
   --name azuresqledge	컨테이너에 대해 임의로 생성된 이름보다는 사용자 지정 이름을 지정합니다. 둘 이상의 컨테이너를 실행하는 경우 이 동일한 이름을 다시 사용할 수 없습니다.
   -d	백그라운드(디먼)에서 컨테이너를 실행합니다.

   모든 Azure SQL Edge 환경 변수의 전체 목록은 환경 변수를 사용하여 Azure SQL Edge 구성을 참조하세요. mssql.conf 파일을 사용하여 SQL Edge 컨테이너를 구성할 수도 있습니다.

3. Docker 컨테이너를 보려면 docker ps 명령을 사용합니다.

   sudo docker ps -a
   

4. 상태 열이 Up이면 SQL Edge는 컨테이너에서 실행되고 PORTS 열에 지정된 포트에서 수신 대기합니다. SQL Edge 컨테이너의 상태 열이 Exited이면 Azure SQL Edge 설명서의 문제 해결 섹션을 참조하세요.

   -h(호스트 이름) 매개 변수도 유용하지만 간단한 설명을 위해 이 자습서에서 사용되지 않습니다. 이렇게 하면 컨테이너의 내부 이름이 사용자 지정 값으로 변경됩니다. 이는 다음 Transact-SQL 쿼리에서 반환되는 이름입니다.

   SELECT @@SERVERNAME,
       SERVERPROPERTY('ComputerNamePhysicalNetBIOS'),
       SERVERPROPERTY('MachineName'),
       SERVERPROPERTY('ServerName');
   

   -h 및 --name을 같은 값에 설정하는 것은 대상 컨테이너를 쉽게 식별하는 데 유용한 좋은 방법입니다.

5. 마지막 단계로 SA 암호를 변경합니다. MSSQL_SA_PASSWORD는 ps -eax 출력에 표시되고 동일한 이름의 환경 변수에 저장되기 때문입니다. 다음 단계를 참조하세요.

SA 암호 변경

SA 계정은 설치 중에 생성되는 Azure SQL Edge 인스턴스의 시스템 관리자입니다. SQL Edge 컨테이너를 만든 후 컨테이너에서 echo $MSSQL_SA_PASSWORD를 실행하여 지정한 MSSQL_SA_PASSWORD 환경 변수를 검색할 수 있습니다. 보안을 위해 SA 암호를 변경합니다.

1. SA 사용자에게 사용할 강력한 암호를 선택합니다.

2. docker exec를 사용하여 sqlcmd를 실행하고 Transact-SQL을 사용하여 암호를 변경합니다. 다음 예제에서는 이전 암호 <old-password>와 새 암호 <new-password>를 사용자 고유의 암호 값으로 바꿉니다.

   sudo docker exec -it azuresqledge /opt/mssql-tools/bin/sqlcmd \
      -S localhost -U SA -P "<old-password>" \
      -Q 'ALTER LOGIN SA WITH PASSWORD="<new-password>"'
   

Azure SQL Edge에 연결

다음 단계에서는 SQL Edge에 연결하기 위해 컨테이너 내에서 Azure SQL Edge 명령줄 도구 sqlcmd를 사용합니다.

1. docker exec -it 명령을 사용하여 실행 중인 컨테이너 내에서 대화형 bash 셸을 시작합니다. 다음 예에서 azuresqledge는 컨테이너를 만들 때 --name 매개 변수가 지정한 이름입니다.

   sudo docker exec -it azuresqledge "bash"
   

2. 컨테이너 내부로 들어가면 sqlcmd를 사용하여 로컬로 연결합니다. sqlcmd는 기본적으로 경로에 있지 않으므로 전체 경로를 지정해야 합니다.

   /opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P "<password>"
   

   팁

   명령줄에서 암호를 생략하여 입력하라는 메시지가 표시되도록 할 수 있습니다.

3. 성공하면 sqlcmd 명령 프롬프트 1>이 표시됩니다.

데이터 만들기 및 쿼리

다음 섹션에서는 sqlcmd 및 Transact-SQL을 사용하여 새 데이터베이스를 만들고, 데이터를 추가하고, 쿼리를 실행하는 단계를 안내합니다.

새 데이터베이스 만들기

다음 단계에서는 TestDB라는 새 데이터베이스를 만듭니다.

1. sqlcmd 명령 프롬프트에서 다음 Transact-SQL 명령을 붙여넣어 테스트 데이터베이스를 만듭니다.

   CREATE DATABASE TestDB;
   GO
   

2. 다음 줄에 서버에 있는 모든 데이터베이스의 이름을 반환하는 쿼리를 작성합니다.

   SELECT name from sys.databases;
   GO
   

데이터 삽입

다음으로 새 테이블 Inventory를 만들고 두 개의 새 행을 삽입합니다.

1. sqlcmd 명령 프롬프트에서 컨텍스트를 새 TestDB 데이터베이스로 전환합니다.

   USE TestDB;
   

2. Inventory라는 새 테이블을 만듭니다.

   CREATE TABLE Inventory (
       id INT,
       name NVARCHAR(50),
       quantity INT
   );
   

3. 새 테이블에 데이터를 삽입합니다.

   INSERT INTO Inventory
   VALUES (1, 'banana', 150);
   
   INSERT INTO Inventory
   VALUES (2, 'orange', 154);
   

4. GO를 입력하여 앞의 명령을 실행합니다.

   GO
   

데이터 선택

이제 쿼리를 실행하여 Inventory 테이블에서 데이터를 반환합니다.

1. sqlcmd 명령 프롬프트에서 Inventory 테이블에서 수량이 152보다 큰 행을 반환하는 쿼리를 입력합니다.

   SELECT * FROM Inventory WHERE quantity > 152;
   

2. 다음 명령을 실행합니다.

   GO
   

sqlcmd 명령 프롬프트 종료

1. sqlcmd 세션을 종료하려면 QUIT를 입력합니다.

   QUIT
   

2. 컨테이너에서 대화형 명령 프롬프트를 종료하려면 exit을 입력합니다. 컨테이너는 대화형 bash 셸을 종료한 후에도 계속 실행됩니다.

컨테이너 외부에서 연결

SQL 연결을 지원하는 모든 외부 Linux, Windows 또는 macOS 도구에서 Docker 머신에 있는 SQL Edge 인스턴스에 연결할 수 있습니다. 외부에서 SQL Edge 컨테이너에 연결하는 방법에 대한 자세한 내용은 Azure SQL Edge 연결 및 쿼리를 참조하세요.

컨테이너 제거

이 자습서에 사용되는 SQL Edge 컨테이너를 제거하려면 다음 명령을 실행합니다.

sudo docker stop azuresqledge
sudo docker rm azuresqledge

Warning

컨테이너를 영구적으로 중지하고 제거하면 컨테이너의 모든 SQL Edge 데이터가 삭제됩니다. 데이터를 보존해야 하는 경우 컨테이너에서 백업 파일을 만들고 복사하거나 컨테이너 데이터 지속성 기술을 사용합니다.

관련 콘텐츠

• SQL Edge에 ONNX를 사용하는 Machine Learning 및 AI
• IoT Edge를 사용하여 SQL Edge로 엔드투엔드 IoT 솔루션 빌드.
• Azure SQL Edge에서 데이터 스트리밍