Linux에서 SQL Server 명령줄 도구 sqlcmd 및 bcp 설치Install sqlcmd and bcp the SQL Server command-line tools on Linux

적용 대상:Applies to: 예SQL ServerSQL Server(지원되는 모든 버전)yesSQL ServerSQL Server (all supported versions) - Linux적용 대상:Applies to: 예SQL ServerSQL Server(지원되는 모든 버전)yesSQL ServerSQL Server (all supported versions) - Linux

다음 단계에서는 명령줄 도구, Microsoft ODBC 드라이버 및 해당 종속성을 설치합니다.The following steps install the command-line tools, Microsoft ODBC drivers, and their dependencies. mssql-tools 패키지에는 다음이 포함됩니다.The mssql-tools package contains:

  • sqlcmd: 명령줄 쿼리 유틸리티입니다.sqlcmd: Command-line query utility.
  • bcp: 대량 가져오기-내보내기 유틸리티입니다.bcp: Bulk import-export utility.

플랫폼용 도구를 설치합니다.Install the tools for your platform:

이 문서에서는 명령줄 도구를 설치하는 방법을 설명합니다.This article describes how to install the command-line tools. sqlcmd 또는 bcp를 사용하는 방법에 대한 예제를 검색하는 경우 이 항목의 끝부분에 있는 링크를 참조하세요.If you are looking for examples of how to use sqlcmd or bcp, see the links at the end of this topic.

RHEL 8에 도구 설치Install tools on RHEL 8

다음 단계를 사용하여 Red Hat Enterprise Linux에서 mssql-tools를 설치합니다.Use the following steps to install the mssql-tools on Red Hat Enterprise Linux.

  1. 슈퍼 사용자 모드로 전환합니다.Enter superuser mode.

    sudo su
    
  2. Microsoft Red Hat 리포지토리 구성 파일을 다운로드합니다.Download the Microsoft Red Hat repository configuration file.

    curl https://packages.microsoft.com/config/rhel/8/prod.repo > /etc/yum.repos.d/msprod.repo
    
  3. 슈퍼 사용자 모드를 종료합니다.Exit superuser mode.

    exit
    
  4. 이전 버전의 mssql-tools가 설치되어 있는 경우 이전 unixODBC 패키지를 제거합니다.If you had a previous version of mssql-tools installed, remove any older unixODBC packages.

    sudo yum remove mssql-tools unixODBC-utf16-devel
    
  5. 다음 명령을 실행하여 unixODBC 개발자 패키지와 함께 mssql-tools를 설치합니다.Run the following commands to install mssql-tools with the unixODBC developer package.

    sudo yum install mssql-tools unixODBC-devel
    

    참고

    최신 버전의 mssql-tools로 업데이트하려면 다음 명령을 실행합니다.To update to the latest version of mssql-tools run the following commands:

    sudo yum check-update
    sudo yum update mssql-tools
    
  6. 선택 사항: Bash 셸에서 PATH 환경 변수에 /opt/mssql-tools/bin/를 추가합니다.Optional: Add /opt/mssql-tools/bin/ to your PATH environment variable in a bash shell.

    로그인 세션을 위해 bash 셸에서 sqlcmd/bcp에 액세스할 수 있도록 설정하려면 다음 명령을 사용하여 ~/.bash_profile 파일에서 PATH를 수정합니다.To make sqlcmd/bcp accessible from the bash shell for login sessions, modify your PATH in the ~/.bash_profile file with the following command:

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

    대화형/비로그인 세션을 위해 bash 셸에서 sqlcmd/bcp에 액세스할 수 있도록 설정하려면 다음 명령을 사용하여 ~/.bashrc 파일에서 PATH를 수정합니다.To make sqlcmd/bcp accessible from the bash shell for interactive/non-login sessions, modify the PATH in the ~/.bashrc file with the following command:

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

Ubuntu 16.04에 도구 설치Install tools on Ubuntu 16.04

다음 단계에 따라 Ubuntu에 mssql-tools를 설치합니다.Use the following steps to install the mssql-tools on Ubuntu.

참고

