پارامترهای پروژه SSIS در برابر پارامترهای بسته SSIS
در این مثال، قصد داریم نحوه ایجاد یا پیکربندی پارامترهای پروژه SSIS و پارامترهای بسته SSIS را نشان دهیم. همچنین تفاوت بین پارامترهای پروژه و بسته در SSIS را نیز توضیح خواهیم داد.
پارامترهای پروژه SSIS در برابر پارامترهای بسته SSIS
در SSIS، پارامترها به دو نوع تقسیم می‌شوند: پارامترهای پروژه و پارامترهای بسته.
پارامترهای پروژه چیزی شبیه به Global هستند. می‌توانید از هر بسته‌ای که در آن پروژه وجود دارد به آن‌ها دسترسی داشته باشید.
پارامترهای بسته مشابه متغیرهای محلی (local variables) هستند. فقط می‌توانید از همان بسته‌ای که آن‌ها را ایجاد کرده‌اید به آن‌ها دسترسی داشته باشید. برای مثال نمی‌توانید به پارامتر بسته‌ای که در pakage1.dtsx ایجاد شده، از طریق pakage2.dtsx دسترسی داشته باشید.
پارامترهای پروژه SSIS
در اینجا، مراحل مربوط به ایجاد پارامترهای پروژه در SSIS را نشان خواهیم داد. اگر به Solution Explorer نگاه کنید، فایل Project.params را مشاهده می‌کنید.
برای ایجاد پارامتر پروژه SSIS، روی Project.params راست‌کلیک کرده و گزینه View Designer را از منوی زمینه انتخاب کنید.
زمانی که روی گزینه View Designer کلیک می‌کنید، پنجره‌ای مانند تصویر زیر باز خواهد شد. از این پنجره می‌توانید برای مشاهده پارامترهای پروژه موجود، ایجاد پارامتر جدید، ویرایش پارامترهای موجود یا حذف آن‌ها استفاده کنید.
در تصویر زیر، با کلیک روی دکمه New در حال ایجاد یک پارامتر جدید برای پروژه هستیم.
ما نام را برابر با ProjectMessage، نوع داده (Data Type) را string، و مقدار (value) را برابر با Hey!! This is the SSIS Project parameter. قرار دادیم. لطفاً برای ذخیره پارامتر پروژه، روی دکمه Save کلیک کنید.
اکنون می‌توانید از این پارامتر پروژه، یعنی ProjectMessage، در تمام بسته‌هایی که در پوشه SSIS Packages قرار دارند استفاده کنید.
پارامترهای بسته SSIS
در این مثال، مراحل مربوط به ایجاد پارامترهای بسته در SSIS را نشان خواهیم داد. برای این کار، یک بسته جدید ایجاد می‌کنیم.
اگر به تصویر زیر دقت کنید، هر بسته جدید دارای یک تب به نام Parameters است. می‌توانید از این تب برای ایجاد پارامترهایی در سطح بسته استفاده کنید. لطفاً برای ایجاد یک پارامتر، روی این تب کلیک کنید.
رابط کاربری برای ایجاد پارامترهای سطح بسته و سطح پروژه یکسان است. لطفاً برای ایجاد یک پارامتر جدید، روی دکمه New کلیک کنید.
همان‌طور که در تصویر زیر مشاهده می‌کنید، یک پارامتر جدید به نام PackageMessage از نوع string ایجاد کردیم و مقدار آن Hi!! This is a Package message. می‌باشد.
پارامترهای پروژه SSIS در برابر پارامترهای بسته SSIS
در اینجا از Script Task برای نمایش پیامی استفاده می‌کنیم که شامل داده‌هایی از هر دو نوع پارامتر پروژه و پارامتر بسته باشد. برای انجام این کار، Script Task را از Toolbox بکشید و در ناحیه Control Flow رها کنید.
با دوبار کلیک روی Script Task، ویرایشگر زیر برای پیکربندی اجزای Script Task باز خواهد شد. ما قبلاً مراحل پیکربندی Script Task را در مقاله قبلی توضیح داده‌ایم، بنابراین لطفاً به همان مقاله مراجعه کنید.
در اینجا می‌خواهیم پارامترهایی را که قبلاً ایجاد کرده‌ایم انتخاب کنیم. بنابراین لطفاً روی دکمه … (Browse) در کنار ویژگی ReadOnlyVariables کلیک کنید.
در اینجا هر دو پارامتر پروژه و پارامتر بسته را به عنوان متغیرهای Read-Only انتخاب می‌کنیم.
پس از انتخاب متغیرهای مورد نظر، لطفاً روی دکمه Edit Script… کلیک کنید تا کد واقعی C# یا VB Script را بنویسید.
در اینجا از Message Box برای نمایش پیام در یک پاپ‌آپ استفاده می‌کنیم. کدی که در C# در تصویر زیر استفاده کرده‌ایم به شرح زیر است:
برای اتمام پیکربندی بسته SSIS Project Vs Package Parameters، روی OK کلیک کنید. حالا می‌توانیم بسته را اجرا کنیم.
روی OK کلیک کنید تا پیکربندی بسته SSIS Project Vs Package Parameters تمام شود. حالا بیایید بسته را اجرا کنیم.
اجازه دهید بسته دیگری را در این پروژه باز کنم. همان‌طور که در تصویر زیر مشاهده می‌کنید، این بسته همان بسته‌ای است که در مقاله Execute Task in Single Rowset ایجاد کرده‌ایم.
اجازه دهید تلاش کنم تا از این Script Task به پارامترهایی که قبلاً ایجاد کرده‌ایم دسترسی پیدا کنم. همان‌طور که در تصویر زیر مشاهده می‌کنید، می‌توانیم به پارامتر پروژه دسترسی داشته باشیم اما به پارامترهای بسته دسترسی نداریم.
دیدگاهتان را بنویسید