تخصيص الإعداد لوقت تشغيل تكامل Azure-SSIS

ينطبق على:Azure Data Factory Azure Synapse Analytics

تلميح

جرب Data Factory في Microsoft Fabric، وهو حل تحليلي متكامل للمؤسسات. يغطي Microsoft Fabric كل شيء بدءا من حركة البيانات إلى علم البيانات والتحليلات في الوقت الحقيقي والمعلومات المهنية وإعداد التقارير. تعرف على كيفية بدء إصدار تجريبي جديد مجانا!

يمكنك تخصيص Azure-SQL Server Integration Services (SSIS) Integration Runtime (IR) فيAzure Data Factory (ADF) أو Synapse Pipelines من خلال عمليات الإعداد المخصصة. إنها تسمح لك بإضافة خطواتك الخاصة أثناء توفير أو إعادة تكوين Azure-SSIS IR الخاص بك.

باستخدام إعدادات مخصصة، يمكنك تغيير تكوين التشغيل الافتراضي أو بيئة التشغيل الخاصة بـ Azure-SSIS IR. على سبيل المثال، لبدء خدمات Windows إضافية، استمر في استخدام بيانات اعتماد الوصول لمشاركات الملفات، أو استخدم بروتوكول شبكة تشفير أقوى/أكثر أمانا (TLS 1.2). أو يمكنك تثبيت مكونات إضافية، مثل التجميعات أو برامج التشغيل أو الملحقات، على كل عقدة من Azure-SSIS IR. يمكن أن تكون مكونات مخصصة أو مفتوحة المصدر أو مكونات تابعة لجهة خارجية. لمزيد من المعلومات حول المكونات المضمنة / المثبتة مسبقًا، يرجى مراجعة المكونات المضمنة / المثبتة مسبقًا على Azure-SSIS IR.

يمكنك إجراء عمليات إعداد مخصصة على AZURE-SSIS IR بأي من الطريقتين التاليتين:

• إعداد مخصص قياسي مع برنامج نصي:إعداد برنامج نصي والملفات المقترنة به، وتحميلها جميعا معا إلى حاوية كائن ثنائي كبير الحجم في حساب تخزين Azure. يمكنك بعد ذلك توفير معرف الموارد المنتظم (SAS) لتوقيع الوصول المشترك (URI) لحاوية البيانات الثنائية الكبيرة الخاصة بك عند إعدادAzure-SSIS IR الخاص بك أو إعادة تكوينه. تقوم كل عقدة في Azure-SSIS IR بتنزيل البرنامج النصي والملفات المرتبطة به من حاوية كائن ثنائي كبير الحجم وتشغيل الإعداد المخصص بأذونات مرتفعة. عند الانتهاء من الإعداد المخصص، تقوم كل عقدة بتحميل الإخراج القياسي للتنفيذ والسجلات الأخرى إلى حاوية البيانات الثنائية الكبيرة.
• التعبير عن الإعداد المخصص دون برنامج نصي : قم بتشغيل بعض تكوينات النظام الشائعة وأوامر Windows أو قم بتثبيت بعض المكونات الإضافية الشائعة أو الموصى بها دون استخدام أي برامج نصية.

يمكنك تثبيت المكونات المجانية (غير المرخصة) والمدفوعة (المرخصة) باستخدام إعدادات مخصصة قياسية وصريحة. إذا كنت أحد موردي البرامج المستقلين (ISV)، فراجع تطوير مكونات مدفوعة أو مرخصة لـ Azure-SSIS IR.

هام

للاستفادة من التحسينات المستقبلية، نوصي باستخدام الإصدار 3 أو سلسلة من العقد الأحدث لـ Azure-SSIS IR مع الإعداد المخصص.

القيود الحالية

تنطبق القيود التالية فقط على الإعدادات المخصصة القياسية:

• إذا كنت تريد استخدام gacutil.exe في البرنامج النصي لتثبيت التجميعات في ذاكرة التخزين المؤقت للتجميع العمومي (GAC)، فأنت بحاجة إلى توفير gacutil.exe كجزء من الإعداد المخصص. أو يمكنك استخدام النسخة التي تم توفيرها في مجلد عينة حاوية كائن ثنائي كبير الحجم المعاينة العامة، راجع قسم نماذج الإعداد المخصصة القياسية أدناه.

• إذا كنت تريد الرجوع إلى مجلد فرعي في البرنامج النصي، فإن msiexec.exe لا يدعم الترميز .\ للإشارة إلى المجلد الجذر. استخدم أحد الأوامر مثل msiexec /i "MySubfolder\MyInstallerx64.msi" ... بدلاً من msiexec /i ".\MySubfolder\MyInstallerx64.msi" ....

• المشاركات الإدارية، أو مشاركات الشبكة المخفية التي تم إنشاؤها تلقائياً بواسطة Windows، غير مدعومة حالياً على AZURE-SSIS IR.

