Konfigurowanie i dostosowywanie kontenerów systemu Linux programu SQL Server

Dotyczy:programu SQL Server — Linux

W tym artykule wyjaśniono, jak skonfigurować i dostosować kontenery programu SQL Server z systemem Linux przy użyciu platformy Docker. Możesz utrwalać dane, przenosić pliki z i do kontenerów oraz zmieniać ustawienia domyślne.

Napiwek

Możesz użyć sqlcmd (Go), aby utworzyć nowe wystąpienie programu SQL Server w kontenerze na potrzeby programowania. Aby uzyskać więcej informacji, zobacz Utwórz i zapytaj kontener SQL Server.

Tworzenie dostosowanego kontenera

Możesz utworzyć własny dockerfile w celu utworzenia dostosowanego kontenera programu SQL Server. Aby uzyskać więcej informacji, zobacz pokaz, który łączy program SQL Server i aplikację Node. Jeśli tworzysz własny plik Dockerfile, pamiętaj o procesie uruchamianym na pierwszym planie, ponieważ ten proces kontroluje czas życia kontenera. Jeśli wyjdzie, kontener zostanie zamknięty. Jeśli na przykład chcesz uruchomić skrypt i uruchomić program SQL Server, upewnij się, że proces programu SQL Server jest najbardziej odpowiednim poleceniem. Wszystkie inne polecenia są uruchamiane w tle. Następujące polecenie ilustruje to wewnątrz pliku Dockerfile:

/usr/src/app/do-my-sql-commands.sh & /opt/mssql/bin/sqlservr

Jeśli polecenia zostały odwrócone w poprzednim przykładzie, kontener zostanie zamknięty po zakończeniu skryptu do-my-sql-commands.sh.

Utrwalanie danych

Zmiany konfiguracji programu SQL Server i pliki bazy danych są utrwalane w kontenerze, nawet jeśli ponownie uruchomisz kontener przy użyciu docker stop i docker start. Jeśli jednak usuniesz kontener z docker rm, wszystkie elementy w kontenerze zostaną usunięte, w tym program SQL Server i bazy danych. W poniższej sekcji wyjaśniono, jak używać woluminów danych do utrwalania plików bazy danych, nawet jeśli skojarzone kontenery zostaną usunięte.

Ważny

W przypadku programu SQL Server ważne jest zrozumienie trwałości danych na platformie Docker. Oprócz dyskusji w tej sekcji zobacz dokumentację platformy Docker dotyczącą sposobu zarządzania danymi w kontenerach platformy Docker.

Instalowanie katalogu hostów jako woluminu danych

Pierwszą opcją jest zainstalowanie katalogu na hoście jako woluminu danych w kontenerze. W tym celu użyj polecenia docker run z flagą -v <host directory>:/var/opt/mssql, gdzie <host directory> jest dowolną ścieżką. Na przykład: C:\SQL w systemie Windows lub ~/sqlvolumes w systemie Linux. Dzięki temu dane mogą być przywracane między wykonywaniem kontenera.

Notatka

Kontenery SQL Server 2019 (15.x) i nowszych wersji są automatycznie uruchamiane jako użytkownik nie-root, podczas gdy kontenery SQL Server 2017 (14.x) domyślnie uruchamiają się jako użytkownik root. Aby uzyskać więcej informacji na temat uruchamiania kontenerów programu SQL Server jako kontenerów innych niż root, zobacz Secure SQL Server Linux containers.

Ważny

Zmienna środowiskowa SA_PASSWORD jest przestarzała. Zamiast tego użyj MSSQL_SA_PASSWORD.

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<password>' \
-p 1433:1433 \
-v <host directory>/data:/var/opt/mssql/data \
-v <host directory>/log:/var/opt/mssql/log \
-v <host directory>/secrets:/var/opt/mssql/secrets \
-d mcr.microsoft.com/mssql/server:2022-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" `
-p 1433:1433 `
-v <host directory>/data:/var/opt/mssql/data `
-v <host directory>/log:/var/opt/mssql/log `
-v <host directory>/secrets:/var/opt/mssql/secrets `
-d mcr.microsoft.com/mssql/server:2022-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" ^
-p 1433:1433 ^
-v <host directory>/data:/var/opt/mssql/data ^
-v <host directory>/log:/var/opt/mssql/log ^
-v <host directory>/secrets:/var/opt/mssql/secrets ^
-d mcr.microsoft.com/mssql/server:2022-latest

Ostrożność

