Устранение неполадок локальных шлюзов данных

Примечание.

Мы разделили документы локального шлюза данных на содержимое, относящееся к Power BI и общему содержимому, которое применяется ко всем службам , поддерживаемым шлюзом. В настоящее время вы находитесь в содержимом Power BI. Чтобы предоставить отзыв об этой статье или о вашем общем впечатлении от документации по шлюзу, прокрутите до конца статьи.

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

Подсказка

Сначала убедитесь, что вы находитесь в последней версии шлюза. Многие проблемы с подключением и надежностью устраняются в ежемесячных обновлениях. Инструкции по обновлению см. в статье "Установка и управление локальным шлюзом данных ".

Настройка

Ошибка: служба Power BI сообщила, что локальный шлюз недоступен

В конце конфигурации служба Power BI снова вызывается для проверки шлюза. Служба Power BI не объявляет шлюз активным. Перезапуск службы Windows может позволить успешному обмену данными. Чтобы получить дополнительные сведения, вы можете собирать и просматривать журналы, как описано в разделе "Сбор журналов" из локального приложения шлюза данных.

Используйте собственный ретранслятор Azure

Если вы включили собственный (BYO) Azure Relay и столкнулись с проблемами подключения, убедитесь, что Приватный канал не включен в этом пространстве имен ретранслятора — эта конфигурация в настоящее время не поддерживается с функцией BYO ретранслятора шлюза. Если вам не нужны пользовательские элементы управления Ретранслятором, вернитесь к управляемому ретранслятору по умолчанию, отключив ретранслятор BYO.

Источники данных

Примечание.

Не все источники данных содержат выделенные статьи о параметрах подключения или конфигурации. Для многих источников данных и соединителей, отличных от Майкрософт, параметры подключения могут отличаться между Power BI Desktop и конфигурациями управления подключениями и шлюзами в служба Power BI. В таких случаях предоставленные параметры по умолчанию — это поддерживаемые в настоящее время сценарии для Power BI.

Ошибка: не удается подключиться. Сведения: "Недопустимые учетные данные подключения"

В разделе "Показать сведения" отображается сообщение об ошибке, полученное из источника данных. Для SQL Server отображается следующее сообщение:

Login failed for user 'username'.

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

Ошибка: не удается подключиться. Сведения: "Не удается подключиться к базе данных"

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

В разделе "Показать сведения" отображается сообщение об ошибке, полученное из источника данных. Для SQL Server отображается следующее сообщение:

Cannot open database "AdventureWorks" requested by the login. The login failed. Login failed for user 'username'.

Ошибка: не удается подключиться. Сведения: "Неизвестная ошибка в шлюзе данных"

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

В разделе "Показать сведения" можно увидеть код ошибки DM_GWPipeline_UnknownError.

Вы также можете просмотреть журналы событий >> для получения дополнительной информации. Смотрите журналы событий для получения подробных сведений.

Ошибка: при попытке подключения к <серверу> возникла ошибка. Сведения: "Мы достигли шлюза данных, но шлюз не может получить доступ к локальному источнику данных".

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

В разделе "Показать сведения" можно просмотреть код ошибки DM_GWPipeline_Gateway_DataSourceAccessError.

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

The 'CONTOSO\account' value of the 'EffectiveUserName' XML for Analysis property is not valid.

Если базовое сообщение об ошибке похоже на следующее, это может означать, что учетной записи службы Analysis Services может отсутствовать атрибут каталога Token-Groups-Global-And-Universal (TGGAU).

The username or password is incorrect.

Домены с доступом к совместимости до Windows 2000 включают атрибут TGGAU. Большинство только что созданных доменов не позволяют включить этот атрибут по умолчанию. Дополнительные сведения см. в разделе "Некоторые приложения и API-интерфейсы" требуют доступа к сведениям о авторизации для объектов учетной записи.

Чтобы проверить, включен ли атрибут, выполните следующие действия.

1. Подключитесь к серверу служб Analysis Services в SQL Server Management Studio. В свойствах расширенного подключения включите параметр EffectiveUserName для данного пользователя и убедитесь, что это изменение воспроизводит ошибку.

2. Вы можете использовать инструмент Active Directory dsacls для проверки, указан ли атрибут. Это средство находится на контроллере домена. Необходимо знать, каково уникальное доменное имя учетной записи, и передать это имя инструменту.

   dsacls "CN=John Doe,CN=UserAccounts,DC=contoso,DC=com"
   

   В результатах вы хотите увидеть что-то похожее на следующие выходные данные:

   Allow BUILTIN\Windows Authorization Access Group
                                   SPECIAL ACCESS for tokenGroupsGlobalAndUniversal
                                   READ PROPERTY
   

Чтобы устранить эту проблему, необходимо включить TGGAU в учетной записи, используемой для службы Windows Analysis Services.

Другая возможность для параметра "Имя пользователя или пароль неверны".

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

Обратитесь к администраторам домена, чтобы проверить связь доверия между доменами.

Не удаётся увидеть источники данных шлюза данных в опыте получения данных для служб Analysis Services из сервиса Power BI

