Образец пакета Create DataFlow

Изменения: 5 декабря 2005 г.

Образец пакета Create DataFlow демонстрирует способ программного создания пакета и добавления потока данных. Пакет, создаваемый в этом образце, выполняет следующие действия.

• Извлекает данные из таблицы Products базы данных AdventureWorks.
• Создает переменную для идентификации столбца, используемого для сортировки вывода.
• Сохраняет результаты в плоском файле.
• Выполняет пакет в памяти.
• Сохраняет пакет для дальнейшего просмотра.

Важно!
Образцы предназначены только для обучения. Они не предназначены для использования в рабочей среде и не тестировались в ней. Корпорация Майкрософт не предоставляет техническую поддержку для этих образцов.

Выполнение образца

Если уже известно, как находить, строить и устанавливать образцы программного кода, можно перейти непосредственно к разделу Проверка образца и прочитать о настройке и выполнении образца программного кода. Если вы еще не работали с образцами программного кода, вначале следует ознакомиться с предварительными требованиями.

Предварительные требования

Перед запуском этого образца кода убедитесь, что выполняются следующие условия.

• Откройте Диспетчер конфигурации SQL Server. Для этого в меню Пуск последовательно выберите Все программы, Microsoft SQL Server 2005, Средства настройки и выберите пункт Диспетчер конфигурации SQL Server.
• Разверните узел Сетевая конфигурация SQL Server 2005. Выберите Протоколы для MSSQLServer. Щелкните правой кнопкой мыши пункт TCP/IP и выберите команду Включить. Остановите работу службы и запустите ее заново. Дополнительные сведения см. в разделе «Как настроить свойства службы Integration Services с помощью оснастки "Службы"» электронной документации SQL Server.
  или
  Откройте файл main.cs и замените значение localhost, установленное для параметра Source в разделе adventureWorks.ConnectionString, на имя используемого сервера.
• Образец кода и связанные с ним образцы данных сначала должны быть установлены на локальный диск. Дополнительные сведения см. в разделе «Установка и компиляция образцов программ по службам Integration Services» электронной документации по SQL Server.
• Необходимо подключиться с правами администратора к базе данных AdventureWorks. Дополнительные сведения см. в разделе «Установка образца базы данных AdventureWorks и образцов приложений» электронной документации по SQL Server.

Чтобы скомпилировать образцы кода, потребуется пакет .NET Framework SDK 2.0 или Microsoft Visual Studio 2005. Пакет .NET Framework SDK можно получить бесплатно. См. раздел Установка пакета .NET Framework SDK электронной документации.

Расположение

Если образец кода был установлен в каталог по умолчанию, то он расположен в следующем каталоге:

«C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\CreatePackage Sample».

Решение для образца кода на языке C# расположено в каталоге CS, а решение на языке Visual Basic — в каталоге VB.

Сведения о двухэтапном процессе установки образцов см. в разделе Установка образцов. Чтобы получить последнюю версию образцов, включая новые, выпущенные после исходной версии SQL Server 2005, см. веб-страницу «Образцы SQL Server 2005 и образцы баз данных (апрель 2006 г.)».

Построение образца

Если файл ключа для строгого имени не был создан ранее, создайте его с помощью следующей процедуры.

Создание файла ключа для строгого имени

1. Чтобы открыть командную строку Microsoft Visual Studio 2005 нажмите кнопку Пуск, последовательно укажите пункты Все программы, Microsoft Visual Studio 2005, Средства Visual Studio и выберите пункт Командная строка Visual Studio 2005.

   — или —

   Чтобы открыть командную строку Microsoft .NET Framework: нажмите кнопку Пуск и последовательно укажите пункты Все программы, Microsoft .NET Framework SDK 2.0 и выберите пункт Командная строка SDK.

2. Для перехода из текущей папки в папку «Samples» в командной строке используйте команду смены каталога (CD). Созданный файл ключа будет использоваться всеми образцами кодов Microsoft SQL Server 2005.

   Примечание.
   Для определения папки, в которой находятся образцы, нажмите Пуск, последовательно укажите Все программы, Microsoft SQL Server 2005, Документация и учебные материалы и выберите пункт Каталог образцов. Если использовался каталог установки по умолчанию, то образцы расположены в каталоге «<системный_диск>:\Program Files\Microsoft SQL Server\90\Samples».

3. Для создания файла ключа выполните следующую команду в командной строке:

   sn -k SampleKey.snk

Важно!
Дополнительные сведения о паре ключей для строгого имени см. в разделе «Краткие сведения о безопасности: Строгие имена и безопасность в платформе .NET Framework» в центре разработчиков .NET в MSDN.

Построение образца

1. Откройте Microsoft Visual Studio 2005.

2. В меню Файл | Открыть выберите пункт Проект и откройте решение (SLN) для нужного образца в папке CS или VB, в зависимости от используемого языка программирования.

3. В меню выберите пункт Построить / Построить CreateTask*<lang>*.

Проверка образца

После запуска образца кода пакет, созданный программным путем, выполняется в памяти и сохраняется на локальном компьютере.

Можно просмотреть сохраненную версию пакета, созданного этим образцом кода, открыв пакет в конструкторе служб SSIS. Дополнительные сведения о том, как открыть пакет в конструкторе служб SSIS, см. в разделе «Как добавить существующий проект служб Integration Services в решение» электронной документации по SQL Server 2005.

Пакет сохраняется в следующем файле:

«C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\CreatePackage Sample\<язык>\CreatePackage\bin\Debug\SampleRuntimePackage.dtsx».

Результаты выполнения пакета сохраняются в следующем файле:

«C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\ \Programming Samples\Control Flow\CreatePackage Sample\<язык>\CreatePackage\bin\Debug\SampleRuntimeData.txt».

Можно удостовериться в успешном выполнении пакета, просмотрев результаты в плоском файле. Столбец, указанный в переменной SortColumn, определяет порядок сортировки результатов. При последующем запуске образца будут перезаписан и сохраненный пакет, и предыдущие результаты в плоском файле.

В ходе выполнения сведения о состоянии пакета, включая количество записанных строк, выводятся на консоль. Ниже приводится пример сведений, выводимых на консоль:

OnInformation

SubComponent: DTS.Pipeline

Description: "component "FlatFileDestination" (221)" wrote 504 rows.

Журнал изменений

Версия	Журнал
17 июля 2006 г.	Измененное содержимое Добавлены дополнительные сведения о запуске и проверке пакета, описаны ожидаемые результаты.