• برنامج تشغيل IBM iSeries Access ODBC غير مدعوم AZURE-SSIS IR. قد ترى أخطاء التثبيت أثناء الإعداد المخصص. إذا كان ذلك صحيح، فاتصل بدعم IBM للحصول على المساعدة.

المتطلبات الأساسية

إشعار

نوصي باستخدام الوحدة النمطية Azure Az PowerShell للتفاعل مع Azure. راجع تثبيت Azure PowerShell للبدء. لمعرفة كيفية الترحيل إلى الوحدة النمطية Az PowerShell، راجع ترحيل Azure PowerShell من AzureRM إلى Az.

لتخصيص AZURE-SSIS IR، تحتاج إلى العناصر التالية:

• اشتراك Azure

• توفير AZURE-SSIS IR

• حساب Azure Storage. غير مطلوب للإعدادات المخصصة السريعة. بالنسبة للإعدادات المخصصة القياسية، يمكنك تحميل وتخزين البرنامج النصي للإعداد المخصص والملفات المرتبطة به في حاوية كائن ثنائي كبير الحجم. تقوم عملية الإعداد المخصصة أيضاً بتحميل سجلات التنفيذ الخاصة بها إلى نفس حاوية الكائن الثنائي كبير الحجم.

الإرشادات

يمكنك توفير AZURE-SSIS IR الخاص بك أو إعادة تكوينه باستخدام إعدادات مخصصة على واجهة مستخدم ADF. إذا كنت تريد أن تفعل الشيء نفسه باستخدام PowerShell، فقم بتنزيل وتثبيت Azure PowerShell.

إعداد مخصص قياسي

لتزويد أو إعادة إعداد Azure-SSISAZURE-SSIS IR الخاص بك أو إعادة تكوينه باستخدام إعدادات مخصصة قياسية على واجهة مستخدم ADF، أكمل الخطوات التالية.

1. قم بإعداد برنامج الإعداد المخصص والملفات المقترنة به (على سبيل المثال،.bat أو.cmd أو.exe أو.dll أو.msi أو ملفات.ps1).

   • ينبغي أن يكون لديك ملف برنامج نصي يسمى main.cmd، وهو نقطة الإدخال الخاصة بإعداد مخصص.
   • للتأكد من إمكانية تنفيذ البرنامج النصي بصمت، يجب اختباره على جهازك المحلي أولاً.
   • إذا كنت تريد تحميل سجلات إضافية تم إنشاؤها بواسطة أدوات أخرى (على سبيل المثال، msiexec.exe) إلى حاوية كائن ثنائي كبير الحجم، فحدد متغير البيئة المحدد مسبقاً، CUSTOM_SETUP_SCRIPT_LOG_DIR، كمجلد السجل في نصوصك البرمجية (لمثلاً msiexec / i xxx.msi / quiet / lv٪ CUSTOM_SETUP_SCRIPT_LOG_DIR٪ \ install.log ).

2. قم بتنزيل وتثبيت وفتح Azure Storage Explorer.

   أ. ضمن الملفات المحلية والمرفقة، انقر بزر الماوس الأيمن فوق حسابات التخزين ، ثم حدد الاتصال بموقع تخزين Azure.

   

   ب. حدد حساب التخزين أو الخدمة، وحدد اسم الحساب ومفتاحه ، ثم حدد التالي.

   جـ. أدخل اسم ومفتاح حساب Azure Storage، وحدد التالي، ثم حدد اتصال.

   

   د. ضمن حساب تخزين Azure المتصل، انقر بزر الماوس الأيمن فوق حاويات تخزين كائن ثنائي كبير الحجم، وحدد إنشاء حاوية تخزين كائن ثنائي كبير الحجم، ثم قم بتسمية حاوية الكائن الثنائي كبير الحجم الجديد.

   

   هـ. حدد حاوية الكائن الثنائي كبير الحجم الجديد، ثم قم بتحميل برنامج الإعداد المخصص والملفات المقترنة به. تأكد من تحميل main.cmd في المستوى العلوي من حاوية الكائن الثنائي كبير الحجم، وليس في أي مجلد. يجب أن تحتوي حاوية الكائن الثنائي كبير الحجم على ملفات الإعداد المخصصة الضرورية فقط، لذا لن يستغرق تنزيلها إلى Azure-SSIS IR لاحقاً وقتا طويلا. يتم تعيين المدة القصوى لإعداد مخصص حالياً في 45 دقيقة قبل المهلة. يتضمن هذا الوقت لتحميل جميع الملفات من حاوية كائن ثنائي كبير الحجم وتثبيتها على Azure-SSIS IR. إذا كان الإعداد يحتاج المزيد من الوقت، ارفع تذكرة دعم.

   

   و. انقر بزر الماوس الأيمن فوق حاوية البيانات الثنائية الكبيرة، ثم حدد الحصول على توقيع وصول مشترك.

   

   ز. قم بإنشاء SAS URI لحاوية كائن ثنائي كبير الحجم الخاصة بك مع وقت انتهاء صلاحية طويل بما فيه الكفاية مع إذن قراءة/ كتابة/ سرد. أنت بحاجة إلى URI SAS لتنزيل وتشغيل برنامج الإعداد المخصص والملفات المقترنة به. يحدث ذلك كلما تم إعادة تصور أي عقدة من Azure-SSIS IR أو إعادة تشغيلها. كما تحتاج إلى إذن كتابة لتحميل سجلات تنفيذ الإعداد.

   هام

   تأكد من عدم انتهاء صلاحية SAS URI وموارد الإعداد المخصصة متوفرة دائما أثناء دورة حياة AZURE-SSIS IR بأكملها، منذ الإنشاء إلى الحذف، خاصة إذا كانت تتوقف بانتظام ثم ابدأ Azure-SSIS IR خلال هذه الفترة.

   

   ح. انسخ SAS URI الخاص بحاوية كائن ثنائي كبير الحجم واحفظه.

   

