Pemecahan masalah Manajemen Runtime Integrasi SSIS

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

Tip

Cobalah Data Factory di Microsoft Fabric, solusi analitik all-in-one untuk perusahaan. Microsoft Fabric mencakup semuanya mulai dari pergerakan data hingga ilmu data, analitik real time, kecerdasan bisnis, dan pelaporan. Pelajari cara memulai uji coba baru secara gratis!

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

Gambaran Umum

Jika Anda mengalami masalah saat menyediakan atau mendeprovisi SSIS IR, 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 login 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 provisi runtime integrasi SSIS baru atau saat runtime integrasi berjalan. Jika Anda mengalami kesalahan ini selama provisi IR, Anda mungkin mendapatkan pesan SqlException terperinci dalam pesan kesalahan yang menunjukkan salah satu 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 runtime integrasi SSIS ke server.
• Gagal login selama autentikasi SQL. Akun yang disediakan tidak bisa masuk ke database Microsoft SQL Server. Pastikan Anda memberikan akun pengguna yang benar.
• Login 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 komputer virtual ke runtime integrasi Microsoft Azure Virtual Network yang sama jika runtime integrasi 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 Pengecualian SQL 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.

CatalogDbBelongsToAnotherIR

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.

CatalogDbCreationFailure

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.
• Waktu habis ketika membuat database, seperti waktu eksekusi atau waktu operasi DB habis. 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 penyiapan Anda sendiri selama provisi atau konfigurasi ulang SSIS IR Anda. 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 akan diperiksa saat IR sedang berjalan, karena SSIS IR 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.

CustomSetupScriptBlobContainerInaccessible

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

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

CustomSetupScriptNotFound

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 waktu habis 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 agar log dapat diunggah untuk analisis. Selain itu, setelah masalah ini diselesaikan, kami akan melaporkan masalah yang lebih spesifik. Jika masalah ini tidak diselesaikan setelah percobaan kembali, hubungi tim dukungan Azure Data Factory.

Konfigurasi jaringan virtual

Saat Anda menggabungkan SSIS IR dengan 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.

InvalidVnetConfiguration

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

Terlarang

Kesalahan ini mungkin menyerupai ini: “SubnetId tidak diaktifkan untuk akun saat ini. Penyedia sumber Microsoft.Batch tidak terdaftar di dalam langganan VNet yang sama."

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

InvalidPropertyValue

Kesalahan ini mungkin menyerupai salah satu hal berikut:

• "VNet yang ditentukan tidak ada atau layanan Batch tidak dapat mengaksesnya."
• "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.

MisconfiguredDnsServerOrNsgSettings

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.

VNetResourceGroupLockedDuringUpgrade

SSIS IR akan otomatis diperbarui secara berkala. 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.

VNetResourceGroupLockedDuringStart

Jika provisi SSIS IR gagal, semua sumber daya yang telah dibuat akan dihapus. Namun, jika ada kunci penghapusan sumber daya di tingkat grup sumber daya atau langganan, sumber daya Virtual Network tidak akan 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.

NodeUnavailable

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 bergabung dengan Azure-SSIS IR ke Azure Virtual Network, Anda juga dapat membawa alamat IP publik statis Anda sendiri untuk IR sehingga IR dapat mengakses sumber data yang membatasi akses ke 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. Periksalah kesalahan berikut ini untuk mendapatkan bantuan.

InvalidPublicIPSpecified

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

Pesan kesalahan	Solusi
Alamat IP publik statis yang disediakan sudah digunakan, harap sediakan dua alamat 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, harap sediakan dua di antaranya dengan nama DNS untuk Azure-SSIS Integration Runtime Anda.	Anda bisa menyetel nama DNS alamat IP publik di portal Microsoft Azure, seperti yang ditunjukkan gambar di bawah ini. Langkah-langkah tertentu adalah sebagai berikut: (1) Buka portal Microsoft Azure dan pergi ke halaman sumber daya alamat IP publik ini; (2) Pilih bagian Konfigurasi dan siapkan nama DNS, lalu klik tombol Simpan; (3) Hidupkan ulang Azure-SSIS IR 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. Harap sediakan dua alamat IP publik statis yang valid dan hidupkan ulang Azure-SSIS IR.
Alamat IP publik statis yang disediakan adalah yang dasar, harap sediakan dua alamat standar untuk Azure-SSIS Integration Runtime 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, silakan hapus kunci penghapusan dan hidupkan ulang IR.

PublicIPResourceGroupLockedDuringStop

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.

PublicIPResourceGroupLockedDuringUpgrade

Azure-SSIS IR secara otomatis diperbarui secara berkala. Simpul IR baru dibuat selama peningkatan dan simpul lama akan dihapus. Selain itu, sumber daya jaringan yang dibuat (misalnya, penyeimbang muatan dan grup keamanan jaringan) untuk simpul lama dihapus, dan sumber daya jaringan baru dibuat di bawah langganan Anda. Kesalahan ini berarti bahwa menghapus sumber daya jaringan untuk simpul lama gagal karena kunci penghapusan pada tingkat langganan atau grup sumber daya (yang berisi 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.

PublicIPNotUsableDuringUpgrade

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 IR SSIS berjalan, perubahan pada tag pabrik data induk IR SSIS tidak akan berlaku hingga IR SSIS dihidupkan ulang.