قم بتشغيل حزمة SSIS مع نشاط تنفيذ حزمة SSIS في مدخل Microsoft Azure

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

تلميح

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

توضح هذه المقالة كيفية تشغيل حزمة SQL Server Integration Services (SSIS) في تدفق Azure Data Factory باستخدام نشاط تنفيذ حزمة SSIS في Azure Data Factory ومدخل مسارات تدفق Synapse.

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

أنشئ وقت تشغيل تكامل Azure-SSIS (IR) إذا لم يكن لديك واحد بالفعل باتباع الإرشادات خطوة بخطوة في البرنامج التعليمي: توفير Azure-SSIS IR .

إنشاء مسار مع نشاط تنفيذ حزمة SSIS

في هذه الخطوة، يمكنك استخدام واجهة مستخدم Data Factory أو التطبيق لإنشاء مسار. إضافة نشاط حزمة تنفيذ SSIS إلى المسار وتكوينه لتشغيل حزمة SSIS الخاصة بك.

Azure Data Factory

1. في نظرة عامة على Data Factory أو الصفحة الرئيسية في مدخل Microsoft Azure، حدد لوحة Open Azure Data Factory Studio لبدء واجهة مستخدم Data Factory أو التطبيق في علامة تبويب منفصلة.

   

   في الصفحة الرئيسية، حدد Orchestrate.

   

Synapse Analytics

انتقل إلى علامة التبويب Integrate في Synapse Studio (التي يمثلها رمز البنية الأساسية لبرنامج ربط العمليات التجارية)، ثم قم بإنشاء بنية أساسية لبرنامج ربط العمليات التجارية جديدة.

1. في مربع أدوات الأنشطة، ابحث عن SSIS. ثم اسحب نشاط حزمة تنفيذ SSIS إلى سطح مصمم البنية الأساسية لبرنامج ربط العمليات التجارية.

   

   حدد كائن نشاط حزمة تنفيذ SSIS لتكوين علامات التبويب عام والإعدادات ومعلمات SSIS وإدارة الاتصال ومنع الخاصية.

علامة التبويب "عام"

في علامة التبويب عام من تنفيذ نشاط حزمة SSIS، أكمل الخطوات التالية.

1. بالنسبة إلى الاسم، أدخل اسم نشاط حزمة تنفيذ SSIS.

2. ًبالنسبة إلى الوصف، أدخل اسم نشاط حزمة تنفيذ SSIS.

3. بالنسبة إلى المهلة، أدخل الحد الأقصى للوقت الذي يمكن أن يتم فيه تشغيل نشاط حزمة تنفيذ SSIS. الافتراضي هو 7 أيام، التنسيق هو D.HH:MM:SS.

4. بالنسبة إلى إعادة المحاولة، أدخل الحد الأقصى لعدد محاولات إعادة المحاولة لنشاط حزمة تنفيذ SSIS.

5. بالنسبة إلى لفاصل الزمني لإعادة المحاولة، أدخل عدد الثواني بين كل محاولة إعادة محاولة لنشاط حزمة تنفيذ SSIS. الافتراضي هو 30 ثانية.

6. حدد خانة الاختيار إخراج آمن لاختيار ما إذا كنت تريد استبعاد إخراج نشاط حزمة تنفيذ SSIS من تسجيل الدخول.

7. حدد خانة الاختيار إدخال آمن لاختيار ما إذا كنت تريد استبعاد إدخال نشاط حزمة تنفيذ SSIS من تسجيل الدخول.

علامة تبويب الإعدادات

في علامة التبويب الإعدادات من تنفيذ نشاط حزمة SSIS، أكمل الخطوات التالية.

1. بالنسبة إلى Azure-SSIS IR، حدد AZURE-SSIS IR المعين لتشغيل نشاط حزمة تنفيذ SSIS.

2. ًبالنسبة إلى الوصف، أدخل اسم نشاط حزمة تنفيذ SSIS.

3. حدد خانة الاختيار مصادقة Windows لاختيار ما إذا كنت تريد استخدام مصادقة Windows للوصول إلى مخازن البيانات، مثل مشاركات خوادم/الملفات المحلية SQL أو ملفات Azure.

   إذا قمت بتحديد خانة الاختيار هذه، أدخل القيم الخاصة ببيانات اعتماد تنفيذ الحزمة في المربعات المجال وواسم المستخدم وكلمة المرور. على سبيل المثال، للوصول إلى ملفات Azure، يكون المجال هو Azure، واسم المستخدم هو <storage account name> وكلمة المرور هي <storage account key>.

   بدلاً من ذلك، يمكنك استخدام الأسرار المخزنة في Azure Key Vault كقيم لها. للقيام بذلك، حدد خانة الاختيار AZURE KEY VAULT المجاورة لها. حدد أو حرر خدمة مرتبطة بالمخزن الرئيسي الموجود أو أنشئ خدمة جديدة. ثم حدد الاسم السري والإصدار لقيمتك. عند إنشاء خدمة مرتبطة بالمخزن الرئيسي أو تحريرها، يمكنك تحديد المخزن الرئيسي الموجود أو تحريره أو إنشاء مخزن جديد. تأكد من منح Data Factory الوصول إلى الهوية المدارة إلى المخزن الرئيسي إذا لم تكن قد فعلت ذلك بالفعل. يمكنك أيضاً إدخال سرك مباشرةً بالتنسيق التالي: <key vault linked service name>/<secret name>/<secret version>.

4. حدد خانة الاختيار وقت التشغيل 32 بت لاختيار ما إذا كانت الحزمة تحتاج إلى وقت تشغيل 32 بت.