3. حدد خانة الاختيار تخصيص وقت تشغيل تكامل Azure-SSIS مع تكوينات النظام الإضافية / تثبيتات المكوناتفي صفحة الإعدادات المتقدمة في جزء إعدادMicrosoft Integration Runtime. بعد ذلك، أدخل SAS URI لحاوية البيانات الثنائية الكبيرة في مربع النص حاوية إعداد مخصصة SAS URI.

   

بعد انتهاء الإعداد المخصص القياسي وبدء Azure-SSIS IR، يمكنك العثور على جميع سجلات الإعداد المخصصة في المجلد main.cmd.log لحاوية البيانات الثنائية الكبيرة. وتشمل الإخراج القياسي لـ main.cmd وسجلات التنفيذ الأخرى.

الإعداد المخصص السريع

لتوفير Azure-SSIS IR الخاص بك أو إعادة تكوينه باستخدام إعدادات مخصصة سريعة على واجهة مستخدم ADF، أكمل الخطوات التالية.

1. حدد خانة الاختيار تخصيص وقت تشغيل تكامل Azure-SSIS مع تكوينات النظام الإضافية / تثبيتات المكوناتفي صفحة الإعدادات المتقدمة في جزء إعدادMicrosoft Integration Runtime.

2. حدد جديد لفتح جزء إضافة إعداد مخصص سريع، ثم حدد نوعاً في القائمة المنسدلة نوع الإعداد المخصص السريع. نقدم حالياً إعدادات مخصصة سريعة لتشغيل أمر cmdkey، وإضافة متغيرات البيئة، وتثبيت zure PowerShell، وتثبيت المكونات المرخصة.

تشغيل أمر cmdkey

إذا حددت نوع أمر تشغيل cmdkey للإعداد المخصص السريع الخاص بك، فيمكنك تشغيل أمر Windows cmdkey على Azure-SSIS IR الخاص بك. للقيام بذلك، أدخل اسم الكمبيوتر المستهدف أو اسم المجال واسم المستخدم أو اسم الحساب وكلمة المرور أو مفتاح الحساب في مربعات نص /أضف، /مستخدم و / تمرير على التوالي. سيسمح لك هذا بالاستمرار في بيانات اعتماد الوصول لخوادم SQL أو مشاركات الملفات أو ملفات Azure على Azure-SSIS IR. على سبيل المثال، للوصول إلى Azure Files، يمكنك إدخال YourAzureStorageAccountName.file.core.windows.net،azure\YourAzureStorageAccountName وYourAzureStorageAccountKey لـ /أضف، و/المستخدم، و/تمرير، على التوالي. يشبه هذا تشغيل أمر Windows cmdkey على جهازك المحلي.

قم بإضافة متغيرات البيئة

إذا حددت النوع إضافة متغير بيئة لإعدادك المخصص السريع، يمكنك إضافة متغير بيئة Windows على Azure-SSIS IR الخاص بك. للقيام بذلك، أدخل اسم متغير البيئة وقيمته في مربعي النص اسم المتغير وقيمة المتغير على التوالي. سيتيح لك هذا باستخدام متغير البيئة في الحزم التي تعمل على AZURE-SSIS IR، على سبيل المثال في مكونات البرنامج النصي/المهام. يشبه هذا تشغيل أمر Windows set على جهازك المحلي.

تثبيت Azure PowerShell

إذا حددت نوع تثبيت Azure PowerShell لإعدادك المخصص السريع، فيمكنك تثبيت الوحدة النمطية Az من PowerShell على Azure-SSIS IR. للقيام بذلك، أدخل رقم إصدار الوحدة النمطية Az (xyz) الذي تريده من قائمة الإصدارات المدعومة. سيسمح لك هذا بتشغيل Cmdlets/scripts Azure PowerShell في الحزم الخاصة بك لإدارة موارد Azure، على سبيل المثال خدمات تحليل Azure (AAS).

تركيب المكونات المُرَّخصة

إذا حددت نوع تثبيت المكون المرخص لإعدادك المخصص السريع، فيمكنك بعد ذلك تحديد مكون متكامل من شركاء ISV في القائمة المنسدلة اسم المكون:

