Инструменты устранения неполадок при разработке пакетаTroubleshooting Tools for Package Development

Применимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) да Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data Factoryyes Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data FactoryПрименимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) да Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data Factoryyes Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data Factory

Службы Integration ServicesIntegration Services содержат функции и средства, которые можно использовать для устранения неполадок в пакетах при разработке в среде SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).includes features and tools that you can use to troubleshoot packages while you are developing them in SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).

Устранение неполадок проверки во время разработкиTroubleshooting Design-time Validation Issues

В текущем выпуске служб Службы Integration ServicesIntegration Services при открытии пакета система проверяет все соединения до проверки всех компонентов потока данных, при этом все медленно работающие или недоступные соединения переводятся в режим "вне сети".In the current release of Службы Integration ServicesIntegration Services, when a package is opened, the system validates all connections before validating all of the data flow components and sets any connections that are slow or unavailable to work offline. Благодаря этому уменьшаются задержки при проверке потока данных пакета.This helps reduce the delay in validating the package data flow.

После открытия пакета можно отключить соединение, щелкнув правой кнопкой мыши диспетчер соединений в области Диспетчеры соединений и выбрав команду Работать автономно.After a package is opened, you can also turn off a connection by right-clicking the connection manager in the Connection Managers area and then clicking Work Offline. Это может ускорить выполнение операций в конструкторе служб SSIS.This can speed up operations in the SSIS Designer.

Соединения, переведенные в режим «вне сети», остаются вне сети, пока вы не выполните одно из следующих действий.Connections that have been set to work offline, will remain offline until you do one of the following:

  • Проверка соединения: для этого щелкните правой кнопкой мыши диспетчер соединений в области Диспетчеры соединений конструктора служб SSIS, затем нажмите кнопку Проверить соединение.Test the connection by right-clicking the connection manager in the Connection Managers area of SSIS Designer and then clicking Test Connectivity.

    Например, если соединение изначально настроено на работу вне сети при открытии пакета:For example, a connection is initially set to work offline when the package is opened. измените строку подключения, чтобы решить эту проблему, и нажмите кнопку Проверить соединение , чтобы проверить соединение.You modify the connection string to resolve the issue and click Test Connectivity to test the connection.

  • Откройте повторно пакет или проект, в котором содержится пакет.Re-open the package or re-open the project that contains the package. Проверка снова выполняется для всех соединений в пакете.Validation is run again on all of the connections in the package.

Службы Integration ServicesIntegration Services содержат следующие дополнительные возможности, которые помогают избежать ошибок проверки.includes the following, additional features to help you avoid validation errors :

  • Установка режима «вне сети» для всего пакета и всех соединений, если источники данных недоступны.Set all of the package and all of the connections to work offline when data sources are not available. Режим Работать вне сети можно включить в меню Службы SSIS .You can enable Work Offline from the SSIS menu. В отличие от свойства DelayValidation , флажок Работать вне сети доступен даже перед открытием пакета.Unlike the DelayValidation property, the Work Offline option is available even before you open a package. Флажок Работать вне сети можно также установить для ускорения работы конструктора и снять его только для проверки пакета.You can also enable Work Offline to speed up operations in the designer, and disable it only when you want your package to be validated.

  • Настройте свойство DelayValidation в элементах пакета, которые являются недопустимыми до времени выполнения.Configure the DelayValidation property on package elements that are not valid until run time. Чтобы избежать ошибок проверки, можно присвоить свойству DelayValidation значение True для элементов пакета, конфигурация которых недопустима во время разработки.You can set DelayValidation to True on package elements whose configuration is not valid at design time to prevent validation errors. Например, может существовать задача потока данных, использующая целевую таблицу, которая не существует до тех пор, пока задача «Выполнение SQL» не создаст таблицу во время выполнения.For example, you may have a Data Flow task that uses a destination table that does not exist until an Execute SQL task creates the table at run time. Свойство DelayValidation можно включить на уровне пакета или на уровне отдельных задач или контейнеров, содержащихся в пакете.The DelayValidation property can be enabled at the package level, or at the level of the individual tasks and containers that the package includes. Обычно при развертывании пакета этому свойству необходимо присвоить значение True для тех же элементов пакета, чтобы избежать ошибок проверки времени выполнения.Normally you must leave this property set to True on the same package elements when you deploy the package, to prevent the same validation errors at run time.

    Свойство DelayValidation устанавливается в задаче потока данных, но не в отдельных компонентах потока данных.The DelayValidation property can be set on a Data Flow task, but not on individual data flow components. Тех же результатов можно добиться, присвоив свойству ValidateExternalMetadata отдельного компонента потока данных значение false.You can achieve a similar effect by setting the ValidateExternalMetadata property of individual data flow components to false. Однако если значение этого свойства равно false, компонент не узнает об изменениях метаданных внешних источников данных.However, when the value of this property is false, the component is not aware of changes to the metadata of external data sources.

