Бөлісу құралы:


Известные проблемы с Azure Synapse Analytics

На этой странице перечислены известные проблемы в Azure Synapse Analytics, а также дата их разрешения или возможный обходной путь. Перед отправкой запроса на поддержка Azure просмотрите этот список, чтобы узнать, известна ли проблема, которую вы уже знаете и решаете.

Дополнительные сведения об Azure Synapse Analytics см. в обзоре Azure Synapse Analytics и новых возможностях Azure Synapse Analytics?

Активные известные проблемы

Компонент Azure Synapse Состояние Проблема
Выделенный пул SQL Azure Synapse Клиенты не могут отслеживать использование выделенного пула SQL с помощью метрик Существует обходной путь
Выделенный пул SQL Azure Synapse Сбой запроса при приеме файла Parquet в таблицу с AUTO_CREATE_TABLE='ON' Существует обходной путь
Выделенный пул SQL Azure Synapse Сбой запросов с ошибкой кражи данных Существует обходной путь
Выделенный пул SQL Azure Synapse Инструкция UPDATE STATISTICS завершается ошибкой: "Предоставленный поток статистики поврежден". Существует обходной путь
Бессерверный пул SQL в Azure Synapse Сбои запросов из бессерверного пула SQL в аналитическое хранилище Azure Cosmos DB Существует обходной путь
Бессерверный пул SQL в Azure Synapse Представление аналитического хранилища Azure Cosmos DB распространяет неправильные атрибуты в столбце Существует обходной путь
Бессерверный пул SQL в Azure Synapse Сбои запросов в бессерверных пулах SQL Существует обходной путь
Бессерверный пул SQL в Azure Synapse Проблемы с доступом к хранилищу из-за слишком долгого заголовка авторизации Существует обходной путь
Бессерверный пул SQL в Azure Synapse Запрос представления показывает непредвиденные результаты Существует обходной путь
Рабочая область Azure Synapse Связанная служба хранилища BLOB-объектов с назначенным пользователем управляемым удостоверением (UAMI) не получает список Существует обходной путь
Рабочая область Azure Synapse Не удалось удалить рабочую область Synapse и не удается удалить виртуальную сеть Существует обходной путь
Рабочая область Azure Synapse Операции PUT REST API или шаблоны ARM/Bicep для обновления параметров сети завершаются ошибкой Существует обходной путь
Рабочая область Azure Synapse Известная проблема, включающая квадратные скобки [] в значение тегов Существует обходной путь
Рабочая область Azure Synapse Сбои развертывания в рабочей области Synapse с помощью Synapse-workspace-deployment версии 1.8.0 в действиях GitHub с шаблонами ARM Существует обходной путь
Рабочая область Azure Synapse Нет GET операции API, выделенной Microsoft.Synapse/workspaces/trustedServiceBypassEnabled для параметра Существует обходной путь

Сводка известных проблем с выделенным пулом SQL в Azure Synapse Analytics

Клиенты не могут отслеживать использование выделенного пула SQL с помощью метрик

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

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

Сбой запроса при приеме файла Parquet в таблицу с AUTO_CREATE_TABLE='ON'

Клиенты, которые пытаются принимать файл parquet в хэш-распределенную таблицу, AUTO_CREATE_TABLE='ON' могут получить следующую ошибку:

COPY statement using Parquet and auto create table enabled currently cannot load into hash-distributed tables

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

Сбой запросов с ошибкой кражи данных

Рабочие области Synapse, созданные из существующего запроса отчета выделенного пула SQL, связанные с защитой от кражи данных с универсальным сообщением об ошибке, а защита от кражи данных отключена в Synapse Analytics:

Data exfiltration to '{****}' is blocked. Add destination to allowed list for data exfiltration and try again.

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

Сбой UPDATE STATISTICS

Некоторые выделенные пулы SQL могут столкнуться с исключением при выполнении инструкции UPDATE STATISTICS . Команда приводит к тому, что сообщение "Предоставленный поток статистики поврежден" и не сможет обновить статистику.

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

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

Обновления тегов, как представляется, завершаются ошибкой

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

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

Сводка известных проблем в рабочей области Azure Synapse

Ниже перечислены известные проблемы с рабочей областью Synapse.

