SSIS Integration Runtime yönetimi sorunlarını giderme

UYGULANANLAR: Azure Data Factory Azure Synapse Analytics

İpucu

Kuruluşlar için hepsi bir arada analiz çözümü olan Microsoft Fabric'te Data Factory'yi deneyin. Microsoft Fabric , veri taşımadan veri bilimine, gerçek zamanlı analize, iş zekasına ve raporlamaya kadar her şeyi kapsar. Yeni bir deneme sürümünü ücretsiz olarak başlatmayı öğrenin!

Bu makalede, SSIS IR olarak da bilinen Azure-SQL Server Integration Services (SSIS) Integration Runtime (IR) içindeki yönetim sorunları için sorun giderme yönergeleri sağlanır.

Genel bakış

SSIS IR'yi sağlarken veya sağlamasını kaldırırken herhangi bir sorunla karşılaşırsanız, Microsoft Azure Data Factory portalında bir hata iletisi veya PowerShell cmdlet'inden döndürülen bir hata görürsünüz. Hata her zaman ayrıntılı bir hata iletisiyle bir hata kodu biçiminde görüntülenir.

Hata kodu InternalServerError ise, hizmetin geçici sorunları vardır ve işlemi daha sonra yeniden denemeniz gerekir. Yeniden deneme işe yaramazsa Azure Data Factory destek ekibine başvurun.

Aksi takdirde, üç ana dış bağımlılık hatalara neden olabilir: Azure SQL Veritabanı veya Azure SQL Yönetilen Örneği, özel kurulum betiği ve sanal ağ yapılandırması.

SQL Veritabanı veya SQL Yönetilen Örneği sorunları

SSIS IR'yi bir SSIS katalog veritabanıyla hazırlarsanız SQL Veritabanı veya SQL Yönetilen Örneği gereklidir. SSIS IR'nin SQL Veritabanı veya SQL Yönetilen Örneği erişebilmesi gerekir. Ayrıca, SQL Veritabanı veya SQL Yönetilen Örneği oturum açma hesabının SSIS katalog veritabanı (SSISDB) oluşturma izni olmalıdır. Hata varsa, ayrıntılı SQL özel durum iletisiyle hata kodu Data Factory portalında gösterilir. Hata kodlarındaki sorunları gidermek için aşağıdaki listede yer alan bilgileri kullanın.

AzureSqlConnectionFailure

Yeni SSIS IR sağlarken veya IR çalıştırılırken bu hatayı görebilirsiniz. IR sağlama sırasında bu hatayla karşılaşırsanız hata iletisinde aşağıdaki sorunlardan birine işaret eden ayrıntılı bir hata alabilirsiniz:

• Ağ bağlantısı sorunu. SQL Veritabanı veya SQL Yönetilen Örneği için ana bilgisayar adının erişilebilir olup olmadığını denetleyin. Ayrıca hiçbir güvenlik duvarı veya ağ güvenlik grubunun (NSG) SSIS IR'nin sunucuya erişimini engellemediğini doğrulayın.
• SQL kimlik doğrulaması sırasında oturum açma başarısız oldu. Sağlanan hesap SQL Server veritabanında oturum açamıyor. Doğru kullanıcı hesabını sağladığınızdan emin olun.
• Microsoft Entra Id kimlik doğrulaması (yönetilen kimlik) sırasında oturum açılamadı. Fabrikanızın yönetilen kimliğini bir Microsoft Entra grubuna ekleyin ve yönetilen kimliğin katalog veritabanı sunucunuza erişim izinlerine sahip olduğundan emin olun.
• Bağlantı zaman aşımı. Bu hatanın nedeni her zaman güvenlikle ilgili yapılandırmadır. Şunu yapmanızı öneririz:
  1. Yeni bir VM oluşturun.
  2. IR bir sanal ağdaysa VM'yi IR'nin aynı Microsoft Azure Sanal Ağ ekleyin.
  3. SSMS'yi yükleyin ve SQL Veritabanı veya SQL Yönetilen Örneği durumunu denetleyin.

Diğer sorunlar için, ayrıntılı SQL Özel Durum hata iletisinde gösterilen sorunu çözün. Sorun yaşamaya devam ediyorsanız SQL Veritabanı veya SQL Yönetilen Örneği destek ekibine başvurun.

