Устранение неполадок управления средой выполнения интеграции SSIS

  • Статья

ОБЛАСТЬ ПРИМЕНЕНИЯ: Фабрика данных Azure Azure Synapse Analytics

Совет

Опробуйте Фабрику данных в Microsoft Fabric, решение для аналитики "все в одном" для предприятий. Microsoft Fabric охватывает все, от перемещения данных до обработки и анализа данных, аналитики в режиме реального времени, бизнес-аналитики и создания отчетов. Узнайте, как начать новую пробную версию бесплатно!

В этой статье представлены рекомендации по устранению неполадок управления в среде выполнения интеграции (IR) служб интеграции Azure-SQL Server (SSIS), также известных как SSIS IR.

Обзор

Если возникнет какая-либо проблема при подготовке или отмене подготовки SSIS IR, отобразится сообщение об ошибке на портале Фабрики данных Microsoft Azure или ошибка, возвращаемая при использовании командлета PowerShell. Ошибка всегда отображается в формате кода ошибки с подробным сообщением об ошибке.

Если код ошибки InternalServerError, в службе присутствуют временные проблемы, операцию следует повторить позже. Если повторная попытка не помогает, обратитесь в службу поддержки Фабрики данных Azure.

В противном случае три основные внешние зависимости могут вызвать ошибки: база данных SQL Azure или управляемый экземпляр SQL Azure, пользовательский сценарий настройки и конфигурация виртуальной сети.

Проблемы с базой данных SQL или управляемым экземпляром SQL

База данных SQL или управляемый экземпляр SQL требуется, если выполняется подготовка SSIS IR с базой данных каталога SSIS. Служба SSIS IR должна иметь доступ к базе данных SQL или управляемому экземпляру SQL. Кроме того, учетная запись для входа в базу данных SQL или управляемый экземпляр SQL должны иметь разрешение на создание базы данных каталога SSIS (SSISDB). Если возникает ошибка, на портале фабрики данных будет отображатся код ошибки с подробным сообщением об исключении SQL. Используйте сведения из следующего списка для устранения неполадок с кодами ошибок.

AzureSqlConnectionFailure

Эта проблема может возникать при подготовке нового SSIS IR или во время работы IR. Если эта ошибка возникла во время подготовки IR, вы можете получить подробное сообщение SqlException в сообщении об ошибке, указывающее на одну из следующих проблем:

  • Проблема подключения в сети. Проверьте, доступно ли имя узла для базы данных SQL или управляемого экземпляра SQL. Также убедитесь, что брандмауэр или группа безопасности сети (NSG) не блокируют доступ к серверу служб SSIS IR.
  • Ошибка входа при проверке подлинности SQL. Не удается войти в базу данных SQL Server с указанной учетной записью. Убедитесь, что указана правильная учетная запись пользователя.
  • Ошибка входа в систему во время аутентификации Microsoft Azure Active Directory (Azure AD) (управляемое удостоверение). Добавьте управляемое удостоверение фабрики в группу AAD и убедитесь, что управляемое удостоверение имеет разрешения на доступ к серверу базы данных каталога.
  • Истечение времени ожидания подключения. Эта ошибка всегда вызвана конфигурацией, связанной с безопасностью. Примите во внимание следующие рекомендации.
    1. Создать виртуальную машину.
    2. Подключите виртуальную машину к той же виртуальной сети Microsoft Azure IR, если IR находится в виртуальной сети.
    3. Установите SSMS и проверьте состояние сервера базы данных SQL или управляемого экземпляра SQL.

Для устранения других проблем, устраните проблему, отображаемую в подробном сообщении об ошибке исключения SQL. Если проблема не решится, обратитесь в службу поддержки базы данных SQL или управляемого экземпляра SQL.

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

CatalogCapacityLimitError

Это сообщение об ошибке может выглядеть следующим образом: "База данных 'SSISDB' достигла предельного размера квоты. Разделите или удалите данные, удалите индексы или попробуйте найти возможное решение в документации".

Возможные решения:

  • увеличение размера квоты SSISDB;
  • изменение конфигурации SSISDB для уменьшения размера на:;
    • сокращение срока хранения и количества версий проекта;
    • сокращение срока хранения журнала;
    • изменение уровня журнала по умолчанию.

CatalogDbBelongsToAnotherIR

Эта ошибка означает, что база данных SQL или управляемый экземпляр SQL уже имеет SSISDB и используется другой IR. Необходимо либо указать другую базу данных SQL или управляемый экземпляр SQL, либо удалить существующую SSISDB и перезапустить новую IR.

