다음을 통해 공유


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

적용 대상: SQL Server - Linux

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

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

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

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

Important

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

Linux에 도구 설치

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

다음 단계를 사용하여 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 셸에서 PATH 환경 변수에 /opt/mssql-tools18/bin/를 추가합니다.

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

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

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

    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
    

SQL 설명서 작성에 참여하세요.

SQL 콘텐츠를 직접 편집할 수 있다는 것을 알고 계셨나요? 직접 편집하여 설명서를 개선하고, 페이지에 기여자로 참여하세요.

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