Hasło powinno być zgodne z domyślnymi zasadami haseł programu SQL Server. Domyślnie hasło musi mieć długość co najmniej ośmiu znaków i zawierać znaki z trzech z następujących czterech zestawów: wielkie litery, małe litery, cyfry podstawowe-10 i symbole. Hasła mogą mieć długość maksymalnie 128 znaków. Używaj haseł, które są tak długie i złożone, jak to możliwe.

Ta technika umożliwia również udostępnianie i wyświetlanie plików na hoście poza platformą Docker.

Korzystanie z kontenerów woluminów danych

Drugą opcją jest użycie kontenera woluminu danych. Kontener woluminu danych można utworzyć, określając nazwę woluminu zamiast katalogu hosta za pomocą parametru -v. Poniższy przykład tworzy udostępniony wolumin danych o nazwie sqlvolume.

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<password>' \
-p 1433:1433 \
-v sqlvolume:/var/opt/mssql \
-d mcr.microsoft.com/mssql/server:2022-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" `
-p 1433:1433 `
-v sqlvolume:/var/opt/mssql `
-d mcr.microsoft.com/mssql/server:2022-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" ^
-p 1433:1433 ^
-v sqlvolume:/var/opt/mssql ^
-d mcr.microsoft.com/mssql/server:2022-latest

Ostrożność

Hasło powinno być zgodne z domyślnymi zasadami haseł programu SQL Server. Domyślnie hasło musi mieć długość co najmniej ośmiu znaków i zawierać znaki z trzech z następujących czterech zestawów: wielkie litery, małe litery, cyfry podstawowe-10 i symbole. Hasła mogą mieć długość maksymalnie 128 znaków. Używaj haseł, które są tak długie i złożone, jak to możliwe.

Ta technika niejawnego tworzenia woluminu danych w poleceniu uruchamiania nie działa ze starszymi wersjami platformy Docker. W takim przypadku użyj jawnych kroków opisanych w dokumentacji platformy Docker, Tworzenie i instalowanie kontenera woluminów danych.

Nawet jeśli zatrzymasz i usuniesz ten kontener, wolumin danych będzie się powtarzać. Można go wyświetlić za pomocą polecenia docker volume ls.

docker volume ls

Jeśli następnie utworzysz inny kontener o tej samej nazwie woluminu, nowy kontener używa tych samych danych programu SQL Server zawartych w woluminie.

Aby usunąć kontener woluminów danych, użyj polecenia docker volume rm.

Ostrzeżenie

Jeśli usuniesz kontener woluminu danych, wszystkie dane programu SQL Server w kontenerze zostaną trwale trwale usunięte.

Tworzenie kopii zapasowej i przywracanie

Oprócz tych technik kontenerów można również użyć standardowych technik tworzenia i przywracania kopii zapasowych programu SQL Server. Pliki kopii zapasowej umożliwiają ochronę danych lub przenoszenie danych do innej instancji SQL Server. Aby uzyskać więcej informacji, zobacz Tworzenie kopii zapasowych i przywracanie baz danych programu SQL Server w systemie Linux.

Ostrzeżenie

Jeśli tworzysz kopie zapasowe, pamiętaj, aby utworzyć lub skopiować pliki kopii zapasowej poza kontenerem. W przeciwnym razie, jeśli kontener zostanie usunięty, pliki kopii zapasowej również zostaną usunięte.

Włączanie tworzenia i przywracania kopii zapasowych VDI w kontenerach

Operacje tworzenia i przywracania kopii zapasowych interfejsu urządzenia wirtualnego są teraz obsługiwane we wdrożeniach kontenerów programu SQL Server, począwszy od aktualizacji CU15 dla programu SQL Server 2019 (15.x) i CU28 dla programu SQL Server 2017 (14.x). Wykonaj następujące kroki, aby włączyć tworzenie lub przywracanie kopii zapasowych opartych na interfejsie VDI dla kontenerów programu SQL Server:

1. Podczas wdrażania kontenerów programu SQL Server użyj opcji --shm-size. Aby rozpocząć, ustaw rozmiar na 1 GB, jak pokazano w poniższym poleceniu. Zastąp <password> prawidłowym hasłem.

   docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" \
   --shm-size 1g \
   -p 1433:1433 \
   --name sql19 \
   --hostname sql19 \
   -d mcr.microsoft.com/mssql/server:2019-latest
   

   Opcja --shm-size umożliwia skonfigurowanie rozmiaru katalogu pamięci udostępnionej (/dev/shm) wewnątrz kontenera, który jest domyślnie ustawiony na 64 MB. Ten domyślny rozmiar pamięci udostępnionej jest niewystarczający do obsługi kopii zapasowych VDI. Zalecamy skonfigurowanie tego do co najmniej 1 GB podczas wdrażania kontenerów programu SQL Server i obsługi kopii zapasowych VDI.

