Azure SQL Edge 연결 및 쿼리

Azure SQL Edge에서 컨테이너를 배포한 후에는 다음 위치 중 하나에서 SQL 데이터베이스 엔진에 연결할 수 있습니다.

• 컨테이너 내부에서
• 동일한 호스트에서 실행되는 다른 docker 컨테이너에서
• 호스트 머신에서
• 네트워크에 있는 다른 클라이언트 머신에서

Azure SQL Edge에 연결하기 위한 도구

다음과 같은 일반적인 도구 중 하나에서 Azure SQL Edge 인스턴스에 연결할 수 있습니다.

• sqlcmd: sqlcmd 클라이언트 도구는 Azure SQL Edge의 컨테이너 이미지에 이미 포함되어 있습니다. 대화형 bash 셸을 사용하여 실행 중인 컨테이너에 연결하는 경우 도구를 로컬로 실행할 수 있습니다. SQL 클라이언트 도구는 ARM64 플랫폼에서 사용할 수 “없습니다”.
• SQL Server Management Studio
• Azure Data Studio
• Visual Studio Code

네트워크 머신에서 Azure SQL Edge 데이터베이스 엔진에 연결하려면 다음이 필요합니다.

• 호스트 머신의 IP 주소 또는 네트워크 이름: Azure SQL Edge 컨테이너가 실행되는 호스트 머신입니다.

• Azure SQL Edge 컨테이너 호스트 포트 매핑: docker 컨테이너 포트를 호스트의 포트에 매핑하기 위한 포트입니다. 컨테이너 내에서 Azure SQL Edge는 항상 포트 1433에 매핑됩니다. 원할 경우 변경할 수 있습니다. 포트 번호를 변경하려면 Azure IoT Edge의 Azure SQL Edge 모듈에 대한 컨테이너 만들기 옵션을 업데이트합니다. 다음 예제에서는 컨테이너의 포트 1433은 호스트의 포트 1600에 매핑됩니다.

  {
      "PortBindings": {
        "1433/tcp": [
          {
            "HostPort": "1600"
          }
        ]
      }
  }
  

• Azure SQL Edge 인스턴스의 SA 암호: .Azure SQL Edge 배포 중에 MSSQL_SA_PASSWORD 환경 변수에 대해 지정된 값입니다.

컨테이너 내에서 데이터베이스 엔진에 연결

SQL Server 명령줄 도구가 Azure SQL Edge의 컨테이너 이미지에 포함되어 있습니다. 대화형 명령 프롬프트를 사용하여 컨테이너에 연결하는 경우 로컬에서 도구를 실행할 수 있습니다. SQL 클라이언트 도구는 ARM64 플랫폼에서 사용할 수 없습니다.

1. docker exec -it 명령을 사용하여 실행 중인 컨테이너 내에서 대화형 bash 셸을 시작합니다. 다음 예제에서 e69e056c702d는 컨테이너 ID입니다.

   docker exec -it e69e056c702d /bin/bash
   

   팁

   항상 전체 컨테이너 ID를 지정할 필요는 없습니다. 고유하게 식별하는 데 충분한 문자만 지정하면 됩니다. 따라서 이 예제에서는 전체 ID가 아닌 e6 또는 e69만 사용해도 충분할 수 있습니다.

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

   /opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P '<YourPassword>'
   

3. sqlcmd 사용이 끝나면 exit를 입력합니다.

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

동일한 호스트의 다른 컨테이너에서 Azure SQL Edge에 연결

동일한 호스트에서 실행되는 두 컨테이너는 동일한 docker 네트워크에 있으므로 서비스의 컨테이너 이름과 포트 주소를 사용하여 쉽게 액세스할 수 있습니다. 예를 들어 동일한 호스트의 다른 Python 모듈(컨테이너)에서 Azure SQL Edge의 인스턴스에 연결하는 경우 다음과 유사한 연결 문자열을 사용할 수 있습니다. (이 예제에서는 Azure SQL Edge가 기본 포트에서 수신하도록 구성되어 있다고 가정합니다.)

import pyodbc
server = 'MySQLEdgeContainer' # Replace this with the actual name of your SQL Edge Docker container
username = 'sa' # SQL Server username
password = '<password>' # Replace this with the actual SA password from your deployment
database = 'MyEdgeDatabase' # Replace this with the actual database name from your deployment. If you do not have a database created, you can use Master database.
db_connection_string = "Driver={ODBC Driver 17 for SQL Server};Server=" + server + ";Database=" + database + ";UID=" + username + ";PWD=" + password + ";"
conn = pyodbc.connect(db_connection_string, autocommit=True)

다른 네트워크 머신에서 Azure SQL Edge에 연결

네트워크의 다른 머신에서 Azure SQL Edge의 인스턴스에 연결할 수 있습니다. 이렇게 하려면 Docker 호스트의 IP 주소와 Azure SQL Edge 컨테이너가 매핑되는 호스트 포트를 사용합니다. 예를 들어 Docker 호스트의 IP 주소가 192.168.2.121이고 Azure SQL Edge 컨테이너가 호스트 포트 1600에 매핑되는 경우 Azure SQL Edge 인스턴스의 서버 주소는 192.168.2.121,1600이 됩니다. 업데이트된 Python 스크립트는 다음과 같습니다.

import pyodbc
server = '192.168.2.121,1600' # Replace this with the actual name or IP address of your SQL Edge Docker container
username = 'sa' # SQL Server username
password = '<password>' # Replace this with the actual SA password from your deployment
database = 'MyEdgeDatabase' # Replace this with the actual database name from your deployment. If you do not have a database created, you can use Master database.
db_connection_string = "Driver={ODBC Driver 17 for SQL Server};Server=" + server + ";Database=" + database + ";UID=" + username + ";PWD=" + password + ";"
conn = pyodbc.connect(db_connection_string, autocommit=True)

Windows 머신에서 실행되는 SQL Server Management Studio을 사용하여 Azure SQL Edge 인스턴스에 연결하려면 SQL Server Management Studio를 참조하세요.

Windows, macOS 또는 Linux 머신에서 Visual Studio Code를 사용하여 Azure SQL Edge 인스턴스에 연결하려면 Visual Studio Code를 참조하세요.

Windows, macOS 또는 Linux 머신에서 Azure Data Studio를 사용하여 Azure SQL Edge 인스턴스에 연결하려면 Azure Data Studio를 참조하세요.

관련 콘텐츠

• 연결 및 쿼리
• Linux에서 SQL Server 도구 설치