Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Dotyczy do:Azure SQL Database
W tym szybkim starcie zaczynasz pracę z kontenerem Azure SQL Database, tworzysz lokalną bazę danych i uruchamiasz pierwsze zapytanie. Następnie użyj Azure SQL Dev Hub do zbudowania aplikacji z przykładami, promptami i umiejętnościami agenta kodowania AI.
Note
kontener Azure SQL Database jest w publicznej wersji zapoznawczej.
Czym jest kontener Azure SQL Database?
Kontener pakuje silnik bazy danych, abyś mógł go uruchamiać na swoim komputerze za pomocą środowiska uruchomieniowego kontenera. Kontener Azure SQL Database uruchamia silnik Azure SQL Database, a nie obraz kontenera SQL Server. Twoja aplikacja łączy się z lokalnym adresem, takim jak localhost,1433, zamiast z bazą danych w Azure.
Użyj kontenera, aby nauczyć się T-SQL, tworzyć aplikacje, testować zmiany schematów lub uruchamiać testy ciągłej integracji (CI). Możesz także eksplorować natywne wektory, wyszukiwanie wektorowe oraz JSON dla zastosowań AI. Współpracuje ze sterownikami i maperami obiektowo-relacyjnymi (ORM), których używasz dla Azure SQL Database.
Kontener jest bezpłatny do lokalnego rozwoju i testów. Nie potrzebujesz subskrypcji Azure ani karty kredytowej, aby uruchomić ją lokalnie.
Important
Kontener jest przeznaczony do rozwoju, testów, CI i demonstracji, nie do produkcji. Nie oferuje usług zarządzanych przez Azure, takich jak automatyczne kopie zapasowe, wysoka dostępność czy elastyczne pule. Dla produkcji wdrażaj bazę danych i aplikację w usługach Azure, a nie w lokalnym kontenerze.
Aby uzyskać więcej informacji, zobacz Czym jest kontener Azure SQL Database?.
Prerequisites
- Środowisko uruchomieniowe kontenerów, zainstalowane i obsługujące oraz uruchamiające kontenery Linux. Wybierz Docker, Podman, kontenery WSL lub narzędzie Apple
container, jak opisano w następnej sekcji. - Obsługiwany komputer x64 lub ARM64 z systemem macOS, Linux lub Windows z Podsystem Windows dla systemu Linux 2 (WSL2). Obraz zawiera natywne
linux/amd64ilinux/arm64warianty. - Co najmniej dwa rdzenie CPU, 4 GB pamięci dostępne dla środowiska uruchomieniowego kontenera oraz 10 GB wolnego miejsca na obrazie i małą bazę danych.
- Dostęp do Internetu dla początkowego pobrania obrazu. Zapytania lokalne mogą działać później offline; usługi zewnętrzne nadal wymagają łączności.
- Dostępny port hosta, taki jak
1433, oraz unikalna nazwa kontenera. W przykładach użyto metodysqldb. Wybierz inną nazwę lub port hosta, jeśli którykolwiek z nich jest już używany.
Przejrzyj wymagania wstępne kontenera dla bieżącej platformy i środowiska wykonawczego.
Wybierz środowisko uruchomieniowe kontenera
Użyj środowiska wykonawczego dopasowanego do Twojego systemu operacyjnego. Te przykłady używają natywnych obrazów dla architektury hosta; nie konfigurują emulacji.
| Runtime | Konfiguracja |
|---|---|
| Docker | Zainstaluj Docker Desktop lub Docker Engine i upewnij się, że działa z obsługą kontenerów Linuksa. |
| Podman | Zainstaluj Podman. Na macOS i Windows zainicjuj maszynę Podman, jeśli to konieczne, a następnie uruchom ją za pomocą podman machine start. |
| Kontenery WSL | Zainstaluj lub zaktualizuj WSL , aby był wslc.exe dostępny. Uruchom wslc z PowerShell na hoście Windows. Z Bash wewnątrz dystrybucji WSL użyj wslc.exe; Interoperacyjność WSL musi być włączona i wslc.exe musi znajdować się w PATH. Opublikowany port znajduje się na hoście Windows. |
| Apple container | Zainstaluj narzędzie kontenerowe Apple na Macu Apple Silicon z macOS 26. Uruchom jego usługę za pomocą container system start. |
Inne środowiska uruchomieniowe kompatybilne z OCI, takie jak containerd z nerdctl lub Rancher Desktop, również mogą uruchamiać obraz. Korzystaj z dokumentacji swojego środowiska uruchomieniowego, aby znaleźć informacje o jego poleceniach i konfiguracji.
Pobierz obraz podglądu publicznego
Odniesienie do obrazu podglądu publicznego to mcr.microsoft.com/mssql/azure-sql-db-server:latest. Pobierz informacje o obrazach z listy Microsoft Artifact Registry. Obrazy publiczne nie wymagają konta rejestru w prywatnej wersji zapoznawczej ani logowania do rejestru.
Poniższe polecenia automatycznie pobierają obraz kontenera, jeśli nie jest on lokalnie buforowany. Aby pobrać ją osobno za pomocą Dockera, uruchom:
docker pull mcr.microsoft.com/mssql/azure-sql-db-server:latest
Dla kontenerów Podman, WSL lub Apple użyj odpowiednio podman pull, wslc pull lub container image pull z tym samym odniesieniem do obrazu.
Uruchamianie kontenera
Zamień <your-strong-password> na unikalne, silne hasło do sa uwierzytelniania. Używaj co najmniej ośmiu znaków z co najmniej trzech z tych grup: wielkich liter, małych liter, cyfr i symboli. Trzymaj hasła z dala od systemu kontroli wersji i współdzielonych danych wyjściowych terminala. Hasło jest również widoczne w konfiguracji kontenera.
Wybierz środowisko uruchomieniowe, a następnie uruchom odpowiednie polecenie. Ustawienie opcji ACCEPT_EULA=Y oznacza akceptację warunków licencyjnych obrazu. Każdy przykład przydziela kontenerowi 2 GiB pamięci i dwa procesory oraz publikuje port 1433 bazy danych na adresie loopback hosta.
docker run --name sqldb --memory 2g --cpus 2 -e ACCEPT_EULA=Y -e "MSSQL_SA_PASSWORD=<your-strong-password>" -p 127.0.0.1:1433:1433 -d mcr.microsoft.com/mssql/azure-sql-db-server:latest
Działający kontener niekoniecznie oznacza, że silnik bazy danych jest gotowy. Użyj narzędzia sqlcmd dołączonego do kontenera, aby sprawdzić pomyślne połączenie SQL:
docker exec sqldb /opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P "<your-strong-password>" -C -b -l 5 -t 5 -Q "SELECT @@VERSION;"
Zastąp wslc.exe elementem container, wslc (lub podman w WSL) albo docker dla używanego środowiska uruchomieniowego. Ponawiaj próbę podczas uruchamiania silnika. Pomyślne dane wyjściowe obejmują Microsoft SQL Azure. Opcja -b zwraca kod wyjścia błędu dla błędów SQL; -l 5 oraz -t 5 ograniczają oczekiwania logowania i zapytania do pięciu sekund każde.
-C ufa samopodpisanemu certyfikatowi kontenera dla tego lokalnego połączenia; używaj właściwej walidacji certyfikatów poza lokalnym rozwojem.
Ta kontrola łączy się wewnątrz kontenera, a nie przez opublikowany port hosta. Aby połączyć się w edytorze lub aplikacji, użyj serwera 127.0.0.1,1433, uwierzytelniania SQL, loginu sa oraz skonfigurowanego hasła. Dostosuj port, jeśli zmieniłeś mapowanie hosta.
Jeśli SQL nie akceptuje połączeń, przejrzyj logi za pomocą docker logs --tail 80 sqldb, podman logs --tail 80 sqldb, wslc logs --tail 80 sqldb lub container logs -n 80 sqldb. Sprawdź politykę haseł i dostępne zasoby przed ponowną próbą.
Jeśli wolisz graficzny sposób konfiguracji, skorzystaj z Build locally with Azure SQL Database container and SQL Server container w rozszerzeniu MSSQL dla Visual Studio Code. Wybierz kontener Azure SQL Database (Podgląd), a nie kontener SQL Server.
Utwórz bazę danych i uruchom zapytanie
Użyj klienta SQL, takiego jak narzędzie sqlcmd dołączone do kontenera, lub okno zapytań edytora. Na przykład otwórz połączenie interaktywne master za pomocą następującego polecenia, zastępując docker go CLI swojego środowiska wykonywania i używając skonfigurowanego hasła:
docker exec -it sqldb /opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P "<your-strong-password>" -C -b -d master
W sesji interaktywnej sqlcmd wpisz GO w nowej linii po każdym poleceniu lub zapytaniu SQL, aby je wykonać. Wpisz EXIT, aby zakończyć sesję.
Połącz się z bazą danych
masterlokalnego kontenera za pomocą skonfigurowanych poświadczeń i uruchom:CREATE DATABASE appdb;Nazwa
appdbjest przykładem; możesz wybrać inną nazwę bazy danych. Jeśli Twoje narzędzie konfiguracyjne już utworzyło bazę danych użytkownika, użyj tej bazy danych i pomiń ten krok.Otwórz nowe połączenie bezpośrednio do
appdb. Określ bazę danych w ustawieniach połączenia klienta lub za pomocą-d appdbwsqlcmd. Nie używajUSEdo przełączania baz danych w sesji użytkownika Azure SQL Database.W przypadku interaktywnego polecenia poprzedzającego ten krok zakończ sesję
master, a następnie uruchom polecenie ponownie z-d appdbzamiast-d master.Uruchom to zapytanie na połączeniu
appdb:SELECT DB_NAME() AS current_database, SERVERPROPERTY('EngineEdition') AS engine_edition, SERVERPROPERTY('Edition') AS edition, 1 AS connected;Spodziewaj się, że
current_databasebędzie mieć wartośćengine_edition,appdbbędzie mieć wartość5,editionbędzie mieć wartośćSQL Azure, aconnectedbędzie mieć wartość1. Te wartości potwierdzają, że połączyłeś się z bazą danych użytkownika w silniku Azure SQL Database. Jeśli edycja się różni, sprawdź, czy uruchomiłeś obraz Azure SQL Database, a nie obraz SQL Server.
Masz teraz lokalną bazę danych do tworzenia aplikacji. Użyj tej samej nazwy bazy danych w parametry połączenia swojej aplikacji.
Buduj z Azure SQL Dev Hub
Odwiedź Azure SQL Dev Hub, aby wybrać scenariusz aplikacji i rozpocząć od promptów, przykładów oraz umiejętności agenta. Możesz zbudować aplikację do śledzenia zadań, stworzyć API lub eksplorować wyszukiwanie wektorowe dla aplikacji generowania wspomaganego wyszukiwaniem (RAG).
Niektóre komunikaty Dev Hub, takie jak prompt aplikacji JavaScript, są skierowane do baz danych w chmurze i wymagają uwierzytelniania Microsoft Entra. Przed uruchomieniem monitu lokalnie dostosuj zarówno jego instrukcje, jak i konfigurację połączenia do serwera kontenera, zmapowanego portu, nazwy bazy danych oraz metody uwierzytelniania. Jeśli korzystasz z domyślnej ścieżki uwierzytelniania SQL z przewodnika konfiguracji, zamień wymagania uwierzytelniania tylko w chmurze na skonfigurowane dane uwierzytelniające SQL, zachowaj poświadczenia poza kontrolą wersji i zaufaj certyfikatowi podpisanemu samodzielnie tylko dla połączenia z lokalnym kontenerem. Przejrzyj wygenerowane zmiany SQL, uprawnień i schematu przed ich uruchomieniem.
Gdy będziesz gotowy przejść na Azure, utwórz bazę danych w Azure SQL Database, wdroż swój schemat i dane oraz zaktualizuj konfigurację połączenia w aplikacji. Subskrypcja Azure jest wymagana dla zasobów chmurowych. Darmowa warstwa Azure SQL Database to osobna opcja chmurowa z własnymi przydziałami i limitami.
Przed wdrożeniem przetestuj Azure SQL Database w Azure. Ograniczenia podglądu, domyślne ustawienia i wsparcie funkcji mogą się różnić od usługi w chmurze. Przejrzyj znane ograniczenia.
Uprzątnij zasoby
Po zakończeniu zatrzymaj kontener za pomocą swojego środowiska uruchomieniowego lub narzędzia deweloperskiego.
| Runtime | Zatrzymaj kontener | Usuń zatrzymany kontener |
|---|---|---|
| Docker | docker stop sqldb |
docker rm sqldb |
| Podman | podman stop sqldb |
podman rm sqldb |
| Kontenery WSL | wslc stop sqldb |
wslc rm sqldb |
| kontener Apple | container stop sqldb |
container delete sqldb |
Polecenia run w tym szybkim starcie nie konfigurują trwałego przechowywania danych. Usunięcie kontenera może usunąć pliki bazy danych, więc najpierw zachowaj potrzebne dane. Jeśli skonfigurujesz wolumin danych osobno, usuń go tylko wtedy, gdy zamierzasz usunąć jego dane.