Pemecahan Masalah Manajemen Integration Runtime SSIS

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

Tip

Data Factory di Microsoft Fabric adalah generasi Azure Data Factory berikutnya, dengan arsitektur yang lebih sederhana, AI bawaan, dan fitur baru. Jika Anda baru menggunakan integrasi data, mulailah dengan Fabric Data Factory. Beban kerja ADF yang ada dapat ditingkatkan ke Fabric untuk mengakses kemampuan baru di seluruh ilmu data, analitik real time, dan pelaporan.

• Mulai uji coba gratis Fabric.
• Mutakhirkan dari Azure Data Factory ke Data Factory di Microsoft Fabric

Artikel ini menyediakan panduan pemecahan masalah untuk masalah manajemen di Azure-Layanan Integrasi SQL Server (SSIS) Integration Runtime (IR), juga dikenal sebagai SSIS IR.

Gambaran Umum

Jika Anda mengalami masalah saat menyediakan atau membatalkan penyediaan runtime integrasi SSIS, Anda akan melihat pesan kesalahan di portal Microsoft Azure Data Factory atau kesalahan yang dikembalikan dari cmdlet PowerShell. Kesalahan selalu muncul dalam format kode kesalahan dengan pesan kesalahan terperinci.

Jika kode kesalahan adalah InternalServerError, layanan memiliki masalah sementara, dan Anda harus mencoba kembali operasi nanti. Jika coba lagi tidak membantu, hubungi tim dukungan Azure Data Factory.

Jika tidak, tiga dependensi eksternal utama dapat menyebabkan kesalahan: Azure SQL Database atau Azure SQL Managed Instance, skrip penyiapan kustom, dan konfigurasi jaringan virtual.

Masalah SQL Database atau SQL Managed Instance

SQL Database atau SQL Managed Instance diperlukan jika Anda menyediakan SSIS IR dengan database katalog SSIS. SSIS IR harus dapat mengakses SQL Database atau SQL Managed Instance. Selain itu, akun masuk untuk SQL Database atau SQL Managed Instance harus memiliki izin untuk membuat database katalog SSIS (SSISDB). Jika ada kesalahan, kode galat dengan pesan pengecualian SQL terperinci akan ditampilkan dalam portal Azure Data Factory. Gunakan informasi dalam daftar berikut untuk memecahkan masalah kode kesalahan.

AzureSqlConnectionFailure

Anda mungkin melihat masalah ini saat Anda menyediakan runtime integrasi SSIS baru atau saat runtime integrasi IR berjalan. Jika Anda mengalami kesalahan ini selama penyediaan IR, Anda mungkin mendapatkan pesan kesalahan SqlException terperinci yang menunjukkan salah satu dari masalah berikut:

• Masalah koneksi jaringan. Periksa apakah nama host untuk SQL Database atau SQL Managed Instance dapat diakses. Verifikasi juga bahwa tidak ada firewall atau kelompok keamanan jaringan (NSG) yang memblokir akses SSIS IR ke server.
• Masuk gagal selama autentikasi SQL. Akun yang disediakan tidak bisa masuk ke database Microsoft SQL Server. Pastikan Anda memberikan akun pengguna yang benar.
• Masuk gagal selama autentikasi ID Microsoft Entra (identitas terkelola). Tambahkan identitas terkelola pabrik Anda ke grup Microsoft Entra, dan pastikan identitas terkelola memiliki izin akses ke server database katalog Anda.
• Batas waktu koneksi. Kesalahan ini selalu disebabkan oleh konfigurasi terkait keamanan. Kami menyarankan agar Anda:
  1. Buat komputer virtual baru.
  2. Gabungkan VM ke jaringan virtual Microsoft Azure yang sama dengan IR jika IR berada dalam jaringan virtual.
  3. Instal SQL Server Management Studio dan periksa SQL Database atau status SQL Managed Instance.

Untuk masalah lain, perbaiki masalah yang ditunjukkan dalam pesan kesalahan SQL Exception yang terperinci. Jika Anda masih mengalami masalah, hubungi SQL Database atau tim dukungan SQL Managed Instance.

