Bangun dengan kontainer Azure SQL Database

Berlaku untuk:Azure SQL Database

Dalam quickstart ini, Anda memulai dengan kontainer Azure SQL Database, membuat database lokal, dan menjalankan query pertama Anda. Kemudian, gunakan Azure SQL Dev Hub untuk membangun aplikasi dengan contoh, prompt, dan keterampilan agen pengkodean AI.

Note

kontainer Azure SQL Database berada dalam pratinjau publik.

Apa itu kontainer Azure SQL Database?

Sebuah kontainer mengemas mesin basis data sehingga Anda dapat menjalankannya di komputer Anda dengan runtime kontainer. Kontainer Azure SQL Database menjalankan mesin Azure SQL Database, bukan image kontainer SQL Server. Aplikasi Anda terhubung ke alamat lokal, seperti localhost,1433, bukan ke database di Azure.

Gunakan kontainer untuk mempelajari T-SQL, mengembangkan aplikasi, menguji perubahan skema, atau menjalankan pengujian integrasi berkelanjutan (CI). Anda juga dapat menjelajahi vektor native, pencarian vektor, dan JSON untuk aplikasi AI. Aplikasi ini bekerja dengan driver dan object-relational mapper (ORM) yang Anda gunakan untuk Azure SQL Database.

Kontainer ini gratis untuk pengembangan dan pengujian lokal. Anda tidak perlu langganan Azure atau kartu kredit untuk menjalankannya secara lokal.

Important

Kontainer ini untuk pengembangan, pengujian, CI, dan demo, bukan produksi. Ia tidak menyediakan layanan yang dikelola Azure seperti backup otomatis, ketersediaan tinggi, atau elastic pool. Untuk produksi, terapkan database dan aplikasi Anda ke layanan Azure, bukan ke kontainer lokal.

Untuk informasi lebih lanjut, lihat Apa itu kontainer Azure SQL Database?.

Prerequisites

  • Runtime kontainer yang terpasang dan menjalankan kontainer Linux. Pilih Docker, Podman, container WSL, atau alat container Apple seperti yang dijelaskan di bagian berikutnya.
  • Komputer x64 atau ARM64 yang didukung yang menjalankan macOS, Linux, atau Windows dengan Subsistem Windows untuk Linux 2 (WSL2). Image ini menyediakan varian native linux/amd64 dan linux/arm64.
  • Setidaknya dua inti CPU, 4 GB memori tersedia untuk runtime kontainer, dan 10 GB ruang disk kosong untuk gambar serta sebuah database kecil.
  • Akses internet untuk unduhan gambar awal. Kueri lokal dapat dijalankan offline setelahnya; layanan eksternal masih memerlukan konektivitas.
  • Port host yang tersedia, seperti 1433, dan nama kontainer unik. Contoh menggunakan sqldb. Pilih nama atau port host yang berbeda jika salah satunya sudah digunakan.

Tinjau prasyarat kontainer untuk persyaratan platform saat ini dan runtime.

Pilih runtime kontainer

Gunakan runtime yang sesuai dengan sistem operasi Anda. Contoh-contoh ini menggunakan native image untuk arsitektur host Anda; mereka tidak mengonfigurasi emulasi.

Runtime Setup
Docker Instal Docker Desktop atau Docker Engine, dan pastikan berjalan dengan dukungan kontainer Linux.
Podman Pasang Podman. Di macOS dan Windows, inisialisasi mesin Podman jika diperlukan, lalu mulai dengan podman machine start.
Kontainer WSL Instal atau perbarui WSL agar tersedia wslc.exe . Jalankan wslc dari PowerShell pada host Windows. Dari Bash di dalam distribusi WSL, gunakan wslc.exe; Interoperabilitas WSL harus diaktifkan dan wslc.exe harus ada di PATH. Port yang dipublikasikan berada di host Windows.
Apple container Instal alat container milik Apple pada Mac Apple silicon yang menjalankan macOS 26. Mulai layanannya dengan container system start.