Убедитесь, что учетная запись указана на вкладке "Пользователи " источника данных в конфигурации шлюза. Если у вас нет доступа к шлюзу, обратитесь к администратору шлюза и попросите его проверить. Только учетные записи в списке "Пользователи" могут видеть источник данных, указанный в списке служб Analysis Services.

Ошибка. У вас нет шлюза, установленного или настроенного для источников данных в этом наборе данных

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

Ошибка: Не удается обновить источник данных, так как учетные данные недействительны.

Вы смогли подключиться к семантической модели и обновить её без ошибок времени выполнения для подключения, но в службе Power BI появляется индикатор ошибок. Когда пользователь пытается обновить учетные данные с известными работающими учетными данными, появляется сообщение об ошибке о том, что предоставленные учетные данные недействительны.

Эта ошибка может возникать, когда шлюз пытается проверить подключение, даже если предоставленные учетные данные допустимы и операция обновления выполнена успешно. Когда шлюз выполняет проверку подключения, он в настоящее время пропускает необязательные параметры (например, хранилище Snowflake, роль или другие дополнительные параметры), а некоторые соединители требуют этих значений.

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

Семантические модели

Ошибка. Недостаточно места для этой строки

Эта ошибка возникает, если одна импортированная строка превышает примерно 4 МБ (ограничение сжатого ядра хранилища). Определите проблемную строку в исходных данных и фильтруйте или разделяйте столбцы (например, уменьшайте большие текстовые поля или двоичные объекты) перед импортом.

Ошибка. Предоставленное имя сервера не соответствует имени сервера в SSL-сертификате SQL Server

Эта ошибка может возникать, если общее имя сертификата предназначено для полного доменного имени сервера (FQDN), но вы предоставили только имя NetBIOS для сервера. Эта ситуация приводит к несоответствию параметров сертификата. Чтобы устранить эту проблему, укажите имя сервера в источнике данных шлюза и PBIX-файле, используя полное доменное имя сервера.

Ошибка. При настройке запланированного обновления локальный шлюз данных не отображается

За эту ошибку может отвечать несколько различных сценариев:

• Имя сервера и базы данных не совпадает с введенным в Power BI Desktop и источником данных, настроенным для шлюза. Эти имена должны совпадать (регистр не учитывается).
• Учетная запись не указана на вкладке "Пользователи" источника данных в конфигурации шлюза. Вас должен добавить в этот список администратор шлюза.
• Файл Power BI Desktop содержит несколько источников данных, а не все эти источники данных определены в шлюзе. Каждому локальному источнику данных обязательно должна соответствовать запись источника данных в шлюзе.

Ошибка: полученные несжатые данные на клиенте шлюза превысили ограничение.

Ограничение составляет 10 ГБ несжатых данных на сегмент таблицы во время обновления. Чтобы оптимизировать:

• Замените повторяющиеся длинные строки суррогатными ключами.
• Удалите неиспользуемые текстовые столбцы с высокой кардинальностью.
• Разделите очень широкие таблицы или отфильтруйте исторические разделы.
• Рассмотрим DirectQuery для очень больших таблиц фактов.

Ошибка: DM_GWPipeline_Gateway_SpooledOperationMissing

Несколько различных сценариев могут вызвать эту ошибку:

• Windows-служба шлюза перезапустилась во время обновления семантической модели или выполнения запроса (например, обновление ОС или сбой службы).
• Образ виртуальной машины был клонирован после установки шлюза, что привело к дублированному эфемерному состоянию.

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

Отчеты

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

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

• Сведения об источнике данных не соответствуют тому, что находится в базовом наборе данных. Имя сервера и базы данных должно совпадать между источником данных, определенным для локального шлюза данных, и тем, что вы предоставляете в Power BI Desktop. Если вы используете IP-адрес в Power BI Desktop, источник данных для локального шлюза данных также должен использовать IP-адрес.
• В вашей организации нет источника данных ни на одном шлюзе. Вы можете настроить источник данных в новом или существующем локальном шлюзе данных.

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

Если в этом отчете используется динамическое подключение служб Analysis Services, может возникнуть проблема, из-за которой значение, переданное в EffectiveUserName, не является допустимым или не имеет разрешений на сервере служб Analysis Services. Как правило, проблема с аутентификацией возникает, так как значение EffectiveUserName не соответствует локальному имени субъекта-пользователя (UPN).

Чтобы подтвердить эффективное имя пользователя, выполните следующие действия.

1. Найдите действительное имя пользователя в журналах шлюза.

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

   whoami /upn
   

При желании, вы можете увидеть, что Power BI получает из Microsoft Entra ID.

1. Перейдите на Graph Explorer.
2. Выберите "Войти" в правом верхнем углу.
3. Выполните следующий запрос Microsoft Graph (Azure AD Graph не используется):

https://graph.microsoft.com/v1.0/me

1. Найдите свойство userPrincipalName в ответе JSON.