Jika Anda melihat kesalahan saat IR berjalan, perubahan grup keamanan jaringan atau firewall kemungkinan mencegah simpul pekerja SSIS IR mengakses SQL Database atau SQL Managed Instance. Buka blokir simpul pekerja SSIS IR sehingga dapat mengakses SQL Database atau SQL Managed Instance.

CatalogCapacityLimitError

Berikut adalah pesan kesalahan yang mungkin muncul: “Database 'SSISDB' telah mencapai kuota ukurannya. Partisi atau hapus data, hilangkan indeks, atau lihat dokumentasi untuk kemungkinan resolusi”.

Solusi yang mungkin dilakukan:

• Tingkatkan ukuran kuota SSISDB Anda.
• Ubah konfigurasi SSISDB untuk mengurangi ukuran dengan:
  • Mengurangi periode retensi serta jumlah versi proyek.
  • Mengurangi periode retensi dari log.
  • Mengubah tingkat default dari log.

DatabaseKatalogMilikKePihakLainIR

Kesalahan ini berarti SQL Database atau SQL Managed Instance sudah memiliki SSISDB dan sedang digunakan oleh IR lain. Anda harus menyediakan SQL Database atau SQL Managed Instance yang berbeda atau menghapus SSISDB yang ada dan hidupkan ulang IR baru.

KegagalanPembuatanKatalogDb

Kesalahan ini dapat terjadi karena salah satu alasan berikut:

• Akun pengguna yang dikonfigurasi untuk runtime integrasi SSIS tidak memiliki izin untuk membuat database. Anda dapat memberikan izin kepada pengguna untuk membuat database.
• Timeout terjadi selama pembuatan database, seperti timeout eksekusi atau timeout operasi database. Anda harus mencoba lagi operasi nanti. Jika percobaan kembali tidak berhasil, hubungi tim dukungan SQL Database atau SQL Managed Instance.

Untuk masalah lain, periksa pesan kesalahan Pengecualian SQL dan perbaiki masalah yang disebutkan dalam detail kesalahan. Jika Anda masih mengalami masalah, hubungi SQL Database atau tim dukungan SQL Managed Instance.

InvalidCatalogDb

Pesan kesalahan semacam ini terlihat seperti berikut: "Nama objek tidak valid 'catalog.catalog_properties'." Dalam situasi ini, Anda mungkin sudah memiliki database bernama SSISDB tetapi tidak dibuat oleh SSIS IR, atau database dalam keadaan tidak valid yang disebabkan oleh kesalahan dalam provisi SSIS IR terakhir. Anda dapat menghapus database yang ada dengan nama SSISDB, atau Anda dapat mengonfigurasi SQL Database baru atau SQL Managed Instance untuk IR.

Masalah penyetelan kustom

Penyiapan kustom menyediakan antarmuka untuk menambahkan langkah-langkah Anda sendiri selama penyediaan atau konfigurasi ulang SSIS IR. Untuk informasi selengkapnya, lihat Menyesuaikan penyetelan untuk Azure-SSIS Integration Runtime.

Pastikan kontainer Anda hanya berisi file penyetelan kustom yang diperlukan; semua file dalam kontainer akan diunduh ke simpul pekerja SSIS IR. Kami menyarankan agar Anda menguji skrip penyiapan kustom pada komputer lokal untuk memperbaiki masalah eksekusi skrip apa pun sebelum Anda menjalankan skrip di SSIS IR.

Kontainer skrip penyiapan kustom diperiksa saat runtime integrasi berjalan, karena runtime integrasi SSIS diperbarui secara berkala. Pembaruan ini memerlukan akses ke kontainer untuk mengunduh skrip penyetelan kustom dan menginstalnya lagi. Proses ini juga memeriksa apakah kontainer dapat diakses dan apakah file main.cmd tersedia.

Untuk kesalahan apa pun yang melibatkan penyiapan kustom, Anda akan melihat kode kesalahan CustomSetupScriptFailure dengan sub kode seperti CustomSetupScriptBlobContainerInaccessible atau CustomSetupScriptNotFound.

CustomSetupScriptBlobContainerTidakDapatDiakses

Kesalahan ini berarti bahwa SSIS IR tidak dapat mengakses kontainer blob Azure Anda untuk penyiapan kustom. Pastikan URI SAS kontainer dapat dijangkau dan belum kedaluwarsa.