Связанная служба хранилища BLOB-объектов с назначенным пользователем управляемым удостоверением (UAMI) не получает список

Связанная служба может не отображаться в концентраторе данных ->Linked ->Хранилище BLOB-объектов Azure после настройки связанной службы хранилища BLOB-объектов для использования проверки подлинности "Назначаемое пользователем управляемое удостоверение" в Azure Synapse Analytics.

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

Не удалось удалить рабочую область Synapse и не удается удалить виртуальную сеть

Удаление рабочей области Synapse завершается ошибкой с сообщением об ошибке:

Failed to delete Synapse workspace '[Workspace Name]'. Unable to delete virtual network. The correlationId is ********-****-****-****-************;

Обходное решение. Проблема может быть устранена, повторив операцию удаления. Команда инженеров знает об этом поведении и работает над исправлением.

Операции PUT REST API или шаблоны ARM/Bicep для обновления параметров сети завершаются ошибкой

При использовании шаблона ARM, шаблона Bicep или прямой операции PUT REST API для изменения параметров доступа к общедоступной сети и (или) правил брандмауэра для рабочей области Synapse операция может завершиться ошибкой.

Решение. Проблема может быть устранена с помощью операции ИСПРАВЛЕНИЯ REST API или пользовательского интерфейса портал Azure, чтобы отменить и повторить необходимые изменения конфигурации. Команда инженеров знает об этом поведении и работает над исправлением.

Известная проблема, включающая квадратные скобки [] в значение тегов

В контексте обновления значений тегов в рабочей области Azure Synapse включение квадратных скобок ([]) приведет к неудачной операции обновления.

Обходной путь. Текущее решение заключается в том, чтобы не использовать квадратные скобки ([]) в значениях тегов рабочей области Azure Synapse.

Сбои развертывания в рабочей области Synapse с помощью Synapse-workspace-deployment версии 1.8.0 в действиях GitHub с шаблонами ARM

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

Отображается Action failed - Error: Orchestrate failed - SyntaxError: Unexpected token in JSON at position 2057сообщение об ошибке.

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

  • Удалите escape-символы: вручную удалите все escape-символы (\) из файла параметров перед развертыванием. Это означает, что файл редактирует эти символы, которые могут вызывать проблемы во время синтаксического анализа или обработки этапа развертывания.
  • Замените escape-символы косыми чертами: замените escape-символы (\) косыми чертами (/). Это может быть особенно полезно в пути к файлам, где многие системы принимают косую черту вперед как допустимые разделители путей. Эта замена может помочь в обходе проблемы с escape-символами, что позволит процессу развертывания успешно завершиться.

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

Нет операции API GET, выделенной для параметра Microsoft.Synapse/workspaces/trustedServiceBypassEnabled.

Сводка по проблеме. В Azure Synapse Analytics нет выделенной операции API GET для получения состояния параметра trustedServiceBypassEnabled в области ресурсов "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled". Хотя пользователи могут задать эту конфигурацию, они не могут напрямую получить состояние с помощью этой конкретной области ресурсов.

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

Обходной путь: в Политика Azure не существует обходного решения для принудительного применения требуемого состояния конфигурации для этого свойства. Однако пользователи могут использовать операцию рабочей области GET для аудита состояния конфигурации в целях создания отчетов.
Эта операция рабочей области GET сопоставляется с Политика Azure Псевдонимом Microsoft.Synapse/workspaces/trustedServiceBypassEnabled.

Псевдоним Политика Azure можно использовать для управления этим свойством с помощью эффекта запрета Политика Azure, если операция является запросом PUT к ресурсу Microsoft.Synapse/workspace, но она будет функционировать только для целей аудита, если запрос PUT отправляется непосредственно в дочерний ресурс Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration. Родительский ресурс имеет свойство [properties.trustedServiceBypassEnabled], которое сопоставляет конфигурацию из дочернего ресурса, и именно поэтому он по-прежнему может быть проверен с помощью Политика Azure псевдоним родительского ресурса.

Так как дочерний ресурс Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration не имеет доступной операции GET, Политика Azure не может управлять этими запросами, а Политика Azure не может создать для него Политика Azure псевдоним.

Родительский ресурс: Microsoft.Synapse/workspaces

Дочерний ресурс: Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration

Портал Azure делает запрос PUT непосредственно в API PUT для дочернего ресурса и поэтому портал Azure, а также любые другие запросы API, сделанные за пределами родительских API Microsoft.Synapse/workspaces API, не могут управляться Политика Azure с помощью запрета или другого действия Политика Azure эффект.

Сводка известных проблем, связанных с бессерверным пулом SQL Azure Synapse Analytics

Сбои запросов из бессерверного пула SQL в аналитическое хранилище Azure Cosmos DB

Запросы из бессерверного пула SQL в аналитическое хранилище Azure Cosmos DB могут завершиться ошибкой с одним из следующих сообщений:

  • Resolving CosmosDB path has failed with error 'This request is not authorized to perform this operation'
  • Resolving CosmosDB path has failed with error 'Key not found'

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

  1. При подключении к аналитическому хранилищу Azure Cosmos DB используется частная конечная точка.
  2. При повторной попытке запрос выполняется успешно.

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

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

Представление аналитического хранилища Azure Cosmos DB распространяет неправильные атрибуты в столбце

При использовании представлений в бессерверном пуле Azure Synapse в аналитическом хранилище Cosmos DB, если в аналитическом хранилище Cosmos DB есть изменения, изменение не распространяется правильно в инструкции SELECT, клиент используется в представлении. В результате атрибуты неправильно сопоставляются с другим столбцом в результатах.

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

  1. Повторно создайте представление, переименовав столбцы.
  2. Избегайте использования представлений, если это возможно.

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

Иногда вы не сможете выполнить ALTER DATABASE SCOPED CREDENTIAL запрос. Основная причина этой проблемы заключается в том, что учетные данные кэшируются после первого использования, что делает его недоступным для изменения. Возвращается ошибка:

  • Failed to modify the identity field of the credential '{credential_name}' because the credential is used by an active database file.

Обходное решение. В настоящее время команда инженеров знает об этом поведении и работает над исправлением. В качестве обходного решения можно УДАЛИТЬ и СОЗДАТЬ учетные данные, что также означает воссоздание внешних таблиц с помощью учетных данных. Кроме того, вы можете привлечь служба поддержки Майкрософт группу по оказанию помощи.

Сбои запросов в бессерверных пулах SQL

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

Примеры сообщений об ошибках:

  • WaitIOCompletion call failed. HRESULT = 0x80070005'. File/External table name: {path}
  • Unable to resolve path '%' Error number 13807, Level 16, State 1, Message "Content of directory on path '%' cannot be listed.
  • Error 16561: External table '<table_name>' is not accessible because content of directory cannot be listed.
  • Error 13822: File {path} cannot be opened because it does not exist or it is used by another process.
  • Error 16536: Cannot bulk load because the file "%ls" could not be opened.

Решение:

Разрешение отличается в зависимости от проверки подлинности, Microsoft Entra (ранее Azure Active Directory) или управляемого удостоверения службы (MSI):

Для истечения срока действия маркера Microsoft Entra:

Для истечения срока действия маркера MSI:

  • Затем деактивируйте пул, чтобы очистить кэш маркеров. Обратитесь к служба поддержки Майкрософт группе за помощью.

Проблемы с доступом к хранилищу из-за слишком долгого заголовка авторизации

Примеры сообщений об ошибках в бессерверных пулах SQL:

  • File {path} cannot be opened because it does not exist or it is used by another process.
  • Content of directory on path {path} cannot be listed.
  • WaitIOCompletion call failed. HRESULT = {code}'. File/External table name: {path}

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

Проверьте длину токена Microsoft Entra, выполнив следующую команду в PowerShell. Значение -ResourceUrl параметра будет отличаться для неопубликованных облаков. Если длина маркера близка к 11000 или длине, см . раздел "Устранение рисков ".