Если при проверке объекты базы данных, используемые пакетом, заблокированы, процесс проверки может перестать отвечать.If database objects that are used by the package are locked when validation occurs, the validation process might stop responding. В этом случае конструктор служб Integration ServicesSSIS также прекращает отвечать.In these circumstances, the Integration ServicesSSIS Designer also stops responding. Возобновить проверку можно с помощью среды Среда Management StudioManagement Studio , чтобы закрыть соответствующий сеанс в SQL ServerSQL Server.You can resume validation by using Среда Management StudioManagement Studio to close the associated session in SQL ServerSQL Server. Эту проблему можно также предотвратить с помощью параметров, описываемых в этом разделе.You can also avoid this issue by using the settings described in this section.

Устранение неполадок в потоке управленияTroubleshooting Control Flow

Службы Integration ServicesIntegration Services содержат следующие средства и функции, которые можно использовать для устранения неполадок в потоке управления пакетов во время их разработки.includes the following features and tools that you can use to troubleshoot the control flow in packages during package development:

  • Установка точек останова в задачах, контейнерах и пакетах.Set breakpoints on tasks, containers, and the package. Можно установить точки останова, используя графические средства, предоставляемые конструктором служб Integration ServicesSSIS .You can set breakpoints by using the graphical tools that Integration ServicesSSIS Designer provides. Точки останова могут быть включены на уровне пакета или на уровне отдельных задач или контейнеров, содержащихся в пакете.Breakpoints can be enabled at the package level, or at the level of the individual tasks and containers that the package includes. Некоторые задачи и контейнеры имеют дополнительные условия останова для установки точек останова.Some tasks and containers provide additional break conditions for setting breakpoints. Например, можно активировать условия останова в контейнере «цикл по элементам», который приостанавливает выполнение в начале каждой итерации цикла.For example, you can enable a break condition on the For Loop container that suspends execution at the start of each iteration of the loop.

  • Использование диалоговых окон отладки.Use the debugging windows. Если запускается пакет, имеющий точки останова, то окно отладки среды SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) обеспечивает доступ к значениям переменных и сообщениям о состоянии.When you run a package that has breakpoints, the debug windows in SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) provide access to variable values and status messages.

  • Просмотр сведений на вкладке «Ход выполнения» . Integration ServicesSSIS предоставляет дополнительные сведения о потоке управления при запуске пакета в среде SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).Review the information on the Progress tab. Integration ServicesSSIS Designer provides additional information about control flow when you run a package in SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT). Вкладка «Ход выполнения» перечисляет задачи и контейнеры в порядке выполнения, в том числе время запуска и окончания работы, предупреждения и сообщения об ошибках каждой задачи или контейнера, включая сам пакет.The Progress tab lists tasks and containers in order of execution and includes start and finish times, warnings, and error messages for each task and container, including the package itself.

Дополнительные сведения об этих возможностях см. в разделе Отладка потока управления.For more information on these features, see Debugging Control Flow.

Устранение неполадок в потоке данныхTroubleshooting Data Flow