• إذا حددت المكون SentryOne's Task Factory، فيمكنك تثبيت مجموعة مكونات Task Factory من SentryOne على Azure-SSIS IR عن طريق إدخال مفتاح ترخيص المنتج الذي اشتريته منها في مربع مفتاح الترخيص. الإصدار الحالي المدمج هو 2020.21.2.

• إذا حددت مكون HEDDA.IO الخاص بـ oh22's HEDDA.IO، فيمكنك تثبيت مكون جودة / تنظيف البيانات HEDDA.IO من oh22 على Azure-SSIS IR. للقيام بذلك، ينبغي لك شراء خدمتهم مسبقاً. الإصدار الحالي المدمج هو 1.0.14.

• إذا حددت المكون oh22's SQLPhonetics.NET، فيمكنك تثبيت مكون جودة / مطابقة البيانات SQLPhonetics.NET من oh22 على Azure-SSIS IR. لعمل ذلك، أدخل مفتاح ترخيص المنتج الذي اشتريته منه مسبقاً في مربع النص مفتاح الترخيص. الإصدار الحالي المدمج هو 1.0.45.

• إذا حددت المكون مجموعة أدوات تكامل SSIS من KingswaySoft، فيمكنك تثبيت مجموعة أدوات تكامل SSIS لتطبيقاتCRM / ERP / Marketing / التعاون، مثلMicrosoft Dynamics / SharePoint / Project Server وOracle / Salesforce Marketing Cloud وما إلى ذلك من KingswaySoft على Azure-SSIS IR عن طريق إدخال مفتاح ترخيص المنتج الذي اشتريته منهم في مربع مفتاح الترخيص. الإصدار الحالي المدمج هو 21.2.

• إذا حددت المكون KingswaySoft's SSIS Productivity Pack، فيمكنك تثبيت مجموعة مكونات SSIS Productivity Pack من KingswaySoft على Azure-SSIS IR عن طريق إدخال مفتاح ترخيص المنتج الذي اشتريته من لهم في مربع مفتاح الترخيص. الإصدار الحالي المدمج هو 21.2.

• إذا حددت المكون Xtract IS من برنامج Theobald Software، فيمكنك تثبيت مجموعة موصلات Xtract IS لنظام SAP (ERP، S / 4HANA، BW) من برنامج Theobald على Azure- SSIS IR عن طريق سحب وإفلات/تحميل ملف ترخيص المنتج الذي اشتريته منهم في مربع ملف الترخيص. الإصدار الحالي المدمج هو 6.5.13.18.

• إذا حددت مكوِّن AecorSoft's Integration Service، فيمكنك تثبيت مجموعة Integration Service من الموصلات لأنظمة SAP وSalesforce من AecorSoft على Azure-SSIS IR. لعمل ذلك، أدخل مفتاح ترخيص المنتج الذي اشتريته منه مسبقاً في مربع النص مفتاح الترخيص. الإصدار الحالي المدمج هو 3.0.00.

• إذا حددت المكون حزمة SSIS القياسية لـ CData، فيمكنك تثبيت مجموعة SSIS Standard Package من المكونات الأكثر شيوعاً من CData، مثل موصلات Microsoft SharePoint، على Azure-SSIS IR. لعمل ذلك، أدخل مفتاح ترخيص المنتج الذي اشتريته منه مسبقاً في مربع النص مفتاح الترخيص. الإصدار الحالي المدمج هو 21.7867.

• إذا حددت المكون حزمة SSIS الموسعة لـ CData، فيمكنك تثبيت مجموعة SSIS Extended Package لجميع المكونات من CData، مثل موصلاتMicrosoft Dynamics 365 Business Central والمكونات الأخرى في حزمة SSIS القياسية، على Azure-SSIS IR. لعمل ذلك، أدخل مفتاح ترخيص المنتج الذي اشتريته منه مسبقاً في مربع النص مفتاح الترخيص. الإصدار الحالي المدمج هو 21.7867. نظراً لحجمه الكبير، لتجنب انتهاء مهلة التثبيت، يرجى التأكد من أن Azure-SSIS IR الخاص بك يحتوي على وحدة معالجة مركزية ذات 4 نواة على الأقل لكل عقدة.

ستظهر الإعدادات المخصصة السريعة التي أضفتها في صفحة الإعدادات المتقدمة. لإزالة هذه المخازن، حدد خانات الاختيار الخاصة بها، ثم حدد حذف.

Azure PowerShell

لتوفير أو إعادة تكوين AZURE-SSIS IR مع الاجهزة المخصصة باستخدام Azure PowerShell، أكمل الخطوات التالية.

1. إذا كان AZURE-SSIS IR قد بدأ/يعمل بالفعل، فتوقف عن تشغيله أولا.