(Get-AzAccessToken -ResourceUrl https://database.windows.net).Token.Length

Решение:

Рекомендуемые обходные пути:

  • Переключитесь на авторизацию хранилища управляемых удостоверений, как описано в элементе управления доступом к хранилищу.
  • Уменьшите количество групп безопасности (90 или меньше групп безопасности с маркером, совместимым длиной).
  • Увеличьте число групп безопасности более 200 (так как это изменяет способ создания маркера, он будет содержать URI API MS Graph вместо полного списка групп). Его можно достичь, добавив фиктивные или искусственные группы, выполнив следующие управляемые группы, после того как необходимо добавить пользователей в только что созданные группы.

Запрос представления показывает непредвиденные результаты

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

Обходной путь. Вручную измените определение представления.

Недавно закрытые известные проблемы

Компонент Synapse Проблема Состояние Дата разрешена
Бессерверный пул SQL в Azure Synapse Запросы, использующие проверку подлинности Microsoft Entra, завершались сбоем через 1 час "Разрешено" Август 2023 г.
Бессерверный пул SQL в Azure Synapse Сбои запросов при чтении данных Cosmos DB с помощью OPENROWSET "Разрешено" Март 2023 г.
Пул Apache Spark в Azure Synapse Не удалось записать в выделенный пул SQL из Synapse Spark с помощью выделенного соединителя пула SQL Azure Synapse для Apache Spark при использовании записных книжек в конвейерах "Разрешено" Июнь 2023 г.
Пул Apache Spark в Azure Synapse Выполнение определенного задания spark или задачи завершается слишком рано с кодом ошибки 503 из-за регулирования учетной записи хранения "Разрешено" Ноябрь 2023 г.
Пул Apache Spark в Azure Synapse Сбой запроса с предложением LIKE с помощью соединителя выделенного пула SQL Synapse в среде выполнения Spark 3.4 "Разрешено" Октябрь 2024 г.

Недавно закрытые известные проблемы с бессерверным пулом SQL Azure Synapse Analytics

Запросы, использующие проверку подлинности Microsoft Entra, завершались сбоем через 1 час

Подключения SQL с использованием проверки подлинности Microsoft Entra, которая остается активной в течение более 1 часа, начинается сбоем. К ним относятся запросы к хранилищу с помощью сквозной проверки подлинности и инструкций Microsoft Entra, которые взаимодействуют с идентификатором Microsoft Entra, например CREATE EXTERNAL PROVIDER. Это влияет на каждое средство, которое поддерживает активные подключения, например редактор запросов в SSMS и ADS. Средства, которые открывают новое подключение для выполнения запросов, не затрагиваются, например Synapse Studio.

Состояние: разрешено

Сбои запросов при чтении данных Azure Cosmos DB с помощью OPENROWSET

Запросы из бессерверного пула SQL в Аналитическое хранилище Cosmos DB с помощью OPENROWSET завершаются сбоем со следующим сообщением об ошибке:

Resolving CosmosDB path has failed with error 'bad allocation'.

Состояние: разрешено

Недавно закрытый пул Apache Spark для Azure Synapse Analytics

Не удалось записать в выделенный пул SQL из Synapse Spark с помощью выделенного соединителя пула SQL Azure Synapse для Apache Spark при использовании записных книжек в конвейерах

При использовании выделенного соединителя пула SQL Azure Synapse для Apache Spark для записи выделенного пула Azure Synapse с помощью записных книжек в конвейерах появится сообщение об ошибке:

com.microsoft.spark.sqlanalytics.SQLAnalyticsConnectorException: COPY statement input file schema discovery failed: Cannot bulk load. The file does not exist or you don't have file access rights.

Состояние: разрешено

Выполнение определенного задания spark или задачи завершается слишком рано с кодом ошибки 503 из-за регулирования учетной записи хранения

В период с 3 октября 2023 г. по 16 ноября 2023 г. несколько пулов Azure Synapse Analytics Apache Spark могли иметь сбои заданий и задач Spark из-за превышения порогового значения ограничения API хранилища.

Состояние: разрешено

Сбой запроса с предложением LIKE с помощью соединителя выделенного пула SQL Synapse в среде выполнения Spark 3.4

В открытый код Apache Spark 3.4 возникла проблема, которая экранирует специальные символы, но Synapse SQL не поддерживает ключевое слово escape. Когда клиенты используют соединитель выделенного пула SQL Azure Synapse для Apache Spark, он может создать недопустимый SQL-запрос для Synapse SQL, а записная книжка Synapse Spark или пакетное задание вызовет ошибку, аналогичную следующему:

com.microsoft.spark.sqlanalytics.SQLAnalyticsConnectorException: com.microsoft.sqlserver.jdbc.SQLServerException: Parse error at line: 1, column: XXX: Incorrect syntax near ''%test%''

Состояние: разрешено