Службы Integration ServicesIntegration Services содержат следующие средства и функции, которые можно использовать для поиска ошибок в потоке данных пакетов во время их разработки.includes the following features and tools that you can use to troubleshoot the data flows in packages during package development:

  • Тестирование с помощью лишь подмножества данных.Test with only a subset of your data. Если необходимо найти ошибку в работе потока данных пакета, используя только образец набора данных, то можно добавить преобразование «Процентная выборка» или «Выборка строк» для создания встроенного образца данных во время выполнения.If you want to troubleshoot the data flow in a package by using only a sample of the dataset, you can include a Percentage Sampling or Row Sampling transformation to create an in-line data sample at run time. Дополнительные сведения см. в разделах Percentage Sampling Transformation и Row Sampling Transformation.For more information, see Percentage Sampling Transformation and Row Sampling Transformation.

  • Использование средств просмотра данных для мониторинга данных по мере выполнения потока данных.Use data viewers to monitor data as it moves through the data flow. Средства просмотра данных отображают значения данных во время их перемещения между источниками, преобразованиями и назначениями.Data viewers display data values as the data moves between sources, transformations, and destinations. В средстве просмотра данные могут отображаться в сетке.A data viewer can display data in a grid. Можно скопировать данные из средства просмотра данных в буфер обмена, а затем вставить их в файл или рабочий лист Excel.You can copy the data from a data viewer to the Clipboard, and then paste the data into a file or Excel spreadsheet. Дополнительные сведения: Отладка потока данных.For more information, see Debugging Data Flow .

  • Настройка вывода ошибок в тех компонентах потока данных, которые поддерживают эту возможность.Configure error outputs on data flow components that support them. Многие источники потока данных, преобразования и назначения поддерживают вывод ошибок.Many data flow sources, transformations, and destinations also support error outputs. Настроив вывод ошибок компонента потока данных, можно направить данные с ошибками в другое назначение.By configuring the error output of a data flow component, you can direct data that contains errors to a different destination. Например, можно сохранить ошибочные или усеченные данные в отдельный текстовый файл.For example, you can capture the data that failed or was truncated in a separate text file. Можно также присоединить средства просмотра данных к выводу ошибок и анализировать только ошибочные данные.You can also attach data viewers to error outputs and examine only the erroneous data. Во время разработки выходы ошибок захватывают ошибочные значения данных, чтобы облегчить разработку пакетов, эффективно обрабатывающих реальные данные.At design time, error outputs capture troublesome data values to help you develop packages that deal effectively with real-world data. Однако в то время как остальные средства и функции устранения неполадок полезны только во время разработки, вывод ошибок является важной функциональной возможностью в рабочей среде.However, while other troubleshooting tools and features are useful only at design time, error outputs retain their usefulness in the production environment. Дополнительные сведения см. в разделе Обработка ошибок в данных.For more information, see Error Handling in Data.

  • Захват общего числа обработанных строк.Capture the count of rows processed. Когда пакет запускается в конструкторе служб Integration ServicesSSIS , то количество переданных через путь строк отображается в конструкторе потока данных.When you run a package in Integration ServicesSSIS Designer, the number of rows that have passed through a path is displayed in the data flow designer. Это количество периодически обновляется по мере перемещения данных по пути.This number is updated periodically while the data moves through the path. Также для захвата конечного числа строк в переменную можно добавить преобразование «Подсчет строк» в поток данных.You can also add a Row Count transformation to the data flow to capture the final row count in a variable. Дополнительные сведения см. в разделе Row Count Transformation.For more information, see Row Count Transformation.

  • Просмотр сведений на вкладке «Ход выполнения» . Integration ServicesSSIS предоставляет дополнительные сведения о потоках данных при запуске пакета в среде SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).Review the information on the Progress tab. Integration ServicesSSIS Designer provides additional information about data flows when you run a package in SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT). Вкладка «Ход выполнения» перечисляет компоненты потока данных в порядке выполнения с указанием хода выполнения каждой фазы пакета, отображенной как процент выполнения, и количество строк, записанных в назначение.The Progress tab lists data flow components in order of execution and includes information about progress for each phase of the package, displayed as percentage complete, and the number of rows written to the destination.

Дополнительные сведения об этих возможностях см. в разделе Отладка потока данных.For more information on these features, see Debugging Data Flow.

Устранение неполадок скриптовTroubleshooting Scripts

MicrosoftMicrosoft Средства Visual StudioVisual Studio для приложений (VSTA) — это среда разработки, с помощью которой можно создавать скрипты для задачи "Скрипт" и компонента "Скрипт".Visual StudioVisual Studio Tools for Applications (VSTA) is the development environment in which you write the scripts that are used by the Script task and Script component. Среда VSTA располагает следующими средствами и функциями, которые можно использовать для поиска ошибок в скриптах во время разработки пакета.VSTA provides the following features and tools that you can use to troubleshoot scripts during package development:

  • Установка точек останова в задачах «Скрипт».Set breakpoints in script in Script tasks. Среда VSTA поддерживает отладку скриптов только в задаче «Скриптй».VSTA provides debugging support for scripts in the Script task only. Точки останова, которые установлены в задачах «Скрипт», объединяются с точками останова, которые установлены в пакетах, задачах и контейнерах пакетов, предоставляя возможность совместной отладки всех элементов пакета.The breakpoints that you set in Script tasks are integrated with the breakpoints that you set on packages and the tasks and containers in the package, enabling seamless debugging of all package elements.

    Примечание

    При отладке пакета, содержащего несколько задач «Скрипт», отладчик обрабатывает точки останова только в одной задаче «Скрипт» и не учитывает точки останова в других задачах.When you debug a package that contains multiple Script tasks, the debugger hits breakpoints in only one Script task and will ignore breakpoints in the other Script tasks. Если задача «Скрипт» является частью контейнера «цикл по каждому элементу» или «цикл по элементам», отладчик пропускает точки останова в задаче «Скрипт» после первого прохода цикла.If a Script task is part of a Foreach Loop or For Loop container, the debugger ignores breakpoints in the Script task after the first iteration of the loop.

Дополнительные сведения см. в статье Debugging Script.For more information, see Debugging Script. Предложения по отладке компонента скрипта см. в разделе Кодирование и отладка компонента скрипта.For suggestions about how to debug the Script component, see Coding and Debugging the Script Component.

Устранение неполадок при ошибках без описанийTroubleshooting Errors without a Description

Если во время разработки пакета встречается ошибка служб Службы Integration ServicesIntegration Services , не имеющая описания, его можно найти в справочнике по сообщениям об ошибках служб Integration Services.If you encounter an Службы Integration ServicesIntegration Services error number without an accompanying description during package development, you can locate the description in Integration Services Error and Message Reference. Этот список сейчас не включает сведения об устранении неполадок.The list does not include troubleshooting information at this time.

См. такжеSee Also

Устранение неполадок инструментов с помощью отчетов Troubleshooting Tools for Package Execution
Возможности для повышения производительности потока данныхData Flow Performance Features