Runtime lain yang kompatibel dengan OCI, seperti containerd dengan nerdctl atau Rancher Desktop, juga dapat menjalankan image. Gunakan dokumentasi runtime Anda untuk perintah dan konfigurasinya.

Dapatkan gambar pratinjau publik

Referensi gambar pratinjau publik adalah mcr.microsoft.com/mssql/azure-sql-db-server:latest. Dapatkan informasi gambar dari daftar Microsoft Artifact Registry. Gambar publik tidak memerlukan akun registri pratinjau privat atau login registri.

Perintah berikut akan mengunduh image secara otomatis jika tidak di-cache secara lokal. Untuk mengunduhnya secara terpisah dengan Docker, jalankan:

docker pull mcr.microsoft.com/mssql/azure-sql-db-server:latest

Untuk Podman, wadah WSL, atau wadah Apple, gunakan podman pull, wslc pull, atau container image pull, masing-masing, dengan referensi gambar yang sama.

Memulai kontainer

Ganti <your-strong-password> dengan kata sandi unik dan kuat untuk autentikasi sa. Gunakan setidaknya delapan karakter dengan karakter dari setidaknya tiga grup ini: huruf kapital, huruf kecil, digit, dan simbol. Jauhkan kata sandi dari source control dan output terminal bersama. Kata sandi juga terlihat dalam konfigurasi kontainer.

Pilih runtime Anda, lalu jalankan perintahnya. Mengatur ACCEPT_EULA=Y berarti Anda menyetujui persyaratan lisensi image. Setiap contoh mengalokasikan 2 GiB memori dan dua CPU ke kontainer serta menerbitkan port 1433 database pada alamat loopback host.

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

Kontainer yang sedang berjalan tidak selalu berarti mesin database sudah siap. Gunakan utilitas sqlcmd yang dibundel dengan kontainer untuk memeriksa koneksi SQL yang berhasil:

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;"

Ganti docker dengan podman, wslc (atau wslc.exe di dalam WSL), atau container untuk runtime Anda. Coba kembali saat engine dimulai. Output yang berhasil meliputi Microsoft SQL Azure. Opsi ini -b mengembalikan kode keluar kesalahan untuk kesalahan SQL; -l 5 dan -t 5 batasi waktu tunggu login dan query masing-masing hingga lima detik. -C mempercayai sertifikat yang ditandatangani sendiri dari kontainer untuk koneksi lokal ini; gunakan validasi sertifikat yang tepat di luar pengembangan lokal.

Pemeriksaan ini terhubung di dalam kontainer, bukan melalui port host yang dipublikasikan. Untuk terhubung dari editor atau aplikasi Anda, gunakan server 127.0.0.1,1433, autentikasi SQL, login sa, dan kata sandi yang Anda konfigurasikan. Sesuaikan port jika Anda mengubah pemetaan host.

Jika SQL tidak menerima koneksi, periksa log dengan docker logs --tail 80 sqldb, podman logs --tail 80 sqldb, wslc logs --tail 80 sqldb, atau container logs -n 80 sqldb. Periksa kebijakan kata sandi dan sumber daya yang tersedia sebelum mencoba lagi.

Jika Anda lebih menyukai pengalaman pengaturan grafis, ikuti Build locally with Azure SQL Database container dan SQL Server container di ekstensi MSSQL untuk Visual Studio Code, atau Connect and Query an Azure SQL Database Container | Microsoft Learn untuk SSMS.

Buat database dan jalankan query

Gunakan klien SQL, seperti utilitas sqlcmd yang disertakan dalam kontainer, atau jendela kueri editor Anda. Misalnya, buka koneksi interaktif master dengan perintah berikut, ganti docker dengan CLI runtime Anda dan gunakan kata sandi yang dikonfigurasi:

docker exec -it sqldb /opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P "<your-strong-password>" -C -b -d master