CatalogDbCreationFailure

Ошибка может быть вызвана одной из следующих причин:

  • Учетная запись пользователя, настроенная для службы SSIS IR, не имеет разрешения на создание базы данных. Вы можете предоставить пользователю разрешение на создание базы данных.
  • Время ожидания возникает во время создания базы данных, например время ожидания выполнения или время ожидания операции базы данных. Повторите операцию позже. Если повторная попытка не помогает, обратитесь в службу поддержки базы данных SQL или управляемого экземпляра SQL.

Для устранения других проблем проверьте сообщение об ошибке исключения SQL и устраните проблему, упомянутую в сведениях об ошибке. Если проблема не решится, обратитесь в службу поддержки базы данных SQL или управляемого экземпляра SQL.

InvalidCatalogDb

Это сообщение об ошибке выглядит следующим образом: "Недопустимое имя объекта 'catalog.catalog_properties'". В этой ситуации либо у вас уже есть база данных с именем SSISDB, но она была создана не с помощью службы SSIS IR, либо база данных находится в недопустимом состоянии, что вызвано ошибками при последней подготовке SSIS IR. Вы можете удалить существующую базу данных с именем SSISDB или настроить новую базу данных SQL или управляемый экземпляр SQL для IR.

Проблемы с пользовательской настройкой

Пользовательская настройка предоставляет интерфейс для добавления собственных шагов настройки во время подготовки или перенастройки SSIS IR. Дополнительные сведения см. в статье Пользовательская настройка Azure-SSIS Integration Runtime.

Убедитесь, что контейнер содержит только необходимые пользовательские файлы настройки; все файлы в контейнере будут загружены на рабочий узел службы SSIS IR. Мы рекомендуем протестировать пользовательский сценарий настройки на локальном компьютере чтобы исправить любые проблемы с выполнением сценария, прежде чем запускать сценарий в SSIS IR.

Контейнер сценария пользовательской настройки будет проверяться во время работы IR, потому что SSIS IR регулярно обновляется. Это обновление требует доступа к контейнеру для загрузки сценария пользовательской установки и его повторной установки. Процесс также проверяет, доступен ли контейнер и существует ли файл main.cmd.

Для любой ошибки, связанной с пользовательской настройкой, будет отображаться код ошибки CustomSetupScriptFailure с подкодом, например CustomSetupScriptBlobContainerInaccessible или CustomSetupScriptNotFound.

CustomSetupScriptBlobContainerInaccessible

Эта ошибка означает, что служба SSIS IR не может получить доступ к контейнеру BLOB-объектов Azure для пользовательской настройки. Убедитесь, что универсальный код доступа (URI) SAS контейнера доступен и срок его действия не истек.

Остановите IR, если она работает, перенастройте ее с помощью нового пользовательского универсального кода доступа (URI) SAS контейнера пользовательской настройки, а затем перезапустите IR.

CustomSetupScriptNotFound

Эта ошибка означает, что SSIS IR не может найти сценарий пользовательской настройки (main.cmd) в контейнере BLOB-объектов. Убедитесь, что main.cmd существует в контейнере, который является точкой входа для установки пользовательской настройки.

CustomSetupScriptExecutionFailure

Эта ошибка означает, что не удалось выполнить сценарий пользовательской настройки (main.cmd). Сначала попробуйте выполнить сценарий на локальном компьютере или проверьте журналы выполнения пользовательской настройки в контейнере BLOB-объектов.

CustomSetupScriptTimeout

Эта ошибка указывает на время ожидания выполнения сценария пользовательской настройки. Убедитесь, что скрипт можно выполнить без вмешательства пользователя, что не требуется интерактивный ввод, а также что контейнер больших двоичных объектов содержит только необходимые пользовательские файлы установки. Рекомендуем сначала протестировать сценарий на локальном компьютере. Кроме того, следует проверить журналы выполнения пользовательских настроек в контейнере BLOB-объектов. Максимальный период для пользовательской настройки составляет 45 минут, прежде чем истечет время ожидания. Он включает в себя время загрузки всех файлов из контейнера и установки их на SSIS IR. Если требуется более длительный период, создайте запрос в службу поддержки.

CustomSetupScriptLogUploadFailure