2. يمكنك بعد ذلك إضافة أو إزالة إعدادات مخصصة عن طريق تشغيل Set-AzDataFactoryV2IntegrationRuntime cmdlet قبل بدء Azure-SSIS IR.

   $ResourceGroupName = "[your Azure resource group name]"
   $DataFactoryName = "[your data factory name]"
   $AzureSSISName = "[your Azure-SSIS IR name]"
   # Custom setup info: Standard/express custom setups
   $SetupScriptContainerSasUri = "" # OPTIONAL to provide a SAS URI of blob container for standard custom setup where your script and its associated files are stored
   $ExpressCustomSetup = "[RunCmdkey|SetEnvironmentVariable|InstallAzurePowerShell|SentryOne.TaskFactory|oh22is.SQLPhonetics.NET|oh22is.HEDDA.IO|KingswaySoft.IntegrationToolkit|KingswaySoft.ProductivityPack|Theobald.XtractIS|AecorSoft.IntegrationService|CData.Standard|CData.Extended or leave it empty]" # OPTIONAL to configure an express custom setup without script
   
   # Add custom setup parameters if you use standard/express custom setups
   if(![string]::IsNullOrEmpty($SetupScriptContainerSasUri))
   {
       Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
           -DataFactoryName $DataFactoryName `
           -Name $AzureSSISName `
           -SetupScriptContainerSasUri $SetupScriptContainerSasUri
   }
   if(![string]::IsNullOrEmpty($ExpressCustomSetup))
   {
       if($ExpressCustomSetup -eq "RunCmdkey")
       {
           $addCmdkeyArgument = "YourFileShareServerName or YourAzureStorageAccountName.file.core.windows.net"
           $userCmdkeyArgument = "YourDomainName\YourUsername or azure\YourAzureStorageAccountName"
           $passCmdkeyArgument = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourPassword or YourAccessKey")
           $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.CmdkeySetup($addCmdkeyArgument, $userCmdkeyArgument, $passCmdkeyArgument)
       }
       if($ExpressCustomSetup -eq "SetEnvironmentVariable")
       {
           $variableName = "YourVariableName"
           $variableValue = "YourVariableValue"
           $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.EnvironmentVariableSetup($variableName, $variableValue)
       }
       if($ExpressCustomSetup -eq "InstallAzurePowerShell")
       {
           $moduleVersion = "YourAzModuleVersion"
           $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.AzPowerShellSetup($moduleVersion)
       }
       if($ExpressCustomSetup -eq "SentryOne.TaskFactory")
       {
           $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
           $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
       }
       if($ExpressCustomSetup -eq "oh22is.SQLPhonetics.NET")
       {
           $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
           $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
       }
       if($ExpressCustomSetup -eq "oh22is.HEDDA.IO")
       {
           $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup)
       }
       if($ExpressCustomSetup -eq "KingswaySoft.IntegrationToolkit")
       {
           $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
           $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
       }
       if($ExpressCustomSetup -eq "KingswaySoft.ProductivityPack")
       {
           $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
           $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
       }    
       if($ExpressCustomSetup -eq "Theobald.XtractIS")
       {
           $jsonData = Get-Content -Raw -Path YourLicenseFile.json
           $jsonData = $jsonData -replace '\s',''
           $jsonData = $jsonData.replace('"','\"')
           $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString($jsonData)
           $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
       }
       if($ExpressCustomSetup -eq "AecorSoft.IntegrationService")
       {
           $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
           $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
       }
       if($ExpressCustomSetup -eq "CData.Standard")
       {
           $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
           $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
       }
       if($ExpressCustomSetup -eq "CData.Extended")
       {
           $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
           $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
       }    
       # Create an array of one or more express custom setups
       $setups = New-Object System.Collections.ArrayList
       $setups.Add($setup)
   
       Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
           -DataFactoryName $DataFactoryName `
           -Name $AzureSSISName `
           -ExpressCustomSetup $setups
   }
   Start-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
       -DataFactoryName $DataFactoryName `
       -Name $AzureSSISName `
       -Force
   

عينات إعداد مخصصة قياسية

لعرض بعض عينات الإعدادات المخصصة القياسية وإعادة استخدامها، أكمل الخطوات التالية.