Dalam sesi interaktif sqlcmd , masukkan GO pada baris baru setelah setiap pernyataan SQL atau query untuk menjalankannya. Enter EXIT untuk menutup sesi.

  1. Hubungkan ke database kontainer master lokal dengan kredensial yang Anda konfigurasikan, dan jalankan:

    CREATE DATABASE appdb;
    

    Nama appdb adalah contoh; Anda dapat memilih nama database yang berbeda. Jika alat pengaturan Anda sudah membuat database pengguna, gunakan database tersebut dan lewati langkah ini.

  2. Buka koneksi baru langsung ke appdb. Tentukan database dalam pengaturan koneksi klien Anda atau dengan -d appdb di sqlcmd. Jangan gunakan USE untuk mengganti database dalam sesi user-database Azure SQL Database.

    Untuk perintah interaktif sebelum langkah ini, keluar dari master sesi, lalu jalankan perintah lagi dengan -d appdb menggantikan -d master.

  3. Jalankan kueri ini pada appdb koneksi:

    SELECT
        DB_NAME() AS current_database,
        SERVERPROPERTY('EngineEdition') AS engine_edition,
        SERVERPROPERTY('Edition') AS edition,
        1 AS connected;
    

    Harapkan current_database untuk menjadi appdb, engine_edition menjadi 5, edition menjadi SQL Azure, dan connected menjadi 1. Nilai-nilai ini mengonfirmasi bahwa Anda terhubung ke database pengguna Anda di engine Azure SQL Database. Jika edisinya berbeda, periksa apakah Anda memulai image Azure SQL Database, bukan image SQL Server.

Sekarang Anda memiliki basis data lokal untuk pengembangan aplikasi. Gunakan nama database yang sama di string koneksi aplikasi Anda.

Bangun dengan Azure SQL Dev Hub

Kunjungi Azure SQL Dev Hub untuk memilih skenario aplikasi dan mulai dengan prompt, contoh, serta keterampilan agen. Anda dapat membangun aplikasi pelacak tugas, membuat API, atau menjelajahi pencarian vektor untuk aplikasi retrieval-augmented generation (RAG).

Beberapa prompt Dev Hub, seperti prompt aplikasi JavaScript, menargetkan database cloud dan memerlukan autentikasi Microsoft Entra. Sebelum menjalankan prompt secara lokal, sesuaikan baik instruksi maupun konfigurasi koneksinya dengan server, port yang dipetakan, nama database, dan metode autentikasi kontainer Anda. Jika Anda menggunakan jalur autentikasi SQL default panduan pengaturan, ganti persyaratan autentikasi khusus cloud dengan kredensial SQL yang dikonfigurasi, jaga kredensial agar tidak masuk ke kontrol sumber, dan percayakan sertifikat self-signed hanya untuk koneksi kontainer lokal. Tinjau SQL, izin, dan perubahan skema yang dihasilkan sebelum Anda menjalankannya.

Saat Anda siap pindah ke Azure, buat database di Azure SQL Database, terapkan skema dan data Anda, serta perbarui konfigurasi koneksi aplikasi Anda. Langganan Azure diperlukan untuk sumber daya cloud. Tier gratis Azure SQL Database adalah opsi cloud terpisah dengan batasan dan batasan tersendiri.

Sebelum deployment, uji menggunakan Azure SQL Database di Azure. Pembatasan pratinjau, default, dan dukungan fitur dapat berbeda dari layanan cloud. Tinjau keterbatasan yang sudah diketahui.

Membersihkan sumber daya

Setelah selesai, hentikan kontainer dengan alat runtime atau pengembangan Anda.

Runtime Menghentikan kontainer Hapus wadah yang dihentikan
Docker docker stop sqldb docker rm sqldb
Podman podman stop sqldb podman rm sqldb
Kontainer WSL wslc stop sqldb wslc rm sqldb
Kontainer Apple container stop sqldb container delete sqldb

Perintah run dalam quickstart ini tidak mengonfigurasi penyimpanan persisten. Menghapus kontainer dapat menghapus file database-nya, jadi simpan data yang Anda butuhkan terlebih dahulu. Jika Anda mengonfigurasi volume data secara terpisah, hapus hanya jika Anda berniat menghapus datanya.