IR çalışırken hatayı görürseniz, ağ güvenlik grubu veya güvenlik duvarı değişiklikleri büyük olasılıkla SSIS IR çalışan düğümlerinin SQL Veritabanı veya SQL Yönetilen Örneği erişmesini engelliyordur. SQL Veritabanı veya SQL Yönetilen Örneği erişebilmesi için SSIS IR çalışan düğümünü engellemesini kaldırın.

CatalogCapacityLimitError

Bu tür bir hata iletisi şöyle görünebilir: "'SSISDB' veritabanı boyut kotasına ulaştı. Verileri bölümleyin veya silin, dizinleri bırakın veya olası çözümler için belgelere bakın."

Olası çözümler şunlardır:

• SSISDB'nizin kota boyutunu artırın.
• Boyutu küçültmek için SSISDB yapılandırmasını değiştirin:
  • Bekletme süresini ve proje sürümlerinin sayısını azaltma.
  • Günlüğün saklama süresini azaltma.
  • Günlüğün varsayılan düzeyini değiştirme.

CatalogDbBelongsToAnotherIR

Bu hata, SQL Veritabanı veya SQL Yönetilen Örneği zaten bir SSISDB'ye sahip olduğu ve başka bir IR tarafından kullanıldığı anlamına gelir. Farklı bir SQL Veritabanı veya SQL Yönetilen Örneği sağlamanız ya da mevcut SSISDB'yi silip yeni IR'yi yeniden başlatmanız gerekir.

CatalogDbCreationFailure

Bu hatanın oluşmasının nedeni aşağıdakilerden biri olabilir:

• SSIS IR için yapılandırılan kullanıcı hesabının veritabanı oluşturma izni yoktur. Kullanıcıya veritabanını oluşturma izni verebilirsiniz.
• Veritabanı oluşturma sırasında yürütme zaman aşımı veya DB işlemi zaman aşımı gibi bir zaman aşımı oluşmuştur. İşlemi daha sonra yeniden denemelisiniz. Yeniden deneme işe yaramazsa SQL Veritabanı veya SQL Yönetilen Örneği destek ekibine başvurun.

Diğer sorunlar için SQL Özel Durumu hata iletisini gözden geçirin ve hata ayrıntılarında belirtilen sorunu çözün. Sorun yaşamaya devam ediyorsanız SQL Veritabanı veya SQL Yönetilen Örneği destek ekibine başvurun.

InvalidCatalogDb

Bu tür bir hata iletisi şöyle görünür: "Geçersiz nesne adı 'catalog.catalog_properties'." Bu durumda, zaten SSISDB adlı bir veritabanınız var ama SSIS IR tarafından oluşturulmadı veya veritabanı son SSIS IR sağlamadaki hatalardan kaynaklanan geçersiz bir durumda. Mevcut veritabanını SSISDB adıyla bırakabilir veya IR için yeni bir SQL Veritabanı veya SQL Yönetilen Örneği yapılandırabilirsiniz.

Özel kurulum sorunları

SSIS IR'nizin sağlanması veya yeniden yapılandırılması sırasında özel kurulum kendi kurulum adımlarınızı eklemeniz için bir arabirim sağlar. Daha fazla bilgi için bkz. Azure-SSIS Integration Runtime için kurulumu özelleştirme.

Kapsayıcınızın yalnızca gerekli kurulum dosyalarını içerdiğinden emin olun; kapsayıcıdaki tüm dosyalar SSIS IR çalışan düğümüne indirilecektir. Özel kurulum betiğini SSIS IR'de çalıştırmadan önce betik yürütme sorunlarını çözmek için betiği yerel makinede test etmenizi öneririz.

Özel kurulum betiği kapsayıcısı IR çalıştırılırken denetlenir çünkü SSIS IR düzenli aralıklarla güncelleştirilir. Bu güncelleştirme, özel kurulum betiğini indirmek ve yeniden yüklemek için kapsayıcıya erişim gerektirir. İşlemde kapsayıcının erişilebilir ve main.cmd dosyasının mevcut olup olmadığı da denetlenir.

Özel kurulum gerektiren herhangi bir hata için CustomSetupScriptBlobContainerInaccessible veya CustomSetupScriptNotFound gibi alt koda sahip bir CustomSetupScriptFailure hata kodu görürsünüz.

CustomSetupScriptBlobContainerInaccessible