Эта ошибка означает, что попытка передачи журналов выполнения пользовательской настройки в контейнер BLOB-объектов завершилась сбоем. Эта проблема возникает либо из-за того, что у SSIS IR нет прав на запись в контейнер BLOB-объектов, либо из-за проблем с хранилищем или сетью. Если пользовательская настройка прошла успешно, эта ошибка не повлияет ни на одну функцию SSIS, но журналы будут отсутствовать. Если пользовательская настройка завершается с другой ошибкой, а журнал не передается, сначала появится сообщение об этой ошибке, чтобы журнал можно было отправить для анализа. Кроме того, после устранения этой проблемы появятся сообщения о любых более конкретных проблемах. Если эта проблема не устранена после повторной попытки, обратитесь в техническую поддержку Фабрики данных Azure.

Конфигурация виртуальной сети

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

InvalidVnetConfiguration

Эта ошибка может возникать по разным причинам. Сведения об устранении проблем см. в разделах Запрещено, InvalidPropertyValue и MisconfiguredDnsServerOrNsgSettings.

Запрещено

Этот вид ошибки может выглядеть следующим образом: "SubnetId не включен для текущей учетной записи. Поставщик ресурсов Microsoft.Batch не зарегистрирован по той же подписке, что и виртуальная сеть".

Эти сведения означают, что пакетная служба Azure не может получить доступ к виртуальной сети. Зарегистрируйте поставщика ресурсов Microsoft.Batch по той же подписке, что и виртуальная сеть.

InvalidPropertyValue

Этот вид ошибки может выглядеть следующим образом:

  • "Указанная виртуальная сеть либо не существует, либо пакетная служба не имеет к ней доступа".
  • "Указанная подсеть xxx не существует".

Эти ошибки означают, что виртуальная сеть не существует, пакетная служба Azure не может получить к ней доступ, или же указанная подсеть не существует. Убедитесь, что виртуальная сеть и подсеть существуют, и что пакетная служба Azure имеет к ним доступ.

MisconfiguredDnsServerOrNsgSettings

Этот вид сообщения об ошибке может выглядеть следующим образом: "Не удалось подготовить среду выполнения интеграции в виртуальной сети к работе. Если параметры DNS-сервера или NSG настроены, убедитесь, что DNS-сервер доступен и NSG настроен правильно".

В этой ситуации у вас, вероятно, есть настроенная конфигурация DNS-сервера или параметров NSG, которая предотвращает разрешение или доступ к имени сервера Azure, необходимого для службы SSIS IR. Дополнительные сведения см. в разделе Конфигурация виртуальной сети SSIS IR. Если у вас по-прежнему возникают проблемы, обратитесь в службу поддержки Фабрики данных Azure.

VNetResourceGroupLockedDuringUpgrade

Службы SSIS IR будут автоматически обновляться на регулярной основе. Во время обновления создается новый пул пакетной службы Azure, а старый удаляется. Кроме того, ресурсы, связанные с виртуальной сетью, для старого пула удаляются, а новые ресурсы, связанные с виртуальной сетью, создаются в подписке. Эта ошибка означает, что удаление ресурсов, связанных с виртуальной сетью, для старого пула завершилось сбоем из-за блокировки удаления на уровне подписки или группы ресурсов. Поскольку клиент контролирует и устанавливает блокировку удаления, в этой ситуации он должен удалить блокировку удаления.

VNetResourceGroupLockedDuringStart

При сбое подготовки служб SSIS IR все созданные ресурсы удаляются. Однако при наличии блокировки удаления ресурса на уровне подписки или группы ресурсов, ресурсы виртуальной сети не удаляются должным образом. Чтобы устранить эту ошибку, удалите блокировку удаления и перезапустите IR.

VNetResourceGroupLockedDuringStop/VNetDeleteLock

При остановке служб SSIS IR все ресурсы, связанные с виртуальной сетью, удаляются. Но удаление может завершиться ошибкой, если на уровне подписки или группы ресурсов имеется блокировка удаления ресурса. Здесь клиент также управляет и устанавливает блокировку удаления. Поэтому он должен удалить блокировку удаления, а затем еще раз остановить службу SSIS IR.

NodeUnavailable

Эта ошибка возникает, когда при выполнении IR, и значит, что IR стала неработоспособной. Эта ошибка всегда вызвана изменением DNS-сервера или конфигурации NSG, которое блокирует подключение служб SSIS IR к необходимой службе. Поскольку настройка DNS-сервера и NSG контролируется клиентом, клиент должен устранить блокирующие проблемы на их стороне. Дополнительные сведения см. в разделе Конфигурация виртуальной сети SSIS IR. Если у вас по-прежнему возникают проблемы, обратитесь в службу поддержки Фабрики данных Azure.

Конфигурация статических общедоступных IP-адресов