5. بالنسبة إلى موقع الحزمة، حدد SSISDB أو نظام الملفات (الحزمة) أو نظام الملفات (المشروع) أو الحزمة المضمنة أو مخزن الحزمة.

موقع الحزمة: SSISDB

يتم تحديد SSISDB كموقع الحزمة تلقائياً إذا تم توفير الأشعة تحت الحمراء Azure-SSIS مع كتالوج SSIS (SSISDB) الذي يستضيفه خادم قاعدة بيانات Azure SQL/ المثيل المُدار أو يمكنك تحديده بنفسك. إذا تم تحديده، أكمل الخطوات التالية.

1. إذا كان AZURE-SSIS IR قيد التشغيل وتم مسح خانة الاختيار إدخالات يدوية استعرض وحدد المجلدات والمشاريع والحزم والبيئات الموجودة من SSISDB. حدد تحديث لجلب المجلدات أو المشاريع أو الحزم أو البيئات المضافة حديثاً من SSISDB، بحيث تكون متوفرة للتصفح والاختيار. لاستعراض وتحديد بيئات تنفيذ الحزمة الخاصة بك، يجب تكوين المشاريع مسبقاً لإضافة تلك البيئات كمراجع من نفس المجلدات تحت SSISDB. لمزيد من المعلومات، راجع إنشاء وتعيين بيئات SSIS.

2. بالنسبة إلى مستوى التسجيل، حدد نطاق محدد مسبقاً لتسجيل تنفيذ الحزمة. حدد خانة الاختيار مخصص إذا كنت تريد إدخال اسم تسجيل الدخول المخصص بدلاً من ذلك.

3. إذا لم يتم تشغيل AZURE-SSIS IR أو تم تحديد خانة الاختيار إدخالات يدوية أدخل الحزمة ومسارات البيئة من SSISDB مباشرةً بالتنسيقات التالية: <folder name>/<project name>/<package name>.dtsx و<folder name>/<environment name>.

   

موقع الحزمة: نظام الملفات (الحزمة)

نظام الملفات (الحزمة) كموقع الحزمة الخاص بك والذي يتم تحديده تلقائياً إذا تم توفير الأشعة تحت الحمراء Azure-SSIS دون SSISDB أو يمكنك تحديده بنفسك. إذا تم تحديده، أكمل الخطوات التالية.

1. حدد الحزمة لتشغيلها عن طريق توفير مسار اصطلاح التسمية العالمي (UNC) إلى ملف الحزمة (باستخدام .dtsx) في المربع مسار الحزمة. يمكنك استعراض الحزمة وتحديدها عن طريق تحديد استعراض تخزين الملفات أو إدخال مسارها يدوياً. على سبيل المثال، إذا قمت بتخزين الحزمة في ملفات Azure، يكون مسارها هو \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsx.

2. إذا قمت بتكوين الحزمة في ملف منفصل، تحتاج أيضاً إلى توفير مسار UNC إلى ملف التكوين الخاص بك (باستخدام .dtsConfig) في المربع مسار التكوين. يمكنك استعراض التكوين وتحديده عن طريق تحديد استعراض تخزين الملفات أو إدخال المسار يدوياً. على سبيل المثال، إذا قمت بتخزين التكوين الخاص بك في ملفات Azure، يكون المسار الخاص به هو \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.

3. حدد بيانات الاعتماد للوصول إلى ملفات الحزمة والتكوين. إذا قمت مسبقاً بإدخال قيم بيانات اعتماد تنفيذ الحزمة (لـ مصادقة Windows)، فيمكنك إعادة استخدامها عن طريق تحديد خانة الاختيار نفس بيانات اعتماد تنفيذ الحزمة. أو، أدخل القيم الخاصة ببيانات اعتماد الوصول إلى الحزمة في المربعات المجال وواسم المستخدم وكلمة المرور. على سبيل المثال، إذا قمت بتخزين الحزمة والتكوين في ملفات Azure، يكون المجال هو Azure، واسم المستخدم هو <storage account name> وكلمة المرور هي <storage account key>.

   بدلاً من ذلك، يمكنك استخدام الأسرار المخزنة في Azure Key Vault كقيم لها. للقيام بذلك، حدد خانة الاختيار AZURE KEY VAULT المجاورة لها. حدد أو حرر خدمة مرتبطة بالمخزن الرئيسي الموجود أو أنشئ خدمة جديدة. ثم حدد الاسم السري والإصدار لقيمتك. عند إنشاء خدمة مرتبطة بالمخزن الرئيسي أو تحريرها، يمكنك تحديد المخزن الرئيسي الموجود أو تحريره أو إنشاء مخزن جديد. تأكد من منح Data Factory الوصول إلى الهوية المدارة إلى المخزن الرئيسي إذا لم تكن قد فعلت ذلك بالفعل. يمكنك أيضاً إدخال سرك مباشرةً بالتنسيق التالي: <key vault linked service name>/<secret name>/<secret version>.

   يتم استخدام بيانات الاعتماد هذه أيضاً للوصول إلى الحزم التابعة في تنفيذ حزمة المهمة التي يتم الرجوع إليها بواسطة المسار الخاص بها وتكوينات أخرى محددة في الحزم الخاصة بك.