2. Należy również włączyć nowy parametr memory.enablecontainersharedmemory w mssql.conf wewnątrz kontenera. mssql.conf można zainstalować we wdrożeniu kontenera przy użyciu opcji -v zgodnie z opisem w sekcji Utrwalanie danych lub po wdrożeniu kontenera, ręcznie aktualizując mssql.conf wewnątrz kontenera. Oto przykładowy plik mssql.conf z ustawieniem memory.enablecontainersharedmemory ustawionym na true.

   [memory]
   enablecontainersharedmemory = true
   

Kopiowanie plików z kontenera

Aby skopiować plik z kontenera, użyj następującego polecenia:

docker cp <Container ID>:<Container path> <host path>

Identyfikator kontenera można uzyskać, uruchamiając polecenie docker ps -a.

Przykład :

docker cp d6b75213ef80:/var/opt/mssql/log/errorlog /tmp/errorlog

docker cp d6b75213ef80:/var/opt/mssql/log/errorlog C:\Temp\errorlog

docker cp d6b75213ef80:/var/opt/mssql/log/errorlog C:\Temp\errorlog

Kopiowanie plików do kontenera

Aby skopiować plik do kontenera, użyj następującego polecenia:

docker cp <Host path> <Container ID>:<Container path>

Przykład :

docker cp /tmp/mydb.mdf d6b75213ef80:/var/opt/mssql/data

docker cp C:\Temp\mydb.mdf d6b75213ef80:/var/opt/mssql/data

docker cp C:\Temp\mydb.mdf d6b75213ef80:/var/opt/mssql/data

Konfigurowanie strefy czasowej

Aby uruchomić program SQL Server w kontenerze systemu Linux z określoną strefą czasową, skonfiguruj zmienną środowiskową TZ (zobacz Konfigurowanie strefy czasowej dla programu SQL Server 2022 w systemie Linux, aby uzyskać więcej informacji). Aby znaleźć prawidłową wartość strefy czasowej, uruchom polecenie tzselect z terminala bash w systemie Linux.

tzselect

Po wybraniu strefy czasowej tzselect wyświetla dane wyjściowe podobne do następującego przykładu:

The following information has been given:

    United States
    Pacific

Therefore TZ='America/Los_Angeles' will be used.

Te informacje umożliwiają ustawienie tej samej zmiennej środowiskowej w kontenerze systemu Linux. W poniższym przykładzie pokazano, jak uruchomić program SQL Server w kontenerze w strefie czasowej Americas/Los_Angeles:

sudo docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<password>' \
-p 1433:1433 --name sql1 \
-e 'TZ=America/Los_Angeles' \
-d mcr.microsoft.com/mssql/server:2022-latest

