Linux에서 SQL Server 명령줄 도구 sqlcmd 및 bcp 설치

적용 대상:SQL Server - Linux

다음 단계에서는 명령줄 도구, Microsoft ODBC 드라이버 및 해당 종속성을 설치합니다. mssql-tools 패키지에는 다음이 포함됩니다.

  • sqlcmd: 명령줄 쿼리 유틸리티입니다.
  • bcp: 대량 가져오기-내보내기 유틸리티입니다.

플랫폼용 도구를 설치합니다.

이 문서에서는 명령줄 도구를 설치하는 방법을 설명합니다. sqlcmd 또는 bcp를 사용하는 방법에 대한 예제를 찾고 있는 경우 이 문서의 끝에 있는 관련 콘텐츠를 참조하세요.

Important

sqlcmdbcp는 mssql-tools18arm64 아키텍처에서 x64사용할 수 있습니다. Linux, macOS 및 Windows에서 최신 대안은 go-sqlcmd 유틸리티를 참조하세요.

Linux에 도구 설치

이러한 지침은 Microsoft ODBC 18 패키지를 설치하기 위한 것입니다. 이전 버전의 경우 SQL Server용 Microsoft ODBC 드라이버 설치(Linux)를 참조하세요.

다음 단계를 사용하여 Red Hat Enterprise Linux에 mssql-tools18 을 설치합니다.

  1. Microsoft Red Hat 리포지토리 구성 파일을 다운로드합니다.

    • Red Hat 9의 경우 다음 명령을 사용합니다.

      curl https://packages.microsoft.com/config/rhel/9/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo
      
    • Red Hat 8의 경우 다음 명령을 사용합니다.

      curl https://packages.microsoft.com/config/rhel/8/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo
      
    • Red Hat 7의 경우 다음 명령을 사용합니다.

      curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo
      
  2. 이전 버전의 mssql-tools가 설치되어 있는 경우 이전 unixODBC 패키지를 제거합니다.

    sudo yum remove mssql-tools unixODBC-utf16 unixODBC-utf16-devel
    
  3. 다음 명령을 실행하여 unixODBC 개발자 패키지와 함께 mssql-tools18을 설치합니다.

    sudo yum install -y mssql-tools18 unixODBC-devel
    

    참고 항목

    최신 버전의 mssql-tools로 업데이트하려면 다음 명령을 실행합니다.

    sudo yum check-update
    sudo yum update mssql-tools18
    
  4. 선택 사항: bash 셸에서 환경 변수에 추가 /opt/mssql-tools18/bin/ 합니다 PATH .

    로그인 세션에 대한 bash 셸에서 sqlcmd 및 bcp에 액세스할 수 있도록 하려면 다음 명령을 사용하여 파일에서 ~/.bash_profile 수정합니다PATH.

    echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bash_profile
    

    대화형/비 로그인 세션을 위해 bash 셸에서 sqlcmd 및 bcp에 액세스할 수 있도록 하려면 다음 명령을 사용하여 파일에서 ~/.bashrc 수정 PATH 합니다.

    echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
    source ~/.bashrc
    

macOS에 도구 설치

Homebrew가 아직 없는 경우 다음을 설치합니다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

macOS El Capitan 이상 버전용 도구를 설치하려면 다음 명령을 사용합니다.

# brew untap microsoft/mssql-preview if you installed the preview version
brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
brew install mssql-tools18

Docker에 도구 설치

Docker 컨테이너에서 SQL Server를 실행하는 경우 SQL Server 명령줄 도구가 SQL Server Linux 컨테이너 이미지에 이미 포함되어 있어야 합니다. 대화형 bash 셸을 사용하여 실행 중인 컨테이너에 연결하는 경우 도구를 로컬로 실행할 수 있습니다.

SQL Server 명령줄 도구를 사용하여 컨테이너를 만드는 경우 설치 명령에 추가하여 ACCEPT_EULA=Y EULA를 자동으로 수락하고 이미지 생성을 중단하지 않아야 합니다. Ubuntu 기반 이미지에서 설치의 일부로 최종 명령 예제는 다음과 같습니다.

sudo ACCEPT_EULA=Y apt-get install mssql-tools18 unixodbc-dev

오프라인 설치

Linux 컴퓨터에서 이전 섹션에서 사용된 온라인 리포지토리에 액세스할 수 없는 경우 패키지 파일을 직접 다운로드할 수 있습니다. 이 패키지는 Microsoft 리포지토리 https://packages.microsoft.com에 있습니다.

이전 섹션의 단계로 설치에 성공한 경우 다음 패키지를 다운로드하거나 수동으로 설치할 필요가 없습니다. 오프라인 시나리오에만 해당됩니다.

  1. 먼저 Linux 배포에 대한 mssql-tools18 패키지를 찾아 복사합니다. Red Hat 8.0의 경우 .https://packages.microsoft.com/rhel/8/prod

  2. 또한 종속성인 msodbcsql18 패키지를 찾아 복사합니다. msodbcsql18 패키지에는 unixODBC-devel에 대한 종속성도 있습니다. Red Hat의 경우 msodbcsql18 패키지는 .https://packages.microsoft.com/rhel/8/prod

  3. 다운로드한 패키지를 Linux 머신으로 이동합니다. 다른 머신을 사용하여 패키지를 다운로드한 경우 패키지를 Linux 머신으로 이동하는 한 가지 방법은 scp 명령을 사용하는 것입니다.

  4. 패키지 설치: mssql-tools18msodbc18 패키지를 설치합니다. 종속성 오류가 발생하면 다음 단계까지 오류를 무시합니다. 올바른 버전으로 바꿉다 <version> .

    sudo yum localinstall msodbcsql18-<version>.rpm
    sudo yum localinstall mssql-tools18-<version>.rpm
    
  5. 누락된 종속성을 해결합니다. 이때 누락된 종속성이 있을 수 있습니다. 누락된 종속성이 없으면 이 단계를 건너뛰어도 됩니다. 경우에 따라 이 종속성을 수동으로 찾고 설치해야 합니다.

    다음 명령을 사용하여 필요한 종속성을 검사할 수 있습니다. 올바른 버전으로 바꿉다 <version> .

    rpm -qpR msodbcsql18-<version>.rpm
    rpm -qpR mssql-tools18-<version>.rpm
    

sqlcmd를 사용하여 SQL Server에 연결하고 데이터베이스 만드는 방법에 대한 예제는 다음 빠른 시작 중 하나를 참조하세요.

bcp를 사용하여 데이터를 대량으로 가져오고 내보내는 방법에 대한 예제는 SQL Server on Linux로 데이터 대량 복사를 참조하세요.

SQL 설명서에 참여하세요

SQL 콘텐츠를 직접 편집할 수 있다는 것을 알고 계셨나요? 직접 편집하면 설명서가 개선될 뿐만 아니라 페이지에 참여자로 기입됩니다.

자세한 내용은 SQL Server 설명서에 기여하는 방법을 참조하세요.