Устранение неполадок зеркальных баз данных Fabric

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

Исходный материал Ограничения Troubleshoot Часто задаваемые вопросы
Azure Cosmos DB (облачная база данных) Ограничения Устранение неполадок Вопросы и ответы
База данных Azure для MySQL Ограничения Устранение неполадок Вопросы и ответы
База данных Azure для PostgreSQL Ограничения Устранение неполадок Вопросы и ответы
Azure Databricks Ограничения Вопросы и ответы
База данных SQL Azure Ограничения Устранение неполадок Вопросы и ответы
Управляемый экземпляр SQL Azure Ограничения Устранение неполадок Вопросы и ответы
База данных SQL Fabric Ограничения Устранение неполадок Вопросы и ответы
Google BigQuery (сервис анализа данных) Ограничения Вопросы и ответы
Oracle Ограничения
SAP Ограничения
Snowflake Ограничения Устранение неполадок
SQL Server Ограничения Устранение неполадок Вопросы и ответы

Изменения емкости Fabric

Scenario Description
Вместимость фабрики приостановлена Зеркалирование останавливается, и список содержимого или доступ к элементам зеркальной базы данных недоступны. Возобновите или переназначьте ресурсы в вашем рабочем пространстве.
Емкость Fabric возобновилась При возобновлении емкости из приостановленного состояния зеркальная база данных отображается как приостановленная. В результате изменения, внесенные в источник, не реплицируются в OneLake.
Чтобы возобновить зеркальное отображение, перейдите в зеркальную базу данных на портале Fabric, выберите "Возобновить репликацию". Процесс синхронизации продолжается с того места, где была приостановка.
Если емкость остается приостановленной в течение длительного времени, зеркальное отображение может не возобновиться с точки остановки и повторно изменить данные с самого начала. Повторное выполнение происходит, так как приостановка зеркального отображения в течение длительного времени приводит к росту использования журнала транзакций базы данных-источника и предотвращает усечение журнала. Чтобы свести к минимуму влияние на исходную базу данных, если используемое пространство журнала близко к заполнению, при возобновлении зеркалирования, пересев базы данных освобождает пространство журнала.
Масштабирование емкости Fabric Отражение продолжается. Если уменьшить емкость, помните, что хранилище OneLake для зеркальных данных освобождается до предела в зависимости от размера емкости, поэтому масштабирование емкости может привести к дополнительным затратам на хранение. Дополнительные сведения см. в разделе "Стоимость зеркального отображения".
Регулирование емкости Fabric Дождитесь завершения состояния перегрузки или увеличьте вместимость. Зеркалирование продолжается после восстановления вместимости. Дополнительные сведения см. в разделе "Действия", которые можно предпринять для восстановления из ситуаций перегрузки.
Срок действия пробной версии Fabric истек Зеркальное отображение прекращается. Чтобы сохранить зеркальную базу данных, приобретите емкость Fabric. Дополнительные сведения см. в статье о истечении срока действия пробной версии Fabric.

Данные, как представляется, не реплицируются

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

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

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

    Для таких типов источников, как База данных SQL Azure, Управляемый экземпляр SQL Azure, База данных Azure для MySQL и База данных Azure для PostgreSQL, следуйте инструкциям, чтобы также проверить конфигурацию и состояние базы данных-источника.

  • Данные в OneLake: Зеркалирование непрерывно реплицирует ваши данные в OneLake в формате таблицы Delta Lake. Чтобы проверить, что данные правильно загружаются в OneLake, можно создать символическую ссылку из зеркальных таблиц в Lakehouse, а затем создать записные книжки с помощью запросов Spark для работы с данными. Узнайте больше об Explore with notebooks.

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

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

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

Остановить репликацию

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

Репликация иерархии исходной схемы

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

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

Если вы используете API для создания или обновления зеркальной базы данных, задайте значение для defaultSchema свойства, указывающее, следует ли реплицировать иерархию схем из исходной базы данных. См. примеры определений в Microsoft Fabric зеркального отображения общедоступного REST API.

Поддержка сопоставления столбцов Дельта

Зеркальное отображение поддерживает репликацию столбцов, содержащих пробелы или специальные символы в именах (например,;, {}()\n) \t=из исходных баз данных в зеркальные базы данных. Зеркальное отображение записывает данные в OneLake с включенным сопоставлением столбцов Delta.

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

Владение зеркальной базой данных

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

Поддерживаемые регионы

Зеркальное отображение базы данных и открытое зеркальное отображение доступны во всех Microsoft Fabric регионах. Дополнительные сведения см. в разделе "Доступность региона Fabric".

Troubleshoot

В этом разделе содержатся общие действия по устранению неполадок зеркального отображения.

Не удается подключиться к исходной базе данных

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

Представления не реплицируются

В настоящее время представления не поддерживаются. Только обычные таблицы поддерживают репликацию.

Никакие таблицы не реплицируются

  1. Проверьте состояние мониторинга, чтобы проверить состояние таблиц. Дополнительные сведения см. в статье Monitor Fabric для зеркальной репликации базы данных.
  2. Нажмите кнопку "Настройка репликации ". Проверьте, присутствуют ли таблицы в списке таблиц или имеются ли какие-либо оповещения о деталях каждой таблицы.

Столбцы отсутствуют в целевой таблице

  1. Нажмите кнопку "Настройка репликации ".
  2. Щелкните значок оповещения рядом с подробными сведениями о таблице, если какие-либо столбцы не реплицируются.

Некоторые данные в моем столбце, как представляется, усечены

Конечная точка аналитики SQL поддерживает varchar(max) до 16 МБ.

  • Ограничение в 16 МБ применяется к таблицам, созданным после 18 ноября 2025 г. в зеркальных базах данных, но каждый тип зеркального элемента может иметь разные и нижние пределы. Например, зеркальный SQL Server поддерживает до 1 МБ, а Cosmos DB поддерживает до 2 МБ. См. следующую таблицу.
  • Существующие таблицы, созданные до 18 ноября 2025 г., поддерживают только varchar(8000) и необходимо повторно создать для внедрения нового типа данных и поддержки данных больше 8 КБ.
Зеркальный элемент платформы ограничение varchar(max)
Зеркальный SQL Server, Azure SQL Database, Azure SQL Managed Instance 1 МБ
База данных SQL в Fabric 1 МБ
Зеркальное отображение Azure Cosmos DB 2 МБ
Cosmos DB в Fabric 2 МБ

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

Уровень таблицы:

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

Уровень схемы. При удалении схемы в исходной базе данных схема по-прежнему отображается в конечной точке аналитики SQL как пустая схема.

Не удается изменить исходную базу данных

Изменение исходной базы данных не поддерживается. Создайте новую зеркальную базу данных.

Ограничивает сообщения об ошибках

Эти распространенные сообщения об ошибках имеют объяснения и способы устранения рисков:

Сообщение об ошибке Причина Смягчение
"Число таблиц может превышать ограничение, может быть отсутствуют некоторые таблицы". Существует не более 1000 таблиц. В исходной базе данных удалите или отфильтруйте таблицы. Если новая таблица является 1000-й таблицей, не требуется устранение рисков.
Репликация ограничивается и, как ожидается, продолжится в YYYY-MM-DDTHH:MM:ss. Максимум 1 ТБ измененных данных захватывается ежедневно на каждую зеркальную базу данных. Дождитесь завершения регулирования.