1. الاتصال إلى حاوية كائن ثنائي كبير الحجم المعاينة العامة باستخدام مستكشف تخزين Azure.

   أ. ضمن الملفات المحلية والمرفقة، انقر بزر الماوس الأيمن فوق حسابات التخزين ، ثم حدد الاتصال بموقع تخزين Azure.

   

   ب. حدد حاوية كائن ثنائي كبير الحجم، وحدد عنوان URL لتوقيع الوصول المشترك (SAS)، ثم حدد التالي.

   جـ. في مربع النص حاوية تخزين البيانات الثنائية الكبيرة SAS URL، أدخل SAS URI لحاوية البيانات الثنائية الكبيرة للمعاينة العامة أدناه، وحدد التالي ، ثم حدد اتصال.

   https://ssisazurefileshare.blob.core.windows.net/publicpreview?sp=rl&st=2020-03-25T04:00:00Z&se=2025-03-25T04:00:00Z&sv=2019-02-02&sr=c&sig=WAD3DATezJjhBCO3ezrQ7TUZ8syEUxZZtGIhhP6Pt4I%3D

   د. في الجزء الأيمن، حدد حاوية كائن ثنائي كبير الحجم المتصلة publicpreview، ثم انقر نقراً مزدوجاً فوق المجلد CustomSetupScript. يحتو هذا المجلد على العناصر التالية:

   • مجلد عينة، والذي يحتوي على إعداد مخصص لتثبيت مهمة أساسية على كل عقدة في Azure-SSIS IR الخاص بك. المهمة لا تفعل شيئا سوى السكون لبضع ثوان. يحتوي المجلد أيضاً على المجلد gacutil، الذي يحتوي محتواه بالكامل ( gacutil.exe وgacutil.exe.config و1033 \ gacutlrc.dll ) كما هو الحال في حاوية كائن ثنائي كبير الحجم.

   • مجلد UserScenarios، والذي يحتوي على العديد من عينات الإعداد المخصصة من سيناريوهات المستخدم الحقيقي. إذا كنت ترغب في تثبيت نماذج متعددة على Azure-SSIS IR، فيمكنك دمج ملفات برنامج الإعداد المخصص (main.cmd) في ملف واحد وتحميله مع جميع الملفات المرتبطة به في حاوية كائن ثنائي كبير الحجم.

     

   هـ. انقر نقراً مزدوجاً فوق المجلد UserScenarios للعثور على العناصر التالية:

   • مجلد NET FRAMEWORK 3.5، والذي يحتوي على برنامج إعداد مخصص (main.cmd) لتثبيت إصدار سابق من.NET Framework على كل عقدة من Azure-SSIS IR. قد يكون هذا الإصدار مطلوباً من قبل بعض المكونات المخصصة.

   • مجلد BCP، والذي يحتوي على برنامج إعداد مخصص (main.cmd) لتثبيت أدوات سطر أوامر (MsSqlCmdLnUtils.msi) على كل عقدة من Azure-SSIS IR الخاص بك. إحدى هذه الأدوات المساعدة هي برنامج النسخ المجمع (bcp).

   • مجلد DNS SUFFIX، والذي يحتوي على برنامج إعداد مخصص (main.cmd) لإلحاق لاحقة DNS الخاصة بك (على سبيل المثال test.com) بأي برنامج باسم مجال غير مؤهل بالكامل وقم بتحويله إلى اسم مجال مؤهل بالكامل (FQDN) قبل استخدامه في استعلامات DNS من Azure-SSIS IR الخاص بك.

   • مجلد EXCEL، والذي يحتوي على برنامج إعداد مخصص (main.cmd) لتثبيت بعض تجميعات ومكتبات C# لكل عقدة في Azure-SSIS IR. يمكنك استخدامها في مهمة برنامج نصي لقراءة ملفات Excel وكتابتها ديناميكياً.

     أولاً، قم بتنزيل ExcelDataReader.dll وDocumentFormat.OpenXml.dll، ثم قم بتحميلهما معاً باستخدام main.cmd إلى حاوية كائن ثنائي كبير الحجم. بدلاً من ذلك، إذا كنت ترغب فقط في استخدام موصلات Excel القياسية (مدير الاتصال والمصدر والوجهة)، فإن Access Redistributable الذي يحتوي عليها مثبت مسبقاً بالفعل على Azure-SSIS IR الخاص بك، لذلك لا تحتاج إلى أي إعداد مخصص.

   • مجلد MYSQL ODBC، والذي يحتوي على برنامج إعداد مخصص (main.cmd) لتثبيت برامج تشغيل MySQL ODBC على كل عقدة في Azure-SSIS IR. يتيح لك هذا الإعداد استخدام موصلات ODBC (مدير الاتصال والمصدر والوجهة) للاتصال بخادم MySQL.

     أولاً، قم بتنزيل أحدث إصدارات 64 بت و32 بت من مثبتات برنامج تشغيل MySQL ODBC (على سبيل المثال، mysql-connector-odbc-8.0.13-winx64.msi وmysql-connector-odbc-8.0.13-win32.msi )، ثم قم بتحميلها جميعاً مع main.cmd إلى حاوية كائن ثنائي كبير الحجم.

     إذا تم استخدام اسم مصدر البيانات (DSN) في الاتصال، فإن تكوين DSN مطلوب في البرنامج النصي للإعداد. على سبيل المثال: C:\Windows\SysWOW64\odbcconf.exe /A {CONFIGSYSDSN "MySQL ODBC 8.0 Unicode Driver" "DSN=<dsnname>|PORT=3306|SERVER=<servername>"}

   • مجلد ORACLE ENTERPRISE، والذي يحتوي على برنامج نصي الإعداد المخصص ( main.cmd ) لتثبيت موصلات Oracle وبرنامج تشغيل OCI على كل عقدة في Azure-SSIS IR Enterprise Edition. يتيح لك هذا الإعداد استخدام Oracle Connection Manager والمصدر والوجهة للاتصال بخادم Oracle.

     أولاً، قم بتنزيل Microsoft Connectors v5.0 لـ Oracle (AttunitySSISOraAdaptersSetup.msi وAttunitySSISOraAdaptersSetup64.msi) من مركز التنزيل لـ Microsoft وأحدث عميل Oracle (على سبيل المثال، instantclient-basic-windows.x64-21.3.0.0.0.zip) من Oracle. بعد ذلك، قم بتحميلها جميعاً معاً باستخدام main.cmd إلى حاوية كائن ثنائي كبير الحجم. إذا كنت تستخدم TNS للاتصال بـ Oracle، فينبغي أيضاً تنزيل tnsnames.ora وتحريره وتحميله إلى حاوية كائن ثنائي كبير الحجم. بهذه الطريقة، يمكن نسخها إلى مجلد تثبيت أوراكل أثناء الإعداد.

   • مجلد ORACLE STANDARD ADO.NET ، والذي يحتوي على برنامج إعداد مخصص (main.cmd) لتثبيت برنامج تشغيل Oracle ODP.NET على كل عقدة في Azure-SSIS IR. يتيح لك هذا الإعداد استخدام ADO.NET Connection Manager والمصدر والوجهة للاتصال بخادم Oracle.

     أولاً، نزِّل أحدث برنامج تشغيل Oracle ODP.NET (على سبيل المثال، ODP.NET_Managed_ODAC122cR1.zip )، ثم حمّله مع main.cmd إلى حاوية كائن ثنائي كبير الحجم.

   • مجلد ORACLE STANDARD ODBC، والذي يحتوي على برنامج إعداد مخصص (main.cmd) لتثبيت برنامج تشغيلOracle ODBC على كل عقدة في Azure-SSIS IR. يقوم البرنامج النصي أيضاً بتكوين اسم مصدر البيانات (DSN). يتيح لك هذا الإعداد استخدام ODBC Connection Manager والمصدر والوجهة أو Power Query Connection Manager والمصدر مع نوع مصدر بيانات ODBC للاتصال بخادم Oracle.

     أولاً، قم بتنزيل أحدث Oracle Instant Client (Basic Package أو Basic Lite Package) وحزمة ODBC، ثم قم بتحميلهما معاً باستخدام main.cmd إلى حاوية البيانات الثنائية الكبيرة الخاصة بك:

     • تنزيل حزم 64 بت (الحزمة الأساسية: Instantclient-basic-windows.x64-18.3.0.0.0dbru.zip؛ Basic Lite Package: Instantclient-basiclite-windows. x64-18.3.0.0.0dbru.zip ؛ حزمةODBC: Instantclient-odbc-windows.x64-18.3.0.0.0dbru.zip )
     • تنزيل حزم 32 بت (الحزمة الأساسية: instantclient-basic-nt-18.3.0.0.0dbru.zip; باقة لايت الأساسية: instantclient-basiclite-nt-18.3.0.0.0dbru.zip;حزمة ODBC: instantclient-odbc-nt-18.3.0.0.0dbru.zip)

   • مجلد ORACLE STANDARD OLEDB، والذي يحتوي على برنامج إعداد مخصص (main.cmd) لتثبيت برنامج تشغيلOracle OLEDB على كل عقدة في Azure-SSIS IR. يتيح لك هذا الإعداد استخدام OLE DB Connection Manager والمصدر والوجهة للاتصال بخادم Oracle.

     أولاً، نزِّل أحدث برنامج تشغيل Oracle OLE DB (على سبيل المثال، ODAC122010Xcopy_x64.zip )، ثم حمّله مع main.cmd إلى حاوية كائن ثنائي كبير الحجم.

   • مجلد POSTGRESQL ODBC، والذي يحتوي على برنامج إعداد مخصص (main.cmd) لتثبيت برامج تشغيل POSTGRESQL ODBC على كل عقدة في Azure-SSIS IR. يتيح لك هذا الإعداد استخدام ODBC (مدير الاتصال والمصدر والوجهة) للاتصال بخادم PostgreSQL.

     أولاً، قم بتنزيل أحدث إصدارات 64 بت و32 بت من مثبتات برنامج تشغيل PostgreSQL ODBC (على سبيل المثال، psqlodbc_x64.msi وpsqlodbc_x86.msi)، وثم قم بتحميلها جميعاً معاً باستخدام main.cmd إلى حاوية كائن ثنائي كبير الحجم.

   • مجلد SAP Business Warehouse، والذي يحتوي على برنامج إعداد مخصص (main.cmd) لتثبيت مجموعة موصلSAP.NET ( librfc32.dll ) على كل عقدة من إصدار Azure-SSIS IR Enterprise Edition الخاص بك. يتيح لك هذا الإعداد استخدام إدارة الاتصالات SAP Business Warehouse والمصدر والوجهة للاتصال بخادم SAP Business Warehouse.

     أولاً، قم بتحميل الإصدار 64 بت أو الإصدار 32 بت من librfc32.dll من مجلد تثبيت SAP مع main.cmd إلى حاوية كائن ثنائي كبير الحجم. يقوم البرنامج النصي بعد ذلك بنسخ تجميع SAP إلى ملف%windir%\SysWow64أو مجلد%windir%\System32 أثناء الإعداد.

   • مجلد تخزين، والذي يحتوي على برنامج إعداد مخصص (main.cmd) لتثبيت Azure PowerShell على كل عقدة في Azure-SSIS IR. يتيح لك هذا الإعداد نشر وتشغيل حزم SSIS التي تعمل على تشغيل أوامر cmdlets/البرامج النصية لـ Azure PowerShell لإدارة تخزين Azure.

     انسخ main.cmd، وعينة AzurePowerShell.msi (أو استخدم أحدث إصدار)، وstorage.ps1 إلى حاوية كائن ثنائي كبير الحجم. استخدم PowerShell.dtsx كقالب للحزم الخاصة بك. يجمع قالب الحزمة بين Azure Blob Download Task، والتي تقوم بتنزيل برنامج PowerShell النصي قابل للتعديل (storage.ps1)، وتنفيذ مهمة العملية، والتي تقوم بتنفيذ البرنامج النصي على كل عقدة.

   • مجلد TERADATA، يحتوي على برنامج إعداد مخصص (main.cmd) والملف المرتبط به (install.cmd) وحزم المثبت (.msi). تقوم هذه الملفات بتثبيت موصلات Teradata وواجهة برمجة تطبيقات Teradata Parallel Transporter (TPT) وبرنامج تشغيل ODBC على كل عقدة في Azure-SSIS IR Enterprise Edition. يتيح لك هذا الإعداد استخدام مدير اتصال Teradata والمصدر والوجهة للاتصال بخادم Teradata.

     أولاً، قم بتنزيل ملف Teradata Tools and Utilities 15.x المضغوط (على سبيل المثال، TeradataToolsAndUtilitiesBase__windows_indep.15.10.22.00.zip )، ثم قم بتحميله مع الملف المذكور سابقاً cmd و.msi إلى حاوية كائن ثنائي كبير الحجم.

   • مجلد TLS 1.2، والذي يحتوي على برنامج إعداد مخصص (main.cmd) لاستخدام تشفير قوي/ بروتوكول شبكة أكثر أماناً (TLS 1.2) على كل عقدة في Azure-SSIS IR. يقوم البرنامج النصي أيضاً بتعطيل إصدارات SSL/TLS الأقدم (SSL 3.0،TLS 1.0،TLS 1.1) في نفس الوقت.

   • مجلد ZULU OPENJDK، والذي يحتوي على نص إعداد مخصص (main.cmd) وملف PowerShell (install_openjdk.ps1 ) لتثبيت Zulu OpenJDK على كل عقدة من Azure-SSIS IR الخاص بك. يتيح لك هذا الإعداد استخدام Azure Data Lake Store وموصلات الملفات المرنة لمعالجة ملفات ORC وParquet. للحصول على مزيدٍ من المعلومات، راجع Azure Feature Pack for SQL Server Integration Services .

     أولاً، نزِّل أحدث إصدار من Zulu OpenJDK (على سبيل المثال، zulu8.33.0.1-jdk8.0.192-win_x64.zip)، ثم حمّله مع main.cmdو install_openjdk.ps1 إلى حاوية كائن ثنائي كبير الحجم.

     

   و. لإعادة استخدام نماذج الإعداد المخصصة القياسية هذه، انسخ محتوى المجلد المحدد إلى حاوية البيانات الثنائية الكبيرة.

