Bagikan melalui


Menggunakan paket SQL Database DACPAC dan BACPAC - Azure SQL Edge

Penting

Azure SQL Edge akan dihentikan pada 30 September 2025. Untuk informasi selengkapnya dan opsi migrasi, lihat Pemberitahuan penghentian.

Catatan

Azure SQL Edge tidak lagi mendukung platform ARM64.

Azure SQL Edge adalah mesin database relasional yang dioptimal untuk penyebaran IoT dan IoT Edge. Azure SQL Edge dibangun pada versi terbaru Mesin Database SQL Server, yang menyediakan performa, keamanan, dan kemampuan pemprosesan kueri terbaik di industri. Seiring dengan kemampuan manajemen database relasional terdepan di industri SQL Server, Azure SQL Edge menyediakan kemampuan streaming bawaan untuk analitik real-time dan pemrosesan peristiwa yang kompleks.

Azure SQL Edge menyediakan mekanisme asli untuk menyebarkan paket SQL Database DACPAC dan BACPAC selama, atau setelah menyebarkan, SQL Edge.

Paket SQL Database DACPAC dan BACPAC dapat disebarkan ke SQL Edge menggunakan MSSQL_PACKAGE variabel lingkungan. Variabel lingkungan dapat dikonfigurasi dengan salah satu hal berikut ini.

  • Lokasi folder lokal dalam kontainer SQL yang berisi file DACPAC dan BACPAC. Folder ini dapat dipetakan ke volume host menggunakan titik pemasangan atau volume data.
  • Jalur file lokal dalam pemetaan kontainer SQL ke DACPAC atau file BACPAC. Folder ini dapat dipetakan ke volume host menggunakan titik pemasangan atau kontainer volume data.
  • Jalur file lokal dalam pemetaan kontainer SQL ke file zip yang berisi file DACPAC atau BACPAC. Folder ini dapat dipetakan ke volume host menggunakan titik pemasangan atau kontainer volume data.
  • URL SAS Azure Blob ke file zip yang berisi file DACPAC dan BACPAC.
  • URL SAS Azure Blob ke DACPAC atau file BACPAC.

Menggunakan paket SQL Database DAC dengan SQL Edge

Untuk menyebarkan (atau mengimpor) paket (*.dacpac) DAC SQL Database atau file (*.bacpac) BACPAC menggunakan penyimpanan Azure Blob dan file zip, ikuti langkah-langkah ini.

  1. Buat/ekstrak paket DAC atau ekspor file BACPAC menggunakan salah satu mekanisme berikut.

    Jika Anda menggunakan pekerjaan streaming eksternal sebagai bagian dari database, pastikan bahwa:

    • DACPAC yang dihasilkan menangkap semua objek SQL Server yang sesuai dengan aliran input/output dan pekerjaan streaming, tetapi pekerjaan tidak akan dimulai secara otomatis. Agar pekerjaan streaming eksternal dimulai secara otomatis setelah penyebaran, tambahkan skrip pasca-penyebaran yang memulai ulang pekerjaan sebagai berikut:

      EXEC `sys.sp_stop_streaming_job` @name = N'<JOB NAME>';
      GO
      EXEC `sys.sp_start_streaming_job` @name = N'<JOB NAME>';
      GO
      
    • Kredensial apa pun yang diperlukan oleh pekerjaan streaming eksternal untuk mengakses aliran input atau output disediakan sebagai bagian dari DACPAC.

  2. Tutup *.dacpac file atau *.bacpac unggah ke akun penyimpanan Azure Blob. Untuk informasi selengkapnya tentang mengunggah file ke penyimpanan Azure Blob, lihat Mengunggah, mengunduh, dan mencantumkan blob dengan portal Microsoft Azure.

  3. Hasilkan tanda khas akses bersama untuk file zip dengan menggunakan portal Microsoft Azure. Untuk informasi selengkapnya, lihat Mendelegasikan akses dengan tanda khas akses bersama (SAS).

  4. Perbarui konfigurasi modul SQL Edge untuk menyertakan URI akses bersama untuk paket DAC. Untuk memperbarui modul SQL Edge, lakukan langkah-langkah berikut:

    1. Di portal Microsoft Azure, buka penerapan Hub IoT Anda.
    2. Di panel kiri, pilih IoT Edge.
    3. Pada halaman IoT Edge, temukan dan pilih IoT Edge tempat modul SQL Edge digunakan.
    4. Pada halaman perangkatPerangkat Edge IoT, pilih Atur Modul.
    5. Pada halaman Atur modul , dan pilih modul Azure SQL Edge.
    6. Pada panel Perbarui Modul Edge IoT, pilih Variabel Lingkungan. Tambahkan variabel MSSQL_PACKAGE lingkungan dan tentukan URL SAS yang dihasilkan pada Langkah 3 di atas sebagai nilai untuk variabel lingkungan.
    7. Pilih Perbarui.
    8. Pada halaman Atur modul, pilih Tinjau + buat.
    9. Pada halaman Atur modul, pilih Buat.
  5. Setelah pembaruan modul, file paket diunduh, di-unzip, dan diterapkan terhadap instance SQL Edge.

Pada setiap restart, kontainer Azure SQL Edge, SQL Edge mencoba mengunduh paket file zip dan mengevaluasi perubahan. Jika versi baru file DACPAC ditemui, perubahan disebarkan ke database di SQL Edge.

Masalah yang diketahui

Selama beberapa penyebaran DACPAC atau BACPAC, pengguna mungkin mengalami batas waktu perintah, yang mengakibatkan kegagalan operasi penyebaran DACPAC. Jika Anda mengalami masalah ini, gunakan SQLPackage.exe (atau Alat Klien SQL) untuk menerapkan DACPAC atau BACPAC secara manual.