Если ваш Microsoft Entra UPN не соответствует локальному UPN Active Directory, можно использовать функцию "Отображение имен пользователей", чтобы заменить его допустимым значением. Кроме того, обратитесь к администратору Power BI или локальному администратору Active Directory, чтобы согласовать имена пользователей (UPN).

Kerberos

Если базовый сервер базы данных и локальный шлюз данных не настроены для ограниченного делегирования Kerberos, включите дополнительное ведение журнала на шлюзе. Затем исследуйте ошибки или следы в файлах журнала шлюза, используя их как отправную точку для устранения неполадок. Сведения о сборе журналов шлюза для просмотра см. в разделе "Сбор журналов" из локального приложения шлюза данных.

Уровень_имперсонификации

Уровень олицетворения связан с настройкой имени главного имени службы (SPN) или параметром локальной политики.

[DataMovement.PipeLine.GatewayDataAccess] About to impersonate user DOMAIN\User (IsAuthenticated: True, ImpersonationLevel: Identification)

Решение (уровень олицетворения)

Выполните следующие действия, чтобы устранить проблему.

1. Настройте SPN для локального шлюза.
2. Настройте ограниченное делегирование в Active Directory.

FailedToImpersonateUserException: не удалось создать удостоверение Windows для пользовательского ID пользователя

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

Решение (FailedToImpersonateUserException)

• Убедитесь, что конфигурация правильна в соответствии с шагами в предыдущем разделе "Уровень олицетворения".
• Убедитесь, что идентификатор пользователя, под видом которого осуществляется попытка, является действительным аккаунтом Active Directory.

Общая ошибка: ошибка 1033 при анализе протокола

Вы получаете ошибку 1033, если внешний идентификатор, настроенный в SAP HANA, не соответствует параметрам входа, когда пользователь олицетворяется с использованием UPN (alias@domain.com). В верхней части журналов ошибок отображается сообщение "Исходный UPN 'alias@domain.com' заменен новым UPN 'alias@domain.com'", как показано здесь:

[DM.GatewayCore] SingleSignOn Required. Original UPN 'alias@domain.com' replaced with new UPN 'alias@domain.com.'

Решение (ошибка 1033)

• SAP HANA требует, чтобы олицетворенный пользователь использовал sAMAccountName атрибут (псевдоним пользователя) в Active Directory. Если этот атрибут не является правильным, отображается ошибка 1033.

  

• В журналах отображается sAMAccountName (псевдоним), а не UPN, который представляет собой псевдоним, за которым следует домен (alias@domain.com).

  

  <setting name="ADUserNameReplacementProperty" serializeAs="String">
    <value>sAMAccountName</value>
  </setting>
  <setting name="ADServerPath" serializeAs="String">
    <value />
  </setting>
  <setting name="CustomASDataSource" serializeAs="String">
    <value />
  </setting>
  <setting name="ADUserNameLookupProperty" serializeAs="String">
    <value>AADEmail</value>
  </setting>

Сбой связи SAP HANA: сбой подключения -10709 (учетные данные Kerberos недоступны)

Вы получите сообщение об ошибке "-10709 Соединение не удалось", если ваше делегирование неправильно настроено в Active Directory.

Решение (SAP HANA Kerberos -10709)

• Убедитесь, что у вас есть сервер SAP HANA на вкладке "Делегирование" в Active Directory для учетной записи службы шлюза.

  

Экспорт журналов для запроса в службу поддержки

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

1. Определите кластер шлюза.

   Если вы являетесь владельцем семантической модели, сначала проверьте имя кластера шлюза, связанное с семантической моделью. На следующем рисунке IgniteGateway — это кластер шлюза.

   

2. Проверьте свойства шлюза.

   Администратор шлюза должен проверить количество членов шлюза в кластере и включить балансировку нагрузки.

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

3. Получение и экспорт журналов шлюза.

   Затем администратор шлюза, который также является администратором системы шлюза, должен выполнить следующие действия.

   1. Войдите на компьютер шлюза и запустите локальное приложение шлюза данных для входа в шлюз.
   2. Включите дополнительное ведение журнала.
   3. (Необязательно) Включите функции мониторинга производительности и включите журналы производительности.
   4. Запустите сценарий, для которого вы хотите записать журналы шлюза.
   5. Экспорт журналов шлюза.

История обновлений

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

На странице сведений для семантической модели выберите «Обновить» на ленте, а затем выберите историю обновлений.

Вы также можете получить доступ к журналу обновлений из параметров семантической модели. Выберите "Файл " на ленте, а затем выберите "Параметры".

Примечание.

Эти параметры также можно настроить в области параметров семантической модели, боковой панели, которая открывается справа от страницы. Область параметров в настоящее время находится в предварительной версии.

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

Связанный контент

• Устранение неполадок с локальным шлюзом данных
• Настройка параметров прокси-сервера для локального шлюза данных
• Управление источниками данных SQL Server Analysis Services
• Управление источником данных — SAP HANA
• Управление источником данных SQL Server
• Управление источником данных — импорт и запланированное обновление

Есть еще вопросы? Попробуйте Сообщество Power BI.