2. عند توفير Azure-SSIS IR الخاص بك أو إعادة تكوينه على واجهة مستخدم ADF، حدد خانة الاختيار تخصيص وقت تشغيل تكامل Azure-SSIS مع تكوينات النظام الإضافية / عمليات تثبيت المكونات في صفحة الإعدادات المتقدمة في جزءإعداد Microsoft Integration Runtime. بعد ذلك، أدخل SAS URI لحاوية البيانات الثنائية الكبيرة في مربع النص حاوية إعداد مخصصة SAS URI.

3. عند توفير Azure-SSIS IR الخاص بك أو إعادة تكوينه باستخدام Azure PowerShell، قم بإيقافه إذا كان قد بدأ / قيد التشغيل بالفعل، وقم بتشغيل Set-AzDataFactoryV2IntegrationRuntime cmdlet باستخدام SAS URI لحاوية كائن ثنائي كبير الحجم كقيمة للمعلمة SetupScriptContainerSasUri، ثم ابدأ Azure-SSIS IR.

4. بعد انتهاء الإعداد المخصص القياسي وبدء Azure-SSIS IR، يمكنك العثور على جميع سجلات الإعداد المخصصة في المجلد main.cmd.log لحاوية البيانات الثنائية الكبيرة. وتشمل الإخراج القياسي لـ main.cmd وسجلات التنفيذ الأخرى.

المحتوى ذو الصلة

• إعداد الإصدار Enterprise من Azure-SSIS IR
• تطوير مكونات مدفوعة أو مرخصة لـ Azure-SSIS IR