Hentikan IR jika berjalan, konfigurasi ulang IR dengan SAS URI kontainer penyiapan kustom baru, lalu hidupkan ulang IR.

SkripPengaturanKhususTidakDitemukan

Kesalahan ini berarti bahwa SSIS IR tidak dapat menemukan skrip penyiapan kustom (main.cmd) di kontainer blob Anda. Pastikan main.cmd tersedia di kontainer, yang merupakan titik masuk untuk instalasi penyiapan kustom.

CustomSetupScriptExecutionFailure

Kesalahan ini berarti eksekusi skrip penyiapan kustom (main.cmd) gagal. Coba skrip pada komputer lokal Anda terlebih dahulu, atau periksa log eksekusi penyiapan kustom pada kontainer blob Anda.

CustomSetupScriptTimeout

Kesalahan ini mengindikasikan batas waktu eksekusi skrip penyiapan kustom. Pastikan skrip Anda dapat dieksekusi diam-diam, dan tidak perlu input interaktif, dan pastikan kontainer blob Anda hanya berisi file penyiapan kustom yang diperlukan. Disarankan untuk menguji skrip pada komputer lokal terlebih dahulu. Anda juga harus memeriksa log eksekusi penyiapan kustom di kontainer blob Anda. Periode maksimum untuk penyiapan kustom adalah 45 menit sebelum waktu habis, dan periode maksimum mencakup waktu untuk mengunduh semua file dari kontainer Anda dan menginstalnya di SSIS IR. Jika Anda membutuhkan periode yang lebih lama, ajukan tiket dukungan.

CustomSetupScriptLogUploadFailure

Kesalahan ini berarti bahwa upaya untuk mengunggah log eksekusi penyiapan kustom ke kontainer blob Anda gagal. Masalah ini terjadi karena SSIS IR tidak memiliki izin tulis ke kontainer blob Anda atau karena masalah penyimpanan atau jaringan. Jika penyiapan kustom berhasil, kesalahan ini tidak akan memengaruhi fungsi SSIS apa pun, tetapi log akan hilang. Jika penyiapan kustom gagal dengan kesalahan lain, dan log tidak diunggah, kami akan melaporkan kesalahan ini terlebih dahulu sehingga log dapat diunggah untuk analisis. Selain itu, setelah masalah ini diselesaikan, kami akan melaporkan masalah yang lebih spesifik. Jika masalah ini tidak diselesaikan setelah coba lagi, hubungi tim dukungan Azure Data Factory.

Konfigurasi jaringan virtual

Saat Anda menggabungkan SSIS IR dengan Microsoft Azure Virtual Network, SSIS IR menggunakan jaringan virtual yang berada dalam langganan pengguna. Untuk informasi selengkapnya, lihat Menggabungkan Azure-SSIS Integration Runtime dengan jaringan virtual. Setelah SSIS IR berhasil dimulai, jika Anda mengalami masalah koneksi jaringan, Anda dapat mencoba menggunakan alat konektivitas diagnosis untuk mendiagnosis masalahnya sendiri. Jika terjadi masalah terkait Virtual Network, Anda akan melihat salah satu kesalahan berikut.

KonfigurasiVNetTidakValid

Kesalahan ini dapat terjadi karena berbagai alasan. Untuk memecahkannya, lihat bagian Terlarang, InvalidPropertyValue, dan MisconfiguredDnsServerOrNsgSettings.

Terlarang

Kesalahan semacam ini mungkin menyerupai ini: SubnetId is not enabled for current account. Microsoft.Batch resource provider is not registered under the same subscription of VNet.

Detail ini berarti bahwa Azure Batch tidak dapat mengakses jaringan virtual Anda. Daftarkan penyedia sumber daya Microsoft.Batch dalam langganan yang sama dengan Virtual Network.

NilaiPropertiTidakValid

Kesalahan ini mungkin menyerupai salah satu hal berikut:

• "VNet yang ditentukan tidak ada, atau layanan Batch tidak memiliki akses ke VNet tersebut."
• "Subnet xxx yang ditentukan tidak ada."

Kesalahan tersebut berarti bahwa jaringan virtual tidak ada, layanan Azure Batch tidak dapat mengaksesnya, atau subnet yang disediakan tidak ada. Pastikan jaringan virtual dan subnet ada dan Azure Batch dapat mengaksesnya.

