Виконання пакета служб SSIS із кодом C# у додатку .NET
У цьому короткому посібнику показано, як написати код C# для підключення до сервера бази даних та для виконання пакету SSIS.
Щоб створити програму C#, можна використовувати Visual Studio, Visual Studio Code або інший засіб.
Необхідні компоненти
Перш ніж почати, переконайтеся, що у вас встановлено засіб Visual Studio або Visual Studio Code. Завантажте безкоштовний випуск Community засоби Visual Studio або безкоштовний засіб Visual Studio Code на сторінці завантаження Visual Studio.
Сервер Бази даних SQL Azure прослуховує порт 1433. Якщо ви намагаєтеся підключитися до сервера бази даних SQL Azure зсередини корпоративного брандмауера, для успішного підключення цього брандмауера повинен бути відкритий даний порт.
Отримання інформації про підключення для бази даних SQL Azure
Для запуску пакета в базі даних SQL Azure вам потрібна інформація, необхідна для підключення до бази даних каталогу служб SSIS (SSISDB). У наведених нижче процедурах вам знадобиться повне ім'я сервера та ім'я для входу.
- Увійдіть на портал Azure.
- Виберіть Бази даних SQL у меню зліва, а потім на сторінці Бази даних SQL - базу даних SSISDB.
- На сторінці Огляд Для бази даних перегляньте повне ім'я сервера. Щоб побачити параметр Клацніть, щоб скопіюватинаведіть вказівник миші на ім'я сервера.
- Якщо ви забули дані для входу на сервер бази даних SQL Azure, перейдіть на відповідну сторінку, щоб переглянути ім'я адміністратора сервера. За потреби ви можете скинути пароль.
- Клацніть Показати рядки підключення до баз даних.
- Перегляньте повний рядок підключення ADO.NET. У прикладі коду також можна використовувати SqlConnectionStringBuilder , щоб відтворити цей рядок підключення із зазначеними вами параметрами.
Створення проекту Visual Studio
- У Visual Studio виберіть Файл, Створити, Проект.
- У діалоговому вікні Створення проекту розгорніть вузол Visual C#.
- Виберіть Консольний додаток і введіть run_ssis_project як ім'я проекту.
- Натисніть кнопку ОК, щоб створити та відкрити проект у Visual Studio.
Додавання посилань
- У браузері рішень клацніть правою кнопкою миші папку Посилання та виберіть Додати посилання. Відкривається діалогове вікно Диспетчер посилань.
- У вікні Диспетчер посилань розгорніть вузол Складання та виберіть Розширення.
- Виберіть наступні два посилання, щоб додати:
- Microsoft.SqlServer.Management.Sdk.Sfc
- Microsoft.SqlServer.Smo
- Натисніть кнопку Огляд, щоб додати посилання на Microsoft.SqlServer.Management.IntegrationServices. (Ця збірка встановлюється лише у глобальний кеш збірок.) Відкривається діалогове вікно Виберіть файли, на які потрібно встановити посилання.
- У діалоговому вікні Виберіть файли, на які потрібно встановити посилання перейдіть до папки глобального кешу збірок, що містить потрібну збірку. Зазвичай це папка C:\Windows\assembly\GAC_MSIL\Microsoft.SqlServer.Management.IntegrationServices\14.0.0.0__89845dcd8080cc91 .
- Виберіть збірку (DLL-файл) у папці та натисніть кнопку Додати.
- Натисніть кнопку ОК, щоб закрити діалогове вікно Диспетчер посилань та додати три посилання. Щоб переконатися, що посилання на місці, перевірте список Посилання в браузері рішень.
Додавання коду C#
- Відкрийте Program.cs.
- Замініть вміст Program.cs наведеним нижче кодом. Додайте відповідні значення для сервера, бази даних, користувача та пароля.
У цьому прикладі використовується автентифікація Windows. Щоб використовувати автентифікацію SQL Server, замініть аргумент Integrated Security=SSPI; на User name>;Password=; . Якщо ви підключаєтеся до сервера бази даних SQL Azure, ви не можете використовувати автентифікацію Windows.
using Microsoft.SqlServer.Management.IntegrationServices; using System.Data.SqlClient; namespace run_ssis_package < class Program < static void Main(string[] args) < // Variables string targetServerName = "localhost"; string folderName = "Project1Folder"; string projectName = "Integration Services Project1"; string packageName = "Package.dtsx"; // Create a connection to the server string sqlConnectionString = "Data Source=" + targetServerName + ";Initial Catalog=master;Integrated Security=SSPI;"; SqlConnection sqlConnection = новий SqlConnection(sqlConnectionString); // Create the Integration Services object IntegrationServices integrationServices = new IntegrationServices(sqlConnection); // Get the Integration Services catalog Catalog catalog = integrationServices.Catalogs["SSISDB"]; // Get the folder CatalogFolder folder = catalog.Folders[folderName]; // Get the project ProjectInfo project = folder.Projects[projectName]; // Get the package PackageInfo package = project.Packages[packageName]; // Run the package package.Execute(false, null); >> >
Виконання коду
- Щоб запустити програму, натисніть клавішу F5.
- Переконайтеся, що пакет виконується правильно, а потім закрийте вікно програми.
Наступні кроки
- Розгляньте інші варіанти виконання пакета.
- Виконання пакета служб SSIS за допомогою SSMS
- Виконання пакета служб SSIS за допомогою Transact-SQL (SSMS)
- Виконання пакета служб SSIS за допомогою Transact-SQL (Visual Studio Code)
- Виконання пакета служб SSIS із командного рядка
- Виконання пакета служб SSIS за допомогою PowerShell
Виконання пакета служб SSIS за допомогою SQL Server Management Studio (SSMS)
Цей короткий посібник показує, як підключитися до бази даних каталогу служб SSIS за допомогою SQL Server Management Studio (SSMS), а потім запустити пакет служб SSIS, що зберігається в каталозі SSIS, з оглядача об'єктів SSMS.
SQL Server Management Studio – це інтегроване середовище для керування будь-якою інфраструктурою SQL, від SQL Server до бази даних SQL.Для отримання додаткових відомостей про SSMS див. у розділі SQL Server Management Studio (SSMS).
Необхідні компоненти
Перш ніж почати, перевірте наявність останньої версії SQL Server Management Studio (SSMS). Щоб завантажити середовище SSMS, відвідайте сторінку Завантаження SQL Server Management Studio (SSMS).
Сервер Бази даних SQL Azure прослуховує порт 1433. Якщо ви намагаєтеся підключитися до сервера бази даних SQL Azure зсередини корпоративного брандмауера, для успішного підключення цього брандмауера повинен бути відкритий даний порт.
Підтримувані платформи
Відомості, наведені в цьому посібнику, можна використовувати для виконання пакету SSIS на наступних платформах:
- SQL Server у Windows.
- База даних SQL Azure. Додаткові відомості про розгортання та запуск пакетів в Azure див. у розділі Перенесення робочих навантажень SQL Server Integration Services у хмару.
Відомості, наведені в цьому посібнику, не можуть бути використані для виконання пакету SSIS в Linux. Додаткові відомості про запуск пакетів на Linux див. у розділі Вилучення, перетворення та завантаження даних у Linux за допомогою служб SSIS.
Отримання інформації про підключення для бази даних SQL Azure
Для запуску пакета в базі даних SQL Azure вам потрібна інформація, необхідна для підключення до бази даних каталогу служб SSIS (SSISDB). У наведених нижче процедурах вам знадобиться повне ім'я сервера та ім'я для входу.
- Увійдіть на портал Azure.
- Виберіть Бази даних SQL у меню зліва, а потім на сторінці Бази даних SQL - базу даних SSISDB.
- На сторінці Огляд Для бази даних перегляньте повне ім'я сервера. Щоб побачити параметр Клацніть, щоб скопіюватинаведіть вказівник миші на ім'я сервера.
- Якщо ви забули дані для входу на сервер бази даних SQL Azure, перейдіть на відповідну сторінку, щоб переглянути ім'я адміністратора сервера.
Підключення до бази даних SSISDB
За допомогою SQL Server Management Studio встановіть з'єднання з каталогом служб SSIS.
- Відкрийте Середовище SQL Server Management Studio.
- У діалоговому вікні З'єднання з сервером введіть такі дані:
| Параметр |
Пропоноване значення |
Додаткова інформація |
| Тип сервера |
Ядро СУБД. |
Це значення є обов'язковим. |
| Ім'я сервера |
Повне ім'я сервера |
При підключенні до сервера бази даних SQL Azure використовуйте наступний формат імені: .database.windows.net. |
| Аутентифікація |
Перевірка автентичності SQL Server |
Використовуйте автентифікацію SQL Server для підключення до SQL Server або бази даних SQL Azure. |
| Ім'я входу |
Обліковий запис адміністратора сервера |
Це обліковий запис, який було вказано під час створення сервера. |
| Пароль |
Пароль для облікового запису адміністратора сервера |
Це пароль, який було вказано під час створення сервера. |
Запуск пакету
- Виберіть пакет, який потрібно запустити, у браузері об'єктів.
- Клацніть правою кнопкою миші та виберіть команду Виконати. Відкривається діалогове вікно. Виконання пакету.
- Налаштуйте виконання пакета за допомогою параметрів на вкладках Параметри, Диспетчери з'єднань і Розширені діалогового вікна "Виконання пакета".
- Натисніть кнопку ОК, щоб виконати пакет.
Наступні кроки
- Розгляньте інші варіанти виконання пакета.
- Виконання пакета служб SSIS за допомогою Transact-SQL (SSMS)
- Виконання пакета служб SSIS за допомогою Transact-SQL (Visual Studio Code)
- Виконання пакета служб SSIS із командного рядка
- Виконання пакета служб SSIS за допомогою PowerShell
- Виконання пакета служб SSIS за допомогою C#