SQL Server 2019 CU3부터 Ubuntu 18.04가 지원됩니다.Ubuntu 18.04 is supported starting with SQL Server 2019 CU3. Ubuntu 18.04를 사용하는 경우 리포지토리 경로를 /ubuntu/16.04에서 /ubuntu/18.04로 변경합니다.If you are using Ubuntu 18.04, change the repository path from /ubuntu/16.04 to /ubuntu/18.04.

  1. 공용 리포지토리 GPG 키를 가져옵니다.Import the public repository GPG keys.

    curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
    
  2. Microsoft Ubuntu 리포지토리를 등록합니다.Register the Microsoft Ubuntu repository.

    curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list | sudo tee /etc/apt/sources.list.d/msprod.list
    
  3. 원본 목록을 업데이트하고 unixODBC 개발자 패키지를 사용하여 설치 명령을 실행합니다.Update the sources list and run the installation command with the unixODBC developer package.

    sudo apt-get update 
    sudo apt-get install mssql-tools unixodbc-dev
    

    참고

    최신 버전의 mssql-tools로 업데이트하려면 다음 명령을 실행합니다.To update to the latest version of mssql-tools run the following commands:

    sudo apt-get update 
    sudo apt-get install mssql-tools 
    
  4. 선택 사항: Bash 셸에서 PATH 환경 변수에 /opt/mssql-tools/bin/를 추가합니다.Optional: Add /opt/mssql-tools/bin/ to your PATH environment variable in a bash shell.

    로그인 세션을 위해 bash 셸에서 sqlcmd/bcp에 액세스할 수 있도록 설정하려면 다음 명령을 사용하여 ~/.bash_profile 파일에서 PATH를 수정합니다.To make sqlcmd/bcp accessible from the bash shell for login sessions, modify your PATH in the ~/.bash_profile file with the following command:

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

    대화형/비로그인 세션을 위해 bash 셸에서 sqlcmd/bcp에 액세스할 수 있도록 설정하려면 다음 명령을 사용하여 ~/.bashrc 파일에서 PATH를 수정합니다.To make sqlcmd/bcp accessible from the bash shell for interactive/non-login sessions, modify the PATH in the ~/.bashrc file with the following command:

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

SLES 12에 도구 설치Install tools on SLES 12

다음 단계를 사용하여 SUSE Linux Enterprise Server에서 mssql-tools를 설치합니다.Use the following steps to install the mssql-tools on SUSE Linux Enterprise Server.

  1. Zypper에 Microsoft SQL Server 리포지토리를 추가합니다.Add the Microsoft SQL Server repository to Zypper.

    sudo zypper addrepo -fc https://packages.microsoft.com/config/sles/12/prod.repo 
    sudo zypper --gpg-auto-import-keys refresh
    
  2. unixODBC 개발자 패키지와 함께 mssql-tools를 설치합니다.Install mssql-tools with the unixODBC developer package.

    sudo zypper install mssql-tools unixODBC-devel
    

    참고

    최신 버전의 mssql-tools로 업데이트하려면 다음 명령을 실행합니다.To update to the latest version of mssql-tools run the following commands:

    sudo zypper refresh
    sudo zypper update mssql-tools
    
  3. 선택 사항: Bash 셸에서 PATH 환경 변수에 /opt/mssql-tools/bin/를 추가합니다.Optional: Add /opt/mssql-tools/bin/ to your PATH environment variable in a bash shell.

    로그인 세션을 위해 bash 셸에서 sqlcmd/bcp에 액세스할 수 있도록 설정하려면 다음 명령을 사용하여 ~/.bash_profile 파일에서 PATH를 수정합니다.To make sqlcmd/bcp accessible from the bash shell for login sessions, modify your PATH in the ~/.bash_profile file with the following command:

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

    대화형/비로그인 세션을 위해 bash 셸에서 sqlcmd/bcp에 액세스할 수 있도록 설정하려면 다음 명령을 사용하여 ~/.bashrc 파일에서 PATH를 수정합니다.To make sqlcmd/bcp accessible from the bash shell for interactive/non-login sessions, modify the PATH in the ~/.bashrc file with the following command:

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

macOS에 도구 설치Install tools on macOS

이제 macOS에서 sqlcmdbcp 미리 보기를 사용할 수 있습니다.A preview of sqlcmd and bcp is now available on macOS. 자세한 내용은 공지를 참조하세요.For more information, see the announcement.

‘아직 설치하지 않은 경우 Homebrew를 설치합니다.’Install Homebrew if you don't have it already:

  • /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Mac El Capitan 및 Sierra용 도구를 설치하려면 다음 명령을 사용합니다.To install the tools for Mac El Capitan and Sierra, use the following commands:

# 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-tools
#for silent install: 
#HOMEBREW_NO_ENV_FILTERING=1 ACCEPT_EULA=y brew install mssql-tools

DockerDocker

Docker 컨테이너에서 SQL Server를 실행하는 경우 SQL Server 명령줄 도구가 SQL Server Linux 컨테이너 이미지에 이미 포함되어 있어야 합니다.If you run SQL Server in a Docker container, the SQL Server command-line tools are already included in the SQL Server Linux container image. 대화형 bash 셸을 사용하여 실행 중인 컨테이너에 연결하는 경우 도구를 로컬로 실행할 수 있습니다.If you attach to a running container with an interactive bash shell, you can run the tools locally.

오프라인 설치Offline installation

Linux 컴퓨터에서 이전 섹션에서 사용된 온라인 리포지토리에 액세스할 수 없는 경우 패키지 파일을 직접 다운로드할 수 있습니다.If your Linux machine does not have access to the online repositories used in the previous sections, you can download the package files directly. 이 패키지는 Microsoft 리포지토리 https://packages.microsoft.com에 있습니다.These packages are located in the Microsoft repository, https://packages.microsoft.com.

이전 섹션의 단계로 설치에 성공한 경우 아래 패키지를 다운로드하거나 수동으로 설치할 필요가 없습니다.If you successfully installed with the steps in the previous sections, you do not need to download or manually install the package(s) below. 오프라인 시나리오에만 해당됩니다.This is only for the offline scenario.

  1. 먼저 Linux 배포용 mssql-tools 패키지를 찾아서 복사합니다.First, locate and copy the mssql-tools package for your Linux distribution:

    Linux 배포Linux distribution mssql-tools 패키지 위치mssql-tools package location
    Red HatRed Hat https://packages.microsoft.com/rhel/7.3/prod
    SLESSLES https://packages.microsoft.com/sles/12/prod
    Ubuntu 16.04Ubuntu 16.04 https://packages.microsoft.com/ubuntu/16.04/prod/pool/main/m/mssql-tools
  2. 또한 종속성인 msodbcsql 패키지를 찾아서 복사합니다.Also locate and copy the msodbcsql package, which is a dependency. msodbcsql 패키지에는 unixODBC-devel(Red Hat 및 SLES) 또는 unixodbc-dev(Ubuntu)에 대한 종속성도 포함됩니다.The msodbcsql package also has a dependency on either unixODBC-devel (Red Hat and SLES) or unixodbc-dev (Ubuntu). msodbcsql 패키지 위치는 다음 표에 나와 있습니다.The location of the msodbcsql packages are listed in the following table:

    Linux 배포Linux distribution ODBC 패키지 위치ODBC packages location
    Red HatRed Hat https://packages.microsoft.com/rhel/8/prod
    SLESSLES https://packages.microsoft.com/sles/12/prod
    Ubuntu 16.04Ubuntu 16.04 msodbcsqlmsodbcsql
    unixodbc-devunixodbc-dev
  3. 다운로드한 패키지를 Linux 머신으로 이동합니다.Move the downloaded packages to your Linux machine. 다른 머신을 사용하여 패키지를 다운로드한 경우 패키지를 Linux 머신으로 이동하는 한 가지 방법은 scp 명령을 사용하는 것입니다.If you used a different machine to download the packages, one way to move the packages to your Linux machine is with the scp command.

  4. 패키지 설치: mssql-toolsmsodbc 패키지를 설치합니다.Install the and packages: Install the mssql-tools and msodbc packages. 종속성 오류가 발생하면 다음 단계까지 오류를 무시합니다.If you get any dependency errors, ignore them until the next step.

    플랫폼Platform 패키지 설치 명령Package install commands
    Red HatRed Hat sudo yum localinstall msodbcsql-<version>.rpm
    sudo yum localinstall mssql-tools-<version>.rpm
    SLESSLES sudo zypper install msodbcsql-<version>.rpm
    sudo zypper install mssql-tools-<version>.rpm
    UbuntuUbuntu sudo dpkg -i msodbcsql_<version>.deb
    sudo dpkg -i mssql-tools_<version>.deb
  5. 누락된 종속성을 해결합니다. 이때 누락된 종속성이 있을 수 있습니다.Resolve missing dependencies: You might have missing dependencies at this point. 누락된 종속성이 없으면 이 단계를 건너뛰어도 됩니다.If not, you can skip this step. 경우에 따라 이 종속성을 수동으로 찾고 설치해야 합니다.In some cases, you must manually locate and install these dependencies.

    RPM 패키지의 경우 다음 명령을 사용하여 필요한 종속성을 검사할 수 있습니다.For RPM packages, you can inspect the required dependencies with the following commands:

    rpm -qpR msodbcsql-<version>.rpm
    rpm -qpR mssql-tools-<version>.rpm
    

    Debian 패키지의 경우 해당 종속성을 포함하는 승인된 리포지토리에 액세스할 수 있는 경우 apt-get 명령을 사용하는 것이 가장 쉬운 해결 방법입니다.For Debian packages, if you have access to approved repositories containing those dependencies, the easiest solution is to use the apt-get command:

    sudo apt-get -f install
    

    참고

    이 명령은 SQL Server 패키지의 설치도 완료합니다.This command completes the installation of the SQL Server packages as well.

    Debian 패키지에 대해 이 명령이 작동하지 않으면 다음 명령을 사용하여 필요한 종속성을 검사할 수 있습니다.If this does not work for your Debian package, you can inspect the required dependencies with the following commands:

    dpkg -I msodbcsql_<version>_amd64.deb | grep "Depends:"
    dpkg -I mssql-tools_<version>_amd64.deb | grep "Depends:"
    

다음 단계Next steps

sqlcmd를 사용하여 SQL Server에 연결하고 데이터베이스 만드는 방법에 대한 예제는 다음 빠른 시작 중 하나를 참조하세요.For an example of how to use sqlcmd to connect to SQL Server and create a database, see one of the following quickstarts:

bcp를 사용하여 데이터를 대량으로 가져오고 내보내는 방법에 대한 예제는 SQL Server on Linux로 데이터 대량 복사를 참조하세요.For an example of how to use bcp to bulk import and export data, see Bulk copy data to SQL Server on Linux.