KesalahanKonfigurasiServerDNSatauPengaturanNSG

Pesan kesalahan semacam ini terlihat seperti ini: “Gagal menyediakan Integration Runtime di VNet. Jika setelan server DNS atau NSG dikonfigurasi, pastikan server DNS dapat diakses dan NSG dikonfigurasi dengan benar”.

Dalam situasi ini, Anda mungkin memiliki konfigurasi kustom di server DNS atau setelan NSG, yang menyebabkan nama server Azure yang diperlukan oleh SSIS IR tidak dapat diselesaikan atau diakses. Untuk informasi selengkapnya, lihat konfigurasi SSIS IR Virtual Network. Jika Anda masih mengalami masalah, hubungi tim dukungan Azure Data Factory.

VNetResourceGroupDikunciSelamaPembaruan

SSIS IR akan diperbarui secara otomatis dan teratur. Kumpulan Azure Batch baru dibuat selama peningkatan dan kumpulan Azure Batch lama dihapus. Selain itu, sumber daya terkait Virtual Network untuk kumpulan lama akan dihapus, dan sumber daya terkait Virtual Network baru akan dibuat dalam langganan Anda. Kesalahan ini berarti bahwa penghapusan sumber daya terkait Virtual Network untuk kumpulan lama gagal dikarenakan kunci penghapusan pada tingkat grup sumber daya atau langganan. Karena pelanggan mengontrol dan menyetel kunci penghapusan, mereka harus menghapus kunci penghapusan dalam situasi ini.

VNetResourceGroupDikunciSelamaMulai

Jika provisi SSIS IR gagal, semua sumber daya yang telah dibuat akan dihapus. Namun, jika ada kunci penghapusan sumber daya di tingkat langganan atau grup sumber daya, sumber daya Virtual Network tidak dihapus seperti yang diharapkan. Untuk memperbaiki kesalahan ini, hapus kunci penghapusan dan hidupkan ulang IR.

VNetResourceGroupLockedDuringStop/VNetDeleteLock

Jika Anda menghentikan SSIS IR, semua sumber daya yang terkait dengan Virtual Network akan dihapus. Namun, penghapusan bisa gagal jika ada kunci penghapusan sumber daya di tingkat grup sumber daya atau langganan. Selain itu, pelanggan mengontrol dan menyetel kunci penghapusan. Oleh karena itu, mereka harus menghapus kunci penghapusan dan kemudian menghentikan SSIS IR lagi.

Node Tidak Tersedia

Kesalahan ini terjadi saat IR berjalan, dan berarti bahwa kondisi IR tidak baik. Kesalahan ini selalu disebabkan oleh perubahan server DNS atau konfigurasi NSG yang mencegah SSIS IR terhubung ke layanan yang diperlukan. Karena konfigurasi server DNS dan NSG dikontrol oleh pelanggan, pelanggan harus memperbaiki masalah pemblokiran sendiri. Untuk informasi selengkapnya, lihat konfigurasi SSIS IR Virtual Network. Jika Anda masih mengalami masalah, hubungi tim dukungan Azure Data Factory.

Konfigurasi alamat IP publik statis

Saat Anda menggabungkan IR Azure-SSIS ke Microsoft Azure Virtual Network, Anda dapat membawa alamat IP publik statis Anda sendiri untuk IR sehingga IR dapat mengakses sumber data, yang membatasi akses pada alamat IP tertentu. Untuk informasi selengkapnya, lihat Menggabungkan Azure-SSIS Integration Runtime dengan jaringan virtual.

Selain masalah jaringan virtual di atas, Anda juga dapat memenuhi masalah terkait alamat IP publik statis. Untuk mendapatkan bantuan, silakan periksa kesalahan berikut.

AlamatIPPublikTidakValidDitentukan

Kesalahan ini dapat terjadi karena berbagai alasan saat Anda memulai runtime integrasi Azure-SSIS:

Pesan kesalahan	Solusi
Alamat IP publik statis yang disediakan sudah digunakan, sediakan dua alamat IP publik yang tidak digunakan untuk Azure-SSIS Integration Runtime Anda.	Anda harus memilih dua alamat IP publik statis yang tidak digunakan atau menghapus referensi saat ini ke alamat IP publik yang ditentukan, lalu hidupkan ulang Azure-SSIS IR.
Alamat IP publik statis yang disediakan tidak memiliki nama DNS, berikan dua di antaranya dengan nama DNS untuk Integration Runtime Azure-SSIS Anda.	Anda bisa menyiapkan nama DNS alamat IP publik di portal Microsoft Azure, seperti yang ditunjukkan gambar di bawah ini. Langkah-langkah spesifiknya adalah sebagai berikut: (1) Buka portal Microsoft Azure dan dapatkan halaman sumber daya alamat IP publik ini; (2) Pilih bagian Konfigurasi dan siapkan nama DNS, lalu pilih tombol Simpan ; (3) Hidupkan ulang runtime integrasi Azure-SSIS Anda.
VNet yang disediakan dan alamat IP publik statis untuk Azure-SSIS Integration Runtime Anda harus berada di lokasi yang sama.	Menurut persyaratan Azure Network, alamat IP publik statis dan jaringan virtual harus berada di lokasi dan langganan yang sama. Berikan dua alamat IP publik statis yang valid dan mulai ulang runtime integrasi Azure-SSIS.
Alamat IP publik statis yang disediakan adalah yang dasar, menyediakan dua alamat standar untuk Integration Runtime Azure-SSIS Anda.	Lihat SKU Alamat IP Publik untuk mendapatkan bantuan.

PublicIPResourceGroupLockedDuringStart

Jika provisi Azure-SSIS IR gagal, semua sumber daya yang dibuat akan dihapus. Namun, jika ada kunci penghapusan sumber daya di tingkat langganan atau grup sumber daya (yang berisi alamat IP publik statis Anda), sumber daya jaringan tidak dihapus seperti yang diharapkan. Untuk memperbaiki kesalahan, hapus kunci yang dihapus dan mulai ulang IR.

KelompokSumberDayaIPPublikTerkunciSaatBerhenti

Saat Anda menghentikan Azure-SSIS IR, semua sumber daya jaringan yang dibuat di grup sumber daya yang berisi alamat IP publik Anda akan dihapus. Tetapi penghapusan dapat gagal jika ada kunci penghapusan sumber daya di tingkat langganan atau grup sumber daya (yang berisi alamat IP publik statis Anda). Menghapus kunci penghapusan dan menghidupkan ulang IR.

GrupSumberDayaIPPublikTerkunciSelamaPeningkatan

Azure-SSIS IR diperbarui secara otomatis secara berkala. Simpul IR baru dibuat selama peningkatan dan simpul lama akan dihapus. Selain itu, sumber daya jaringan yang dibuat (misalnya, load balancer dan grup keamanan jaringan) untuk simpul lama dihapus, dan sumber daya jaringan baru dibuat di bawah langganan Anda. Kesalahan ini berarti bahwa penghapusan sumber daya jaringan dari simpul lama gagal karena penguncian penghapusan pada tingkat langganan atau grup sumber daya (yang mencakup alamat IP publik statis Anda). Hapus kunci penghapusan sehingga kami dapat membersihkan node lama dan melepaskan alamat IP publik statis untuk node lama. Jika tidak, alamat IP publik statis tidak dapat dirilis dan kami tidak akan dapat meningkatkan IR Anda lebih lanjut.

IPPublikTidakDapatDigunakanSaatPeningkatan

Ketika Anda ingin membawa alamat IP publik statis Anda sendiri, dua alamat IP publik harus disediakan. Salah satunya akan digunakan untuk membuat simpul IR segera dan satu lagi akan digunakan selama peningkatan IR. Kesalahan ini dapat terjadi ketika alamat IP publik lainnya tidak dapat digunakan selama pemutakhiran. Lihat InvalidPublicIPSpecified untuk kemungkinan penyebabnya.

Manajemen sumber daya

Tag sumber daya tidak diperbarui

Anda dapat menerapkan tag ke sumber daya Azure untuk mengaturnya secara logis ke dalam taksonomi. Saat runtime integrasi SSIS berjalan, perubahan pada tag pabrik data induk SSIS IR tidak akan berlaku hingga runtime integrasi SSIS dimulai ulang.