4. إذا كنت تستخدم مستوى الحماية EncryptAllWithPassword أو EncryptSensitiveWithPassword عند إنشاء الحزمة الخاصة بك عن طريق أدوات SQL Server Data Tools (SSDT)، أدخل قيمة كلمة المرور الخاصة بك في المربع كلمة مرور التشفير. بدلاً من ذلك، يمكنك استخدام سر مُخزن في Azure Key Vault كقيمة له (انظر أعلاه).

   إذا استخدمت مستوى الحماية EncryptSensitiveWithUserKey، قم بإعادة إدخال القيم الحساسة في ملفات التكوين أو على علامات التبويب معلمات SSIS أو مديري الاتصال أو منع الخاصية (انظر أدناه).

   إذا استخدمت مستوى الحماية EncryptAllWithUserKey فهو غير مدعوم. تحتاج إلى إعادة تكوين الحزمة لاستخدام مستوى حماية آخر عبر SSDT أو الأداة المساعدة لسطر الأوامر dtutil.

5. بالنسبة إلى مستوى التسجيل، حدد نطاق محدد مسبقاً لتسجيل تنفيذ الحزمة. حدد خانة الاختيار مخصص إذا كنت تريد إدخال اسم تسجيل الدخول المخصص بدلاً من ذلك.

6. إذا كنت ترغب في تسجيل تنفيذ الحزمة الخاصة بك باستخدام موفري السجل القياسي الذي يمكن تحديده في الحزمة الخاصة بك، حدد مجلد السجل الخاص بك عن طريق توفير مسار UNC الخاص به في المربع تسجيل المسار. يمكنك استعراض مجلد السجل وتحديده عن طريق تحديد استعراض تخزين الملفات أو إدخال مسارها يدوياً. على سبيل المثال، إذا قمت بتخزين السجلات الخاصة بك في ملفات Azure، يكون مسار التسجيل الخاص بك هو \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. يتم إنشاء مجلد فرعي في هذا المسار لكل تشغيل حزمة فردية، سميت بعد تنفيذ تشغيل معرف النشاط لحزمة SSIS، وفي أي ملفات السجل التي يتم إنشاؤها كل خمس دقائق.

7. حدد بيانات الاعتماد للوصول إلى مجلد السجل. إذا قمت مسبقاً بإدخال قيم بيانات اعتماد الوصول إلى الحزمة (راجع أعلاه)، يمكنك إعادة استخدامها عن طريق تحديد خانة الاختيار نفس بيانات اعتماد الوصول إلى الحزمة. أو، أدخل القيم الخاصة ببيانات اعتماد الوصول إلى تسجيل الحزمة في المربعات المجال واسم المستخدم وكلمة المرور. على سبيل المثال، إذا قمت بتخزين سجلاتك في ملفات Azure، يكون المجال هو Azure، واسم المستخدم هو <storage account name> وكلمة المرور هي <storage account key>. بدلاً من ذلك، يمكنك استخدام الأسرار المخزنة في Azure Key Vault كقيم لها (أنظر أعلاه).

بالنسبة لجميع مسارات UNC المذكورة مسبقاً، يجب أن يكون اسم الملف المؤهل بالكامل أقل من 260 حرفاً. يجب أن يكون اسم الدليل أقل من 248 حرفاً.

موقع الحزمة: نظام الملفات (المشروع)

إذا حددت نظام الملفات (المشروع) كموقع الحزمة، أكمل الخطوات التالية.

1. حدد الحزمة لتشغيلها عن طريق توفير مسار UNC إلى ملف المشروع الخاص بك (باستخدام .ispac) في مربع مسار المشروع وملف الحزمة (باستخدام .dtsx) من المشروع الخاص بك في المربع اسم الحزمة. يمكنك استعراض الحزمة وتحديدها عن طريق تحديد استعراض تخزين الملفات أو إدخال مسارها يدوياً. على سبيل المثال، إذا قمت بتخزين المشروع في ملفات Azure، يكون مسارها هو \\<storage account name>.file.core.windows.net\<file share name>\<project name>.ispac.

2. حدد بيانات الاعتماد للوصول إلى ملفات المشروع وحزمه. إذا قمت مسبقاً بإدخال قيم بيانات اعتماد تنفيذ الحزمة (لـ مصادقة Windows)، فيمكنك إعادة استخدامها عن طريق تحديد خانة الاختيار نفس بيانات اعتماد تنفيذ الحزمة. أو، أدخل القيم الخاصة ببيانات اعتماد الوصول إلى الحزمة في المربعات المجال وواسم المستخدم وكلمة المرور. على سبيل المثال، إذا قمت بتخزين المشروع والحزمة في ملفات Azure، يكون المجال هو Azure واسم المستخدم هو <storage account name> وكلمة المرور هي <storage account key>.

   بدلاً من ذلك، يمكنك استخدام الأسرار المخزنة في Azure Key Vault كقيم لها. للقيام بذلك، حدد خانة الاختيار AZURE KEY VAULT المجاورة لها. حدد أو حرر خدمة مرتبطة بالمخزن الرئيسي الموجود أو أنشئ خدمة جديدة. ثم حدد الاسم السري والإصدار لقيمتك. عند إنشاء خدمة مرتبطة بالمخزن الرئيسي أو تحريرها، يمكنك تحديد المخزن الرئيسي الموجود أو تحريره أو إنشاء مخزن جديد. تأكد من منح Data Factory الوصول إلى الهوية المدارة إلى المخزن الرئيسي إذا لم تكن قد فعلت ذلك بالفعل. يمكنك أيضاً إدخال سرك مباشرةً بالتنسيق التالي: <key vault linked service name>/<secret name>/<secret version>.

   يتم أيضاً استخدام بيانات الاعتماد هذه للوصول إلى الحزم التابعة في تنفيذ حزمة المهمة المشار إليها من نفس المشروع.