Bu hata SSIS IR'nin özel kurulum için Azure blob kapsayıcınıza erişemediği anlamına gelir. Kapsayıcının SAS URI'sinin ulaşılabilir olduğundan ve süresinin dolmadığından emin olun.

Çalışıyorsa IR'yi durdurun, IR'yi yeni özel kurulum kapsayıcısı SAS URI değeriyle yeniden yapılandırın ve sonra yeniden başlatın.

CustomSetupScriptNotFound

Bu hata SSIS IR'nin blob kapsayıcınızda özel kurulum betiğini (main.cmd) bulamadığı anlamına gelir. Kapsayıcıda, özel kurulum yüklemesinin giriş noktası olan main.cmd dosyasının mevcut olduğundan emin olun.

CustomSetupScriptExecutionFailure

Bu hata özel kurulum betiğinin (main.cmd) yürütülemediği anlamına gelir. Betiği önce yerel makinenizde deneyin veya blob kapsayıcınızda özel kurulum yürütme günlüklerini gözden geçirin.

CustomSetupScriptTimeout

Bu hata özel kurulum betiğinin zaman aşımına uğradığını gösterir. Betiğinizin sessiz yürütülebildiğinden, etkileşimli giriş gerektirmediğinden ve blob kapsayıcınızda yalnızca gerekli özel kurulum dosyalarının bulunduğundan emin olun. Betiği öncelikle yerel makinede test etmeniz önerilir. Blob kapsayıcınızda özel kurulum yürütme günlüklerini gözden geçirmelisiniz. Özel kurulum için zaman aşımına uğramadan verilen maksimum süre 45 dakikadır ve maksimum süre kapsayıcınızdan tüm dosyaları indirme ve bunları SSIS IR'ye yükleme süresini içerir. Daha uzun süreye ihtiyacınız olursa bir destek bileti oluşturun.

CustomSetupScriptLogUploadFailure

Bu hata özel kurulum yürütme günlüklerini blob kapsayıcınıza yükleme girişiminin başarısız olduğu anlamına gelir. Bu sorun SSIS IR'nin blob kapsayıcınıza yazma izinleri olmadığı için ya da depolama veya ağ sorunlarından dolayı oluşabilir. Özel kurulum başarılı olursa bu hata hiçbir SSIS işlevini etkilemez ama günlükler eksik olur. Özel kurulum başka bir hatayla başarısız olursa ve günlük yüklenmezse, günlüğün karşıya yüklenip analizde kullanılabilmesi için önce bu hatayı bildiririz. Aynı zamanda, bu sorun çözüldükten sonra diğer belirli sorunları da bildiririz. Yeniden deneme sonrasında bu sorun çözülmezse Azure Data Factory destek takımına başvurun.

Sanal ağ yapılandırması

SSIS IR'yi Azure Sanal Ağıyla birleştirdiğinizde, SSIS IR kullanıcı aboneliği altındaki sanal ağı kullanır. Daha fazla bilgi için bkz. Azure-SSIS Integration Runtime'ı sanal ağa ekleme. SSIS IR başarıyla başlatıldıktan sonra ağ bağlantısı sorunlarıyla karşılaşırsanız sorunu kendiniz tanılamak için bağlantı tanılama aracını kullanmayı deneyebilirsiniz. Sanal Ağ ile ilgili bir sorun olduğunda aşağıdaki hatalardan birini görürsünüz.

InvalidVnetConfiguration

Bu hata çeşitli nedenlerle oluşabilir. Sorunu gidermek için Yasak, InvalidPropertyValue ve MisconfiguredDnsServerOrNsgSettings bölümlerine bakın.

Yasak

Bu tür bir hata şuna benzeyebilir: "SubnetId geçerli hesap için etkinleştirilmedi. Microsoft.Batch kaynak sağlayıcısı aynı sanal ağ aboneliği altında kayıtlı değil."

Bu ayrıntılar Azure Batch'in sanal ağınıza erişemediği anlamına gelir. Microsoft.Batch kaynak sağlayıcısını Sanal Ağ ile aynı aboneliğe kaydedin.

InvalidPropertyValue

Bu tür bir hata aşağıdakilerden birine benzer olabilir:

• "Belirtilen sanal ağ yok veya Batch hizmetinin buna erişimi yok."
• "Belirtilen xxx alt ağı yok."