При установке соединения Azure SSIS IR с виртуальной сетью Azure также можно использовать свои собственные статические общедоступные IP-адреса для IR, чтобы IR могла получить доступ к источникам данных, которые предоставляют доступ только для определенных IP-адресов. Дополнительные сведения см. в статье Присоединение среды выполнения интеграции Azure SSIS к виртуальной сети.

Помимо вышеуказанных проблем с виртуальной сетью, также можно столкнуться с проблемой, связанной со статическими общедоступными IP-адресами. Для получения помощи проверьте следующие ошибки.

InvalidPublicIPSpecified

Эта ошибка может возникать по различным причинам при запуске Azure-SSIS IR.

Сообщение об ошибке Решение
Предоставленный статический общедоступный IP-адрес уже используется. Укажите два неиспользуемых адреса для среды выполнения интеграции Azure SSIS. Следует выбрать два неиспользуемых статических общедоступных IP-адреса или удалить текущие ссылки на указанный общедоступный IP-адрес, а затем перезапустить Azure SSIS IR.
Указанный статический общедоступный IP-адрес не имеет имени DNS, укажите два из них с именем DNS для среды выполнения интеграции Azure SSIS. Можно настроить имя DNS общедоступного IP-адреса на портале Azure, как показано на рисунке ниже. Для этого выполните следующие действия: (1) Откройте портал Azure и перейдите на страницу ресурсов этого общедоступного IP-адреса; (2) Выберите раздел Конфигурация и настройте имя DNS, затем нажмите кнопку Сохранить; (3) Перезапустите Azure SSIS IR.
Указанная виртуальная сеть и статические общедоступные IP-адреса для среды выполнения интеграции Azure SSIS должны находиться в одном расположении. В соответствии с требованиями сети Azure статический общедоступный IP-адрес и виртуальная сеть должны находиться в одном расположении и подписке. Укажите два допустимых статических общедоступных IP-адреса и перезапустите Azure-SSIS IR.
Указанный статический общедоступный IP-адрес является основным, укажите два стандартных для среды выполнения интеграции Azure-SSIS. Для получения справки см. статью Номера SKU общедоступного IP-адреса.

Azure SSIS IR

PublicIPResourceGroupLockedDuringStart

В случае сбоя подготовки Azure SSIS IR все созданные ресурсы удаляются. Однако если есть блокировка удаления ресурса на уровне подписки или группы ресурсов (которая содержит ваш статический общедоступный IP-адрес), сетевые ресурсы не удаляются, как ожидается. Чтобы устранить эту ошибку, снимите блокировку удаления и перезапустите IR.

PublicIPResourceGroupLockedDuringStop

При остановке Azure-SSIS IR все сетевые ресурсы, созданные в группе ресурсов, содержащей ваш общедоступный IP-адрес, будут удалены. Но удаление может завершиться неудачно, если есть блокировка удаления ресурса на уровне подписки или группы ресурсов (которая содержит ваш статический общедоступный IP-адрес). Снимите блокировку удаления и перезапустите IR.

PublicIPResourceGroupLockedDuringUpgrade

Azure-SSIS IR автоматически обновляется на регулярной основе. Новые узлы IR создаются во время обновления, а старые узлы удаляются. Кроме того, созданные сетевые ресурсы (например, подсистема балансировки нагрузки и группа безопасности сети) для старых узлов удаляются, а новые сетевые ресурсы создаются в рамках вашей подписки. Эта ошибка означает, что удаление сетевых ресурсов для старых узлов не удалось вследствие блокировки удаления на уровне подписки или группы ресурсов (которая содержит ваш статический общедоступный IP-адрес). Снимите блокировку удаления, чтобы мы могли очистить старые узлы и освободить статический общедоступный IP-адрес для старых узлов. В противном случае статический общедоступный IP-адрес невозможно освободить, и мы не сможем обновлять вашу IR в дальнейшем.

PublicIPNotUsableDuringUpgrade

Если вы хотите использовать свои собственные статические общедоступные IP-адреса, необходимо указать два общедоступных IP-адреса. Один из них будет использоваться для немедленного создания узлов IR, а другой — во время обновления IR. Эта ошибка может возникать, когда другой общедоступный IP-адрес непригоден для использования во время обновления. Возможные причины см. в разделе об InvalidPublicIPSpecified.

Управление ресурсами

Тег ресурса не обновлен

К ресурсам Azure можно применять теги, чтобы логически упорядочить их на основе таксономии. Пока выполняется среда SSIS IR, изменения тегов в родительской фабрике данных SSIS IR не вступят в силу до перезапуска SSIS IR.