3. إذا كنت تستخدم مستوى الحماية EncryptAllWithPassword أو EncryptSensitiveWithPassword عند إنشاء الحزمة الخاصة بك عبر SSDT، أدخل قيمة كلمة المرور الخاصة بك في مربع كلمة مرور التشفير. بدلاً من ذلك، يمكنك استخدام سر مُخزن في Azure Key Vault كقيمة له (انظر أعلاه).

   إذا استخدمت مستوى الحماية EncryptSensitiveWithUserKey، قم بإعادة إدخال القيم الحساسة على علامات التبويب معلمات SSIS أو مديري الاتصال أو منع الخاصية (انظر أدناه).

   إذا استخدمت مستوى الحماية EncryptAllWithUserKey فهو غير مدعوم. تحتاج إلى إعادة تكوين الحزمة لاستخدام مستوى حماية آخر عبر SSDT أو الأداة المساعدة لسطر الأوامر dtutil.

4. بالنسبة إلى مستوى التسجيل، حدد نطاق محدد مسبقاً لتسجيل تنفيذ الحزمة. حدد خانة الاختيار مخصص إذا كنت تريد إدخال اسم تسجيل الدخول المخصص بدلاً من ذلك.

5. إذا كنت ترغب في تسجيل تنفيذ الحزمة الخاصة بك باستخدام موفري السجل القياسي الذي يمكن تحديده في الحزمة الخاصة بك، حدد مجلد السجل الخاص بك عن طريق توفير مسار UNC الخاص به في المربع تسجيل المسار. يمكنك استعراض مجلد السجل وتحديده عن طريق تحديد استعراض تخزين الملفات أو إدخال مسارها يدوياً. على سبيل المثال، إذا قمت بتخزين السجلات الخاصة بك في ملفات Azure، يكون مسار التسجيل الخاص بك هو \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. يتم إنشاء مجلد فرعي في هذا المسار لكل تشغيل حزمة فردية، سميت بعد تنفيذ تشغيل معرف النشاط لحزمة SSIS، وفي أي ملفات السجل التي يتم إنشاؤها كل خمس دقائق.

6. حدد بيانات الاعتماد للوصول إلى مجلد السجل. إذا قمت مسبقاً بإدخال قيم بيانات اعتماد الوصول إلى الحزمة (راجع أعلاه)، يمكنك إعادة استخدامها عن طريق تحديد خانة الاختيار نفس بيانات اعتماد الوصول إلى الحزمة. أو، أدخل القيم الخاصة ببيانات اعتماد الوصول إلى تسجيل الحزمة في المربعات المجال واسم المستخدم وكلمة المرور. على سبيل المثال، إذا قمت بتخزين سجلاتك في ملفات Azure، يكون المجال هو Azure، واسم المستخدم هو <storage account name> وكلمة المرور هي <storage account key>. بدلاً من ذلك، يمكنك استخدام الأسرار المخزنة في Azure Key Vault كقيم لها (أنظر أعلاه).

بالنسبة لجميع مسارات UNC المذكورة مسبقاً، يجب أن يكون اسم الملف المؤهل بالكامل أقل من 260 حرفاً. يجب أن يكون اسم الدليل أقل من 248 حرفاً.

موقع الحزمة: حزمة مضمنة

إذا حددت الحزمة المضمنة كموقع الحزمة، أكمل الخطوات التالية.

1. اسحب ملف الحزمة الخاص بك وأسقطه (باستخدام .dtsx) أو تحميل من مجلد ملف إلى المربع المتوفر. سيتم ضغط الحزمة تلقائياً وتضمينها في حمولة النشاط. بمجرد تضمينها، يمكنك تنزيل الحزمة لاحقاً لتحريرها. يمكنك أيضا Parameterize الحزمة المضمنة الخاصة بك عن طريق تعيينها إلى معلمة البنية الأساسية لبرنامج ربط العمليات التجارية التي يمكن استخدامها في أنشطة متعددة، وبالتالي تحسين حجم حمولة البنية الأساسية لبرنامج ربط العمليات التجارية الخاص بك. تضمين ملفات المشروع (باستخدام .ispac) غير مدعوم حالياً، لذلك لا يمكنك استخدام معلمات SSIS/مديري الاتصال مع نطاق مستوى المشروع في الحزم المضمنة.

2. إذا لم تكن الحزمة المضمنة مشفرة بالكامل وكشفنا عن استخدام تنفيذ مهمة الحزمة (EPT) فيها، سيتم تحديد خانة الاختيار تنفيذ مهمة الحزم تلقائياً وسيتم إضافة الحزم التابعة التي تتم الإشارة إليها بواسطة مسار نظام الملفات تلقائياً، حتى تتمكن أيضاً من تضمينها.

   إذا لم نتمكن من الكشف عن استخدام EPT، تحتاج إلى تحديد خانة الاختيار تنفيذ حزمة المهمة يدوياً وإضافة الحزم التابعة المُشار إليها بواسطة مسار نظام الملفات الخاص بهم واحداً تلو الآخر، حتى تتمكن أيضاً من تضمينها. إذا تم تخزين الحزم التابعة في قاعدة بيانات SQL Server (MSDB)، فلا يمكنك تضمينها، لذا يجب التأكد من أن AZURE-SSIS IR يمكنه الوصول إلى MSDB لإحضارها باستخدام مراجع SQL Server الخاصة بها. تضمين ملفات المشروع (باستخدام .ispac) غير مدعوم حالياً، لذا لا يمكنك استخدام مراجع تستند إلى المشروع للحزم التابعة.