Bu hatalar sanal ağın var olmadığı, Azure Batch hizmetinin bu sanal ağa erişemediği veya sağlanan alt ağın var olmadığı anlamına gelir. Sanal ağ ile alt ağın var olduğundan ve Azure Batch'in bunlara erişebildiğinden emin olun.

MisconfiguredDnsServerOrNsgSettings

Bu tür bir hata iletisi şöyle görünebilir: "Sanal ağda Tümleştirme Çalışma Zamanı sağlanamadı. DNS sunucusu veya NSG ayarları yapılandırıldıysa, DNS sunucusunun erişilebilir olduğundan ve NSG'nin düzgün yapılandırıldığından emin olun."

Bu durumda büyük olasılıkla DNS sunucusunda ve NSG ayarlarında SSIS IR için gereken Azure sunucu adının çözümlenmesini veya bu ada erişilmesini engelleyen özelleştirilmiş bir yapılandırma kullanıyorsunuzdur. Daha fazla bilgi için bkz. SSIS IR Sanal Ağ yapılandırması. Sorunlarınız devam ediyorsa Azure Data Factory destek takımına başvurun.

VNetResourceGroupLockedDuringUpgrade

SSIS IR düzenli aralıklarla otomatik olarak güncelleştirilecek. Yükseltme sırasında yeni bir Azure Batch havuzu oluşturulur ve eski Azure Batch havuzu silinir. Ayrıca, eski havuzun Sanal Ağ ile ilgili kaynakları da silinir ve aboneliğinizin altında yeni Sanal Ağ ile ilgili kaynaklar oluşturulur. Bu hata, abonelik veya kaynak grubu düzeyindeki bir silme kilidinden dolayı eski havuzun Sanal Ağ ile ilgili kaynaklarını silmenin başarısız olduğu anlamına gelir. Silme kilidini müşteri denetlediği ve ayarladığı için, bu durumda silme kilidini kaldırması gerekir.

VNetResourceGroupLockedDuringStart

SSIS IR sağlama başarısız olursa, oluşturulan tüm kaynaklar silinir. Bununla birlikte abonelik veya kaynak grubu düzeyinde bir kaynak silme kilidi varsa Sanal Ağ kaynakları beklendiği gibi silinmez. Bu hatayı düzeltmek için silme kilidini kaldıın ve IR'yi yeniden başlatın.

VNetResourceGroupLockedDuringStop/VNetDeleteLock

SSIS IR'yi durdurduğunuzda Sanal Ağ ile ilgili tüm kaynaklar silinir. Ama abonelik veya kaynak grubu düzeyinde bir kaynak silme kilidi olduğunda silme işlemi başarısız olur. Burada da silme kilidini müşteri denetler ve ayarlar. Bu nedenle silme kilidini kaldırması ve sonra SSIS IR'yi yeniden durdurması gerekir.

NodeUnavailable

Bu hata IR çalışırken oluşur ve IR'nin artık iyi durumda olmadığı anlamına gelir. Bu hata her zaman DNS sunucusunda veya NSG yapılandırmasında yapılan ve SSIS IR'nin gerekli hizmete bağlanmasını engelleyen bir değişiklikten kaynaklanır. DNS sunucusunun ve NSG'nin yapılandırması müşteri tarafından denetlendiğinden, müşterinin kendi tarafında bağlantıyı engelleyen sorunları düzeltmesi gerekir. Daha fazla bilgi için bkz. SSIS IR Sanal Ağ yapılandırması. Sorunlarınız devam ediyorsa Azure Data Factory destek takımına başvurun.

Statik genel IP adresleri yapılandırması

Azure-SSIS IR'yi Azure Sanal Ağ birleştirdiğinizde, IR'nin belirli IP adreslerine erişimi sınırlayan veri kaynaklarına erişebilmesi için IR için kendi statik genel IP adreslerinizi de getirebilirsiniz. Daha fazla bilgi için bkz. Azure-SSIS Integration Runtime'ı sanal ağa ekleme.

Yukarıdaki sanal ağ sorunlarının yanı sıra statik genel IP adresleriyle ilgili sorunu da giderebilirsiniz. Yardım için lütfen aşağıdaki hataları denetleyin.

InvalidPublicIPSpecified

Bu hata, Azure-SSIS IR'yi başlattığınızda çeşitli nedenlerle oluşabilir:

Hata iletisi	Çözüm
Sağlanan statik genel IP adresi zaten kullanılıyor. Lütfen Azure-SSIS Integration Runtime'ınız için kullanılmayan iki ip adresi sağlayın.	Kullanılmayan iki statik genel IP adresi seçmeniz veya belirtilen genel IP adresine geçerli başvuruları kaldırmanız ve ardından Azure-SSIS IR'yi yeniden başlatmanız gerekir.
Sağlanan statik genel IP adresinin DNS adı yok, lütfen Azure-SSIS Integration Runtime'ınız için bunlardan ikisini DNS adıyla belirtin.	Aşağıdaki resimde gösterildiği gibi Azure portalında genel IP adresinin DNS adını ayarlayabilirsiniz. Belirli adımlar şunlardır: (1) Azure portalını açın ve bu genel IP adresinin kaynak sayfasına gidin; (2) Yapılandırma bölümünü seçin ve DNS adını ayarlayın, ardından Kaydet düğmesine tıklayın; (3) Azure-SSIS IR'nizi yeniden başlatın.
Azure-SSIS Integration Runtime'ınız için sağlanan sanal ağ ve statik genel IP adresleri aynı konumda olmalıdır.	Azure Network'ün gereksinimlerine göre statik genel IP adresi ve sanal ağ aynı konumda ve abonelikte olmalıdır. Lütfen iki geçerli statik genel IP adresi sağlayın ve Azure-SSIS IR'yi yeniden başlatın.
Sağlanan statik genel IP adresi temel bir adrestir. Lütfen Azure-SSIS Integration Runtime'ınız için iki standart ip adresi sağlayın.	Yardım için Genel IP Adresinin SKU'larına bakın.

PublicIPResourceGroupLockedDuringStart

Azure-SSIS IR sağlama başarısız olursa, oluşturulan tüm kaynaklar silinir. Ancak abonelik veya kaynak grubunda (statik genel IP adresinizi içeren) bir kaynak silme kilidi varsa ağ kaynakları beklendiği gibi silinmez. Hatayı düzeltmek için lütfen silme kilidini kaldırın ve IR'yi yeniden başlatın.

PublicIPResourceGroupLockedDuringStop

Azure-SSIS IR'yi durdurduğunuzda, genel IP adresinizi içeren kaynak grubunda oluşturulan tüm ağ kaynakları silinir. Ancak abonelik veya kaynak grubunda (statik genel IP adresinizi içeren) bir kaynak silme kilidi varsa silme işlemi başarısız olabilir. Silme kilidini kaldırın ve IR'yi yeniden başlatın.

PublicIPResourceGroupLockedDuringUpgrade

Azure-SSIS IR düzenli olarak otomatik olarak güncelleştirilir. Yükseltme sırasında yeni IR düğümleri oluşturulur ve eski düğümler silinir. Ayrıca, eski düğümler için oluşturulan ağ kaynakları (örneğin, yük dengeleyici ve ağ güvenlik grubu) silinir ve yeni ağ kaynakları aboneliğiniz altında oluşturulur. Bu hata, eski düğümler için ağ kaynaklarını silme işleminin abonelik veya kaynak grubundaki (statik genel IP adresinizi içeren) silme kilidi nedeniyle başarısız olduğu anlamına gelir. Eski düğümleri temizleyebilmemiz ve eski düğümler için statik genel IP adresini serbest bırakabilmemiz için silme kilidini kaldırın. Aksi takdirde statik genel IP adresi serbest bırakılamaz ve IR'nizi daha fazla yükseltemeyiz.

PublicIPNotUsableDuringUpgrade

Kendi statik genel IP adreslerinizi getirmek istediğinizde iki genel IP adresi sağlanmalıdır. Bunlardan biri IR düğümlerini hemen oluşturmak için, diğeri de IR'nin yükseltilmesi sırasında kullanılır. Yükseltme sırasında diğer genel IP adresi kullanılamaz olduğunda bu hata oluşabilir. Olası nedenler için InvalidPublicIPSpecified bölümüne bakın.

Kaynak yönetimi

Kaynak etiketi güncelleştirilmedi

Azure kaynaklarınıza etiketler uygulayarak bunları mantıksal olarak bir taksonomi halinde düzenleyebilirsiniz. SSIS IR çalışırken, SSIS IR üst veri fabrikası etiketlerindeki değişiklikler SSIS IR yeniden başlatılana kadar etkili olmaz.