sudo docker run -e 'ACCEPT_EULA=Y' -e "MSSQL_SA_PASSWORD=<password>" `
-p 1433:1433 --name sql1 `
-e "TZ=America/Los_Angeles" `
-d mcr.microsoft.com/mssql/server:2022-latest

sudo docker run -e 'ACCEPT_EULA=Y' -e "MSSQL_SA_PASSWORD=<password>" ^
-p 1433:1433 --name sql1 ^
-e "TZ=America/Los_Angeles" ^
-d mcr.microsoft.com/mssql/server:2022-latest

Ostrożność

Hasło powinno być zgodne z domyślnymi zasadami haseł programu SQL Server. Domyślnie hasło musi mieć długość co najmniej ośmiu znaków i zawierać znaki z trzech z następujących czterech zestawów: wielkie litery, małe litery, cyfry podstawowe-10 i symbole. Hasła mogą mieć długość maksymalnie 128 znaków. Używaj haseł, które są tak długie i złożone, jak to możliwe.

Zmień ścieżkę tempdb

Dobrym rozwiązaniem jest oddzielenie bazy danych tempdb od baz danych użytkowników.

1. Połącz się z wystąpieniem SQL Server, a następnie uruchom następujący skrypt Transact-SQL (T-SQL). Jeśli istnieje więcej plików skojarzonych z tempdb, należy je również przenieść.

   ALTER DATABASE tempdb
       MODIFY FILE (NAME = tempdev, FILENAME = '/var/opt/mssql/tempdb/tempdb.mdf');
   GO
   
   ALTER DATABASE tempdb
       MODIFY FILE (NAME = templog, FILENAME = '/var/opt/mssql/tempdb/templog.ldf');
   GO
   

2. Sprawdź, czy lokalizacja pliku tempdb została zmodyfikowana przy użyciu następującego skryptu języka T-SQL:

   SELECT *
   FROM sys.sysaltfiles
   WHERE dbid = 2;
   

3. Aby te zmiany zaczęły obowiązywać, należy ponownie uruchomić kontener programu SQL Server.

   docker stop sql1
   docker start sql1
   

   docker stop sql1
   docker start sql1
   

   docker stop sql1
   docker start sql1
   

4. Otwórz interaktywną sesję bash, aby nawiązać połączenie z kontenerem.

   docker exec -it sql1 bash
   

   docker exec -it sql1 bash
   

   docker exec -it sql1 bash
   

   Po nawiązaniu połączenia z interaktywną powłoką uruchom następujące polecenie, aby sprawdzić lokalizację tempdb:

   ls /var/opt/mssql/tempdb/
   

   Jeśli przeniesienie zakończyło się pomyślnie, zobaczysz podobne dane wyjściowe:

   tempdb.mdf templog.ldf
   

Zmienianie domyślnej lokalizacji pliku

Dodaj zmienną MSSQL_DATA_DIR, aby zmienić katalog danych w poleceniu docker run, a następnie zainstaluj wolumin w tej lokalizacji, do którego użytkownik kontenera ma dostęp.

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<password>' \
-e 'MSSQL_DATA_DIR=/my/file/path' \
-v /my/host/path:/my/file/path \
-p 1433:1433 \
-d mcr.microsoft.com/mssql/server:2022-latest

docker run -e 'ACCEPT_EULA=Y' -e "MSSQL_SA_PASSWORD=<password>" `
-e "MSSQL_DATA_DIR=/my/file/path" `
-v /my/host/path:/my/file/path `
-p 1433:1433 `
-d mcr.microsoft.com/mssql/server:2022-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" ^
-e "MSSQL_DATA_DIR=/my/file/path" ^
-v /my/host/path:/my/file/path ^
-p 1433:1433 ^
-d mcr.microsoft.com/mssql/server:2022-latest

Konfigurowanie programu SQL Server wewnątrz kontenera przy użyciu narzędzia mssql-config

Aby ustawić parametry w kontenerach programu SQL Server, możesz użyć narzędzia mssql-conf.

Na przykład można ustawić limit pamięci dla wystąpienia, wykonując następujące kroki:

1. Połącz się bezpośrednio z kontenerem przy użyciu docker exec jako użytkownik root. Zastąp sqlcontainer nazwą kontenera.

   docker exec -u root -it sqlcontainer "bash"
   

2. Aby zmienić ustawienie, użyj mssql-conf. Ten przykład zmienia ustawienie memory.memorylimitmb na 2 GB (2048 MB).

   /opt/mssql/bin/mssql-conf set memory.memorylimitmb 2048
   

Przykłady niestandardowych kontenerów platformy Docker

Aby zapoznać się z przykładami niestandardowych kontenerów platformy Docker, zobacz https://github.com/microsoft/mssql-docker/tree/master/linux/preview/examples. Przykłady obejmują:

• przykład pliku Dockerfile z Full-Text Search
• przykład pliku Dockerfile dla systemów RHEL 7 i SQL Server 2019
• przykład pliku Dockerfile dla systemów RHEL 8 i SQL Server 2017
• przykład Dockerfile dla systemów Ubuntu 20.04 i SQL Server 2019, zawierający Full-Text Search, PolyBase oraz narzędzia

Aby uzyskać informacje na temat sposobu kompilowania i uruchamiania kontenerów platformy Docker przy użyciu plików Dockerfiles, zobacz przykłady usług ML services w witrynie GitHub.

Powiązana zawartość

• Rozpocznij pracę z obrazami kontenerów programu SQL Server 2022 (16.x) na platformie Docker, realizując przewodnik szybkiego startu

• Wdrażanie i łączenie z kontenerami SQL Server na Linuksie

• Rozwiązywanie problemów z kontenerami platformy Docker programu SQL Server

• Zabezpieczanie kontenerów systemu Linux programu SQL Server

Współtworzenie dokumentacji SQL

Czy wiesz, że możesz samodzielnie edytować zawartość SQL? Jeśli to zrobisz, nie tylko pomożesz ulepszyć naszą dokumentację, ale także zostaniesz uznany jako współtwórca strony.

Aby uzyskać więcej informacji, zobacz Edytowanie dokumentacji środowiska Microsoft Learn.