3. إذا كنت تستخدم مستوى الحماية EncryptAllWithPassword أو EncryptSensitiveWithPassword عند إنشاء الحزمة الخاصة بك عبر SSDT، أدخل قيمة كلمة المرور الخاصة بك في مربع كلمة مرور التشفير.

   بدلاً من ذلك، يمكنك استخدام الأسرار المخزنة في Azure Key Vault كقيم لها. للقيام بذلك، حدد خانة الاختيار AZURE KEY VAULT المجاورة لها. حدد أو حرر خدمة مرتبطة بالمخزن الرئيسي الموجود أو أنشئ خدمة جديدة. ثم حدد الاسم السري والإصدار لقيمتك. عند إنشاء خدمة مرتبطة بالمخزن الرئيسي أو تحريرها، يمكنك تحديد المخزن الرئيسي الموجود أو تحريره أو إنشاء مخزن جديد. تأكد من منح Data Factory الوصول إلى الهوية المدارة إلى المخزن الرئيسي إذا لم تكن قد فعلت ذلك بالفعل. يمكنك أيضاً إدخال سرك مباشرةً بالتنسيق التالي: <key vault linked service name>/<secret name>/<secret version>.

   إذا استخدمت مستوى الحماية EncryptSensitiveWithUserKey، قم بإعادة إدخال القيم الحساسة في ملفات التكوين أو على علامات التبويب معلمات SSIS أو مديري الاتصال أو منع الخاصية (انظر أدناه).

   إذا استخدمت مستوى الحماية EncryptAllWithUserKey فهو غير مدعوم. تحتاج إلى إعادة تكوين الحزمة لاستخدام مستوى حماية آخر عبر SSDT أو الأداة المساعدة لسطر الأوامر dtutil.

4. بالنسبة إلى مستوى التسجيل، حدد نطاق محدد مسبقاً لتسجيل تنفيذ الحزمة. حدد خانة الاختيار مخصص إذا كنت تريد إدخال اسم تسجيل الدخول المخصص بدلاً من ذلك.

5. إذا كنت ترغب في تسجيل تنفيذ الحزمة الخاصة بك باستخدام موفري السجل القياسي الذي يمكن تحديده في الحزمة الخاصة بك، حدد مجلد السجل الخاص بك عن طريق توفير مسار UNC الخاص به في المربع تسجيل المسار. يمكنك استعراض مجلد السجل وتحديده عن طريق تحديد استعراض تخزين الملفات أو إدخال مسارها يدوياً. على سبيل المثال، إذا قمت بتخزين السجلات الخاصة بك في ملفات Azure، يكون مسار التسجيل الخاص بك هو \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. يتم إنشاء مجلد فرعي في هذا المسار لكل تشغيل حزمة فردية، سميت بعد تنفيذ تشغيل معرف النشاط لحزمة SSIS، وفي أي ملفات السجل التي يتم إنشاؤها كل خمس دقائق.

6. حدد بيانات الاعتماد للوصول إلى مجلد السجل الخاص بك عن طريق إدخال قيمها في المربعات المجال واسم المستخدم وكلمة المرور. على سبيل المثال، إذا قمت بتخزين سجلاتك في ملفات Azure، يكون المجال هو Azure، واسم المستخدم هو <storage account name> وكلمة المرور هي <storage account key>. بدلاً من ذلك، يمكنك استخدام الأسرار المخزنة في Azure Key Vault كقيم لها (أنظر أعلاه).

بالنسبة لجميع مسارات UNC المذكورة مسبقاً، يجب أن يكون اسم الملف المؤهل بالكامل أقل من 260 حرفاً. يجب أن يكون اسم الدليل أقل من 248 حرفاً.

موقع الحزمة: مخزن الحزمة

إذا قمت بتحديد مخزن الحزم كموقع الحزمة، أكمل الخطوات التالية.

1. بالنسبة إلى اسم مخزن الحزمة، حدد مخزن حزمة موجود مرفق بـ Azure-SSIS IR.

2. حدد الحزمة لتشغيلها عن طريق توفير مسارها (بدون استخدام .dtsx) من مخزن الحزمة المحدد في المربع مسار الحزمة. إذا كان مخزن الحزمة المحددة أعلى نظام الملفات/ملفات Azure، يمكنك استعراض الحزمة وتحديدها عن طريق تحديد استعراض تخزين الملفات أو يمكنك إدخال مسارها بتنسيق <folder name>\<package name>. يمكنك أيضاً استيراد حزم جديدة إلى مخزن الحزم المحددة عبر SQL Server Management Studio (SSMS) المشابهة لـ متجر حزمة SSIS القديم. لمزيد من المعلومات، راجع إدارة حزم SSIS بواسطة مخازن حزم Azure-SSIS IR.

3. إذا قمت بتكوين الحزمة في ملف منفصل، تحتاج أيضاً إلى توفير مسار UNC إلى ملف التكوين الخاص بك (باستخدام .dtsConfig) في المربع مسار التكوين. يمكنك استعراض التكوين وتحديده عن طريق تحديد استعراض تخزين الملفات أو إدخال المسار يدوياً. على سبيل المثال، إذا قمت بتخزين التكوين الخاص بك في ملفات Azure، يكون المسار الخاص به هو \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.

4. حدد خانة الاختيار تكوين الوصول إلى بيانات الاعتماد لاختيار ما إذا كنت تريد تحديد بيانات الاعتماد للوصول إلى ملف التكوين بشكل منفصل. هذا مطلوباً عندما يكون مخزن الحزمة المحددة أعلى قاعدة بيانات SQL Server (MSDB) التي يستضيفها Azure SQL المثيل المُدار أو لا يقوم أيضاً بتخزين ملف التكوين الخاص بك.

   إذا قمت مسبقاً بإدخال قيم بيانات اعتماد تنفيذ الحزمة (لـ مصادقة Windows)، فيمكنك إعادة استخدامها عن طريق تحديد خانة الاختيار نفس بيانات اعتماد تنفيذ الحزمة. أو، أدخل القيم الخاصة ببيانات اعتماد الوصول إلى التكوين في المربعات المجال واسم المستخدم وكلمة المرور. على سبيل المثال، إذا قمت بتخزين التكوين الخاص بك في ملفات Azure، يكون المجال هو Azure، واسم المستخدم هو <storage account name> وكلمة المرور هي <storage account key>.

   بدلاً من ذلك، يمكنك استخدام الأسرار المخزنة في Azure Key Vault كقيم لها. للقيام بذلك، حدد خانة الاختيار AZURE KEY VAULT المجاورة لها. حدد أو حرر خدمة مرتبطة بالمخزن الرئيسي الموجود أو أنشئ خدمة جديدة. ثم حدد الاسم السري والإصدار لقيمتك. عند إنشاء خدمة مرتبطة بالمخزن الرئيسي أو تحريرها، يمكنك تحديد المخزن الرئيسي الموجود أو تحريره أو إنشاء مخزن جديد. تأكد من منح Data Factory الوصول إلى الهوية المدارة إلى المخزن الرئيسي إذا لم تكن قد فعلت ذلك بالفعل. يمكنك أيضاً إدخال سرك مباشرةً بالتنسيق التالي: <key vault linked service name>/<secret name>/<secret version>.

5. إذا كنت تستخدم مستوى الحماية EncryptAllWithPassword أو EncryptSensitiveWithPassword عند إنشاء الحزمة الخاصة بك عبر SSDT، أدخل قيمة كلمة المرور الخاصة بك في مربع كلمة مرور التشفير. بدلاً من ذلك، يمكنك استخدام سر مُخزن في Azure Key Vault كقيمة له (انظر أعلاه).

   إذا استخدمت مستوى الحماية EncryptSensitiveWithUserKey، قم بإعادة إدخال القيم الحساسة في ملفات التكوين أو على علامات التبويب معلمات SSIS أو مديري الاتصال أو منع الخاصية (انظر أدناه).

   إذا استخدمت مستوى الحماية EncryptAllWithUserKey فهو غير مدعوم. تحتاج إلى إعادة تكوين الحزمة لاستخدام مستوى حماية آخر عبر SSDT أو الأداة المساعدة لسطر الأوامر dtutil.

6. بالنسبة إلى مستوى التسجيل، حدد نطاق محدد مسبقاً لتسجيل تنفيذ الحزمة. حدد خانة الاختيار مخصص إذا كنت تريد إدخال اسم تسجيل الدخول المخصص بدلاً من ذلك.

7. إذا كنت ترغب في تسجيل تنفيذ الحزمة الخاصة بك باستخدام موفري السجل القياسي الذي يمكن تحديده في الحزمة الخاصة بك، حدد مجلد السجل الخاص بك عن طريق توفير مسار UNC الخاص به في المربع تسجيل المسار. يمكنك استعراض مجلد السجل وتحديده عن طريق تحديد استعراض تخزين الملفات أو إدخال مسارها يدوياً. على سبيل المثال، إذا قمت بتخزين السجلات الخاصة بك في ملفات Azure، يكون مسار التسجيل الخاص بك هو \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>. يتم إنشاء مجلد فرعي في هذا المسار لكل تشغيل حزمة فردية، سميت بعد تنفيذ تشغيل معرف النشاط لحزمة SSIS، وفي أي ملفات السجل التي يتم إنشاؤها كل خمس دقائق.

8. حدد بيانات الاعتماد للوصول إلى مجلد السجل الخاص بك عن طريق إدخال قيمها في المربعات المجال واسم المستخدم وكلمة المرور. على سبيل المثال، إذا قمت بتخزين سجلاتك في ملفات Azure، يكون المجال هو Azure، واسم المستخدم هو <storage account name> وكلمة المرور هي <storage account key>. بدلاً من ذلك، يمكنك استخدام الأسرار المخزنة في Azure Key Vault كقيم لها (أنظر أعلاه).

بالنسبة لجميع مسارات UNC المذكورة مسبقاً، يجب أن يكون اسم الملف المؤهل بالكامل أقل من 260 حرفاً. يجب أن يكون اسم الدليل أقل من 248 حرفاً.

علامة تبويب معلمات SSIS

في علامة التبويب معلمات SSIS من تنفيذ نشاط حزمة SSIS، أكمل الخطوات التالية.

1. إذا كان يتم تشغيل وقت تشغيل التكامل Azure-SSIS، يتم تحديد SSISDB كموقع الحزمة الخاصة بك، ويتم مسح خانة الاختيار إدخالات يدوية على علامة التبويب الإعدادات، يتم عرض المعلمات SSIS الموجودة في المشروع المُحدد وحزمة من SSISDB لك لتعيين القيم لهم. أو، يمكنك إدخالها واحداً تلو الآخر لتعيين قيم لها يدوياً. تأكد من وجودها وإدخالها بشكل صحيح لتنفيذ الحزمة الخاصة بك لتحقيق النجاح.

2. إذا كنت تستخدم مستوى الحماية EncryptSensitiveWithUserKey عند إنشاء الحزمة الخاصة بك عبرSSDT نظام الملفات (الحزمة) أو نظام الملفات (المشروع) أو الحزمة المضمنة أو تم تحديد مخزن الحزمة كموقع الحزمة، فستحتاج أيضاً إلى إعادة إدخال المعلمات الحساسة لتعيين القيم لها في علامة التبويب هذه.

عند تعيين قيم إلى المعلمات الخاصة بك، يمكنك إضافة محتوى حيوي باستخدام التعبيرات، الوظائف، متغيرات نظام Data Factory، ومعلمات مسار أو متغيرات Data Factory.

بدلاً من ذلك، يمكنك استخدام الأسرار المخزنة في Azure Key Vault كقيم لها. للقيام بذلك، حدد خانة الاختيار AZURE KEY VAULT المجاورة لها. حدد أو حرر خدمة مرتبطة بالمخزن الرئيسي الموجود أو أنشئ خدمة جديدة. ثم حدد الاسم السري والإصدار لقيمتك. عند إنشاء خدمة مرتبطة بالمخزن الرئيسي أو تحريرها، يمكنك تحديد المخزن الرئيسي الموجود أو تحريره أو إنشاء مخزن جديد. تأكد من منح Data Factory الوصول إلى الهوية المدارة إلى المخزن الرئيسي إذا لم تكن قد فعلت ذلك بالفعل. يمكنك أيضاً إدخال سرك مباشرةً بالتنسيق التالي: <key vault linked service name>/<secret name>/<secret version>.

علامة التبويب إدارة الاتصالات

في علامة التبويب إدارة الاتصالات من تنفيذ نشاط حزمة SSIS، أكمل الخطوات التالية.

1. إذا كان وقت تشغيل التكامل AZURE-SSIS قيد التشغيل، يتم تحديد SSISDB كموقع الحزمة الخاصة بك، ويتم مسح خانة الاختيار إدخالات يدوية على علامة التبويب الإعدادات، يتم عرض إدارة الاتصالات الموجودة في المشروع المُحدد وحزمة من SSISDB لك لتعيين القيم إلى خصائصها. أو، يمكنك إدخالها واحداً تلو الآخر لتعيين قيم لخصائصها يدوياً. تأكد من وجودها وإدخالها بشكل صحيح لتنفيذ الحزمة الخاصة بك لتحقيق النجاح.

   يمكنك الحصول على أسماء النطاق والاسم والخاصية لأي إدارة اتصالات عن طريق فتح الحزمة التي تحتوي على SSDT. بعد فتح الحزمة، حدد إدارة الاتصالات ذات الصلة لإظهار الأسماء والقيم لجميع خصائصه على نافذة خصائص SSDT. باستخدام هذه المعلومات، يمكنك تجاوز قيم أي خصائص إدارة اتصالات في وقت التشغيل.

   

   على سبيل المثال، دون تعديل الحزمة الأصلية على SSDT، يمكنك تحويل تدفقات البيانات المحلية الخاصة بها التي تعمل على SQL Server إلى تدفقات بيانات محلية إلى السحابة تعمل على وقت تشغيل التكامل SSIS في ADF عن طريق تجاوز قيم ConnectByProxy وConnectionString وConnectUsingManagedIdentity في إدارة الاتصالات الحالية في وقت التشغيل.

   يمكن لتجاوزات وقت التشغيل هذه تمكين وقت تشغيل التكامل المستضاف ذاتيا (SHIR) كوكيل لوقت تشغيل تكامل SSIS عند الوصول إلى البيانات محليا، راجع تكوين SHIR كوكيل ل SSIS IR، واتصالات Azure SQL Database/Managed Instance باستخدام أحدث برنامج تشغيل MSOLEDBSQL الذي بدوره يمكن مصادقة Microsoft Entra باستخدام الهوية المدارة ل ADF، راجع تكوين مصادقة Microsoft Entra باستخدام الهوية المدارة ل ADF لاتصالات OLEDB.

   

2. إذا كنت تستخدم مستوى الحماية EncryptSensitiveWithUserKey عند إنشاء الحزمة الخاصة بك عبرSSDT نظام الملفات (الحزمة) أو نظام الملفات (المشروع) أو الحزمة المضمنة أو تم تحديد مخزن الحزمة كموقع الحزمة، فستحتاج أيضاً إلى إعادة إدخال خصائص إدارة الاتصالات الحساسة لتعيين القيم لها في علامة التبويب هذه.

عند تعيين قيم إلى خصائص إدارة الاتصالات الخاصة بك، يمكنك إضافة محتوى حيوي باستخدام التعبيرات، الوظائف، متغيرات نظام Data Factory، ومعلمات مسار أز متغيرات Data Factory.

بدلاً من ذلك، يمكنك استخدام الأسرار المخزنة في Azure Key Vault كقيم لها. للقيام بذلك، حدد خانة الاختيار AZURE KEY VAULT المجاورة لها. حدد أو حرر خدمة مرتبطة بالمخزن الرئيسي الموجود أو أنشئ خدمة جديدة. ثم حدد الاسم السري والإصدار لقيمتك. عند إنشاء خدمة مرتبطة بالمخزن الرئيسي أو تحريرها، يمكنك تحديد المخزن الرئيسي الموجود أو تحريره أو إنشاء مخزن جديد. تأكد من منح Data Factory الوصول إلى الهوية المدارة إلى المخزن الرئيسي إذا لم تكن قد فعلت ذلك بالفعل. يمكنك أيضاً إدخال سرك مباشرةً بالتنسيق التالي: <key vault linked service name>/<secret name>/<secret version>.

علامة التبويب تجاوزات الخاصية

في علامة التبويب تجاوزات الخاصية من تنفيذ نشاط حزمة SSIS، أكمل الخطوات التالية.

1. أدخل مسارات الخصائص الموجودة في الحزمة المحددة واحداً تلو الآخر لتعيين قيم لها يدوياً. تأكد من وجودها وإدخالها بشكل صحيح لتنفيذ الحزمة الخاصة بك لتحقيق النجاح. على سبيل المثال، لتجاوز قيمة متغير المستخدم، أدخل مساره بالتنسيق التالي: \Package.Variables[User::<variable name>].Value.

   يمكنك الحصول على مسار الخاصية الصحيحة لأي خاصية حزمة عن طريق فتح الحزمة التي تحتوي على SSDT. بعد فتح الحزمة، حدد تدفق عنصر التحكم الخاص به والخاصية تكوينات على نافذة خصائص SSDT. بعد ذلك، حدد الزر علامة القطع (...) بجوار خاصية التكوينات الخاصة به لفتح منظم تكوينات الحزمة الذي يستخدم عادةً لإنشاء تكوينات الحزمة في نموذج نشر الحزمة.

   

   في منظم تكوينات الحزم، حدد خانة الاختيار تمكين تكوينات الحزمة والزر إضافة... لفتح معالج تكوين الحزمة.

   في Package Configuration Wizard، حدد عنصر XML configuration file في القائمة المنسدلة Configuration type وزر تحديد إعدادات التكوين مباشرة، أدخل اسم ملف التكوين الخاص بك، وحدد الزر Next >.

   

   أخيراً، حدد خصائص الحزمة التي تريد مسارها ثم حدد الزر Next >. يمكنك الآن مشاهدة نسخ ولصق مسارات خاصية الحزمة التي تريدها وحفظها في ملف التكوين الخاص بك. باستخدام هذه المعلومات، يمكنك تجاوز قيم أي خصائص للحزمة في وقت التشغيل.

   

2. إذا كنت تستخدم مستوى الحماية EncryptSensitiveWithUserKey عند إنشاء الحزمة الخاصة بك عبر نظام الملفات وSSDT (الحزمة) أو نظام الملفات (المشروع)أو الحزمة المضمنة أو تم تحديد مخزن الحزمة كموقع الحزمة، فأنت بحاجة أيضاً إلى إعادة إدخال خصائص الحزمة الحساسة لتعيين القيم لهم في علامة التبويب هذه.

عند تعيين قيم إلى خصائص الحزمة الخاصة بك، يمكنك إضافة محتوى حيوي باستخدام التعبيرات، الوظائف، متغيرات نظام Data Factory، ومعلمات مسار أو متغيرات Data Factory.

يمكن تجاوز القيم المعينة في ملفات التكوين وعلى علامة التبويب معلمات SSIS باستخدام علامات التبويب إدارة الاتصالات أو تجاوزات الخاصية. يمكن أيضاً تجاوز القيم المعينة في علامة التبويب إدارة الاتصالات باستخدام علامة التبويب تجاوزات الخاصية.

للتحقق من صحة تكوين البنية الأساسية، حدد التحقق على شريط الأدوات. لإغلاق نافذة تقرير التحقق من صحة البنية الأساسية ، حدد >>.

لنشر البنية الأساسية إلى Data Factory، حدد نشر الكل.

قم بتشغيل البنية الأساسية

في هذه الخطوة، ستقوم بتشغيل التدفق.

1. لبدء تشغيل البنية الأساسية، انقر فوق مشغّل في شريط الأدوات، ثم حدد مشغّل الآن.

   

2. في نافذة تشغيل "تدفقات"، حدد إنهاء.

مراقبة المسار

1. يمكنك التبديل إلى علامة التبويب "Monitor" في الجهة اليسرى. تشاهد تشغيل البنية الأساسية وحالتها مع معلومات أخرى، مثل وقت تشغيل البدء. لإعادة تنشيط طريقة العرض، حدد Refresh.

   

2. حدد الارتباط عرض تشغيل النشاط في العمود الإجراءات. تشاهد نشاط واحد فقط قيد التشغيل لأن البنية الأساسية لديها نشاط واحد فقط. إنه نشاط حزمة تنفيذ SSIS.

   

3. قم بتشغيل الاستعلام التالي مقابل قاعدة بيانات SSISDB في خادم SQL للتحقق من تنفيذ الحزمة.

   select * from catalog.executions
   

   

4. يمكنك أيضا الحصول على معرف تنفيذ SSISDB من إخراج تشغيل نشاط البنية الأساسية واستخدام معرف للتحقق من سجلات التنفيذ أكثر شمولاً ورسائل الخطأ في SQL Server Management Studio.

   

جدولة البنية الأساسية مع المشغل

يمكنك أيضاً إنشاء مشغل مجدول للبنية الأساسية بحيث يتم تشغيل البنية الأساسية على جدول زمني، مثل كل ساعة أو يومياً. للحصول على مثال، راجع إنشاء مصنع بيانات - واجهة مستخدم مصنع البيانات .

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

• تشغيل حزمة SSIS مع تنفيذ نشاط حزمة SSIS في Azure Data Factory مع PowerShell
• تحديث وتوسيع سير عمل ETL / ELT باستخدام أنشطة SSIS في البنية الأساسية لبرنامج ربط العمليات التجارية لـ Azure Data Factory