Installare gli strumenti da riga di comando sqlcmd e bcp di SQL Server in Linux

Articolo
07/22/2024

Si applica a: SQL Server - Linux

I passaggi seguenti installano gli strumenti da riga di comando, i driver Microsoft ODBC e le relative dipendenze. Il pacchetto mssql-tools contiene:

sqlcmd: utilità di query dellpa riga di comando.
bcp: utilità di importazione/esportazione in blocco.

Installare gli strumenti per la piattaforma usata:

Questo articolo descrive come installare gli strumenti da riga di comando. Per esempi di come usare sqlcmd o bcp, vedere il Contenuto correlato alla fine di questo articolo.

Importante

sqlcmd e bcp sono disponibili in mssql-tools18 per le architetture x64 e arm64. Per un'alternativa moderna in Linux, macOS e Windows, vedere l'utilità go-sqlcmd.

Installare le utilità in Linux

Queste istruzioni sono relative all'installazione dei pacchetti Microsoft ODBC 18. Per le versioni precedenti, vedere Installare Microsoft ODBC Driver for SQL Server (Linux).

Seguire questa procedura per installare mssql-tools18 in Red Hat Enterprise Linux.

Scaricare il file di configurazione del repository Microsoft per Red Hat.

Per Red Hat 9, usare il comando seguente:

curl https://packages.microsoft.com/config/rhel/9/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo

Per Red Hat 8, usare il comando seguente:

curl https://packages.microsoft.com/config/rhel/8/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo

Per Red Hat 7, usare il comando seguente:

curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo

Se era già stata installata una versione precedente di mssql-tools, rimuovere tutti i pacchetti unixODBC meno recenti.
```
sudo yum remove mssql-tools unixODBC-utf16 unixODBC-utf16-devel
```
Esegui i comandi seguenti per installare mssql-tools18 con il pacchetto per sviluppatori unixODBC.
```
sudo yum install -y mssql-tools18 unixODBC-devel
```
Per effettuare l'aggiornamento alla versione più recente di mssql-tools, eseguire i comandi seguenti:
```
sudo yum check-update
sudo yum update mssql-tools18
```
Facoltativo: aggiungere /opt/mssql-tools18/bin/ alla PATH variabile di ambiente in una shell Bash.

Per rendere sqlcmd e bcp accessibili dalla shell Bash per le sessioni di accesso, modificare PATH nel ~/.bash_profile file con il comando seguente:
```
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bash_profile
source ~/.bash_profile
```
Per rendere sqlcmd e bcp accessibili dalla shell Bash per le sessioni interattive/non di accesso, modificare PATH nel file ~/.bashrc con il comando seguente:
```
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
```

Seguire questa procedura per installare mssql-tools18 in SUSE Linux Enterprise Server.

Importare la chiave di firma del pacchetto Microsoft.

curl -O https://packages.microsoft.com/keys/microsoft.asc
sudo rpm --import microsoft.asc

Aggiungere il repository SQL Server a Zypper.

Per SLES 15, usare il comando seguente:

sudo zypper ar https://packages.microsoft.com/config/sles/15/prod.repo

Per SLES 12, usare il comando seguente:

sudo zypper ar https://packages.microsoft.com/config/sles/12/prod.repo

Installare mssql-tools18 con il pacchetto per sviluppatori unixODBC.
- Per SLES 15, usare il comando seguente:
```
sudo zypper install -y mssql-tools18 unixODBC-devel glibc-locale-base
```
- Per SLES 12, usare il comando seguente:
```
sudo zypper install -y mssql-tools18 unixODBC-devel
```
Per effettuare l'aggiornamento all’ultima versione di mssql-tools18, eseguire i comandi seguenti:
```
sudo zypper refresh
sudo zypper update mssql-tools18
```
Facoltativo: aggiungere /opt/mssql-tools18/bin/ alla variabile di ambiente PATH in una shell Bash.

Per rendere sqlcmd e bcp accessibili dalla shell Bash per le sessioni di accesso, modificare PATH nel file ~/.bash_profile con il comando seguente:
```
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bash_profile
source ~/.bash_profile
```
Per rendere sqlcmd e bcp accessibili dalla shell Bash per le sessioni interattive/non di accesso, modificare PATH nel file ~/.bashrc con il comando seguente:
```
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
```

Seguire questa procedura per installare mssql-tools18 in Ubuntu.

Nota

Ubuntu 18.04 è supportato a partire da SQL Server 2019 (15.x) CU 3.
Ubuntu 20.04 è supportato a partire da SQL Server 2019 (15.x) CU 10.

Importare le chiavi GPG del repository pubblico.

curl https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc

Registrare il repository Microsoft per Ubuntu.

Per Ubuntu 22.04, usare il comando seguente:

curl https://packages.microsoft.com/config/ubuntu/22.04/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list

Per Ubuntu 20.04, usare il comando seguente:

curl https://packages.microsoft.com/config/ubuntu/20.04/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list

Per Ubuntu 18.04, usare il comando seguente:

curl https://packages.microsoft.com/config/ubuntu/18.04/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list

Per Ubuntu 16.04, usare il comando seguente:

curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list

Aggiornare l'elenco di origini ed eseguire il comando di installazione con il pacchetto per sviluppatori unixODBC.
```
sudo apt-get update
sudo apt-get install mssql-tools18 unixodbc-dev
```
Per effettuare l'aggiornamento alla versione più recente di mssql-tools, eseguire i comandi seguenti:
```
sudo apt-get update  
sudo apt-get install mssql-tools18
```
Facoltativo: aggiungere /opt/mssql-tools18/bin/ alla PATH variabile di ambiente in una shell Bash.

Per rendere sqlcmd e bcp accessibili dalla shell Bash per le sessioni di accesso, modificare PATH nel ~/.bash_profile file con il comando seguente:
```
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bash_profile
source ~/.bash_profile
```
Per rendere sqlcmd e bcp accessibili dalla shell Bash per le sessioni interattive/non di accesso, modificare PATH nel file ~/.bashrc con il comando seguente:
```
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
```

Installare le utilità in macOS

Installare Homebrew se non è già stato fatto:

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

Per installare gli strumenti per macOS El Capitan e versioni successive, usare i comandi seguenti:

# 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

Installare le utilità in Docker

Se si esegue SQL Server in un contenitore Docker, gli strumenti da riga di comando di SQL Server sono già inclusi nell'immagine del contenitore Linux di SQL Server. Se ci si connette a un contenitore in esecuzione con una shell bash interattiva, è possibile eseguire gli strumenti in locale.

Se si sta creando un contenitore con le utilità da riga di comando di SQL Server, è consigliabile aggiungere ACCEPT_EULA=Y al comando di installazione per accettare in modo invisibile il contratto di licenza e non interrompere la creazione di immagini. Un comando finale di esempio nell'ambito dell'installazione in un'immagine basata su Ubuntu è:

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

Installazione offline

Se il computer Linux non dispone di accesso per i repository online usati nelle sezioni precedenti, è possibile scaricare direttamente i file del pacchetto. Questi pacchetti si trovano nel repository di Microsoft, https://packages.microsoft.com.

Suggerimento

Se l'installazione è stata eseguita correttamente con i passaggi indicati nelle sezioni precedenti, non è necessario scaricare o installare manualmente i seguenti pacchetti. Questa operazione riguarda solo lo scenario offline.

Prima di tutto, individuare e copiare il pacchetto mssql-tools18 per la distribuzione di Linux: Per Red Hat 8.0, questo pacchetto si trova in https://packages.microsoft.com/rhel/8/prod.
Individuare e copiare anche il pacchetto msodbcsql18 che è una dipendenza. Il pacchetto msodbcsql18 ha anche una dipendenza da unixODBC-devel. Per Red Hat, il pacchetto msodbcsql18 si trova in https://packages.microsoft.com/rhel/8/prod.
Spostare i pacchetti scaricati nel computer Linux. Se è stato usato un computer diverso per scaricare i pacchetti, per spostarli nel computer Linux, è possibile usare il comando scp.
Installare le utilità e i pacchetti: installare i pacchetti mssql-tools18 e msodbc18. Se vengono visualizzati errori di dipendenza, ignorarli fino al passaggio successivo. Sostituire <version> con la versione corretta:
```
sudo yum localinstall msodbcsql18-<version>.rpm
sudo yum localinstall mssql-tools18-<version>.rpm
```
Risolvere le dipendenze mancanti: a questo punto potrebbero esserci dipendenze mancanti. In caso contrario, è possibile ignorare questo passaggio. In alcuni casi, è necessario individuare e installare le dipendenze manualmente.

È possibile esaminare le dipendenze necessarie con i comandi seguenti. Sostituire <version> con la versione corretta:
```
rpm -qpR msodbcsql18-<version>.rpm
rpm -qpR mssql-tools18-<version>.rpm
```

Prima di tutto, individuare e copiare il pacchetto mssql-tools18 per la distribuzione di Linux: Per SLES 15, questo pacchetto si trova in https://packages.microsoft.com/sles/15/prod.
Individuare e copiare anche il pacchetto msodbcsql18 che è una dipendenza. Il pacchetto msodbcsql18 ha anche una dipendenza da unixODBC-devel. Per SLES, il pacchetto msodbcsql18 si trova in https://packages.microsoft.com/sles/15/prod.
Spostare i pacchetti scaricati nel computer Linux. Se è stato usato un computer diverso per scaricare i pacchetti, per spostarli nel computer Linux, è possibile usare il comando scp.
Installare le utilità e i pacchetti: installare i pacchetti mssql-tools18 e msodbc18. Se vengono visualizzati errori di dipendenza, ignorarli fino al passaggio successivo. Sostituire <version> con la versione corretta:
```
sudo zypper install msodbcsql18-<version>.rpm
sudo zypper install mssql-tools18-<version>.rpm
```
Risolvere le dipendenze mancanti: a questo punto potrebbero esserci dipendenze mancanti. In caso contrario, è possibile ignorare questo passaggio. In alcuni casi, è necessario individuare e installare le dipendenze manualmente.

È possibile esaminare le dipendenze necessarie con i comandi seguenti. Sostituire <version> con la versione corretta:
```
rpm -qpR msodbcsql18-<version>.rpm
rpm -qpR mssql-tools18-<version>.rpm
```

Prima di tutto, individuare e copiare il pacchetto mssql-tools18 per la distribuzione di Linux: Per Ubuntu 20.04, questo pacchetto si trova in https://packages.microsoft.com/ubuntu/20.04/prod/pool/main/m/mssql-tools.
Individuare e copiare anche il pacchetto msodbcsql18 che è una dipendenza. Il pacchetto msodbcsql18 ha anche una dipendenza da unixodbc-dev. Per Ubuntu, i pacchetti msodbcsql18 si trovano in msodbcsql18 e unixodbc-dev.
Spostare i pacchetti scaricati nel computer Linux. Se è stato usato un computer diverso per scaricare i pacchetti, per spostarli nel computer Linux, è possibile usare il comando scp.
Installare le utilità e i pacchetti: installare i pacchetti mssql-tools18 e msodbc18. Se vengono visualizzati errori di dipendenza, ignorarli fino al passaggio successivo. Sostituire <version> con la versione corretta:
```
sudo dpkg -i msodbcsql18_<version>.deb
sudo dpkg -i mssql-tools18_<version>.deb
```
Risolvere le dipendenze mancanti: a questo punto potrebbero esserci dipendenze mancanti. In caso contrario, è possibile ignorare questo passaggio. In alcuni casi, è necessario individuare e installare le dipendenze manualmente.

Se si ha accesso a repository approvati contenenti tali dipendenze, la soluzione più semplice è usare il comando apt-get:
```
sudo apt-get -f install
```
Questo comando completa anche l'installazione dei pacchetti di SQL Server.

Se questa soluzione non funziona per il pacchetto Debian, è possibile esaminare le dipendenze necessarie con i comandi seguenti:
```
dpkg -I msodbcsql18_<version>_amd64.deb | grep "Depends:"
dpkg -I mssql-tools18_<version>_amd64.deb | grep "Depends:"
```

Contribuire alla documentazione di SQL

Il contenuto SQL può essere modificato. L'autore delle modifiche contribuirà a migliorare la documentazione e verrà accreditato come collaboratore alla realizzazione della pagina.

Per maggiori informazioni, vedere Come contribuire alla documentazione di SQL Server

Condividi tramite