Синхронизация метаданных конечной точки SQL-аналитики

В этой статье описано, что представляет собой конечная точка SQL-аналитики, как она синхронизируется с вашим lakehouse и какие элементы управления доступны для управления этой синхронизацией. Конечная точка SQL-аналитики автоматически обнаруживает изменения и обновляет свои метаданные SQL в фоновом режиме. Вы также можете мануально обновлять метаданные конечной точки аналитики SQL с помощью портала Fabric, REST API или хранимой процедуры T-SQL.

Фоновый процесс синхронизации метаданных считывает журналы Delta из /Tables папки в OneLake и сохраняет схему SQL в актуальном состоянии.

Microsoft Fabric автоматически поддерживает конечную точку SQL-аналитики в синхронизированном состоянии с базовым озером данных. Инфраструктуру не нужно настраивать и, в большинстве случаев, не требуется никаких действий со стороны пользователя. Платформа отвечает за:

  • Обнаружение таблиц — обнаружение только что созданных или удаленных таблиц Delta в lakehouse и создание или удаление соответствующих таблиц SQL в конечной точке.
  • Свежесть данных — обнаружение изменений (вставок, обновлений, удалений), внесенных в данные в существующих таблицах, и обеспечение возврата запросов up-to-date результатов.
  • Обнаружение изменений схемы — обнаружение добавлений столбцов, удаления или изменения типов в существующих таблицах Delta и обновление соответствующего определения таблицы SQL.

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

Обнаружение изменений схемы и синхронизация метаданных

Каждое Lakehouse, хранилище, база данных и зеркальная база данных в Fabric автоматически получает собственную конечную точку аналитики SQL, поэтому вы можете выполнять запросы к таблицам Delta с помощью T-SQL и протокола TDS без перемещения и копирования данных.

  • Каждый Lakehouse, хранилище данных, база данных и зеркальная база данных имеет ровно одну конечную точку SQL-аналитики.
  • Каждая таблица Delta в базовом элементе автоматически отображается в виде таблицы SQL в конечной точке.
  • Конечная точка доступна только для чтения по автоматически созданным таблицам. Модель можно расширить с помощью собственных схем SQL, представлений, хранимых процедур и функций.
  • Эта конечная точка использует тот же вычислительный движок, что и Fabric Data Warehouse, поэтому обеспечивает выполнение высокопроизводительных SQL-запросов с низкой задержкой к открытым файлам Delta.

Новая синхронизация метаданных (предварительная версия)

Important

Эта функция доступна в предварительной версии.

В мае 2026 года новая синхронизация метаданных для конечной точки аналитики SQL была объявлена в качестве предварительной версии функции. Вы можете включить новый процесс синхронизации метаданных, который применяется только к новым конечным точкам аналитики SQL. Новый параметр синхронизации метаданных обеспечивает доступность данных для запросов уже через несколько секунд после их поступления в lakehouse.

Новый процесс синхронизации метаданных включает следующие функции:

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

Включение синхронизации новых метаданных

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

Снимок экрана из портала Fabric, на странице параметров рабочей области, на котором показаны параметр New metadata sync для Warehouse и панель «New metadata sync (preview)».

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

Поиск последнего обновления метаданных

Если вы используете новую версию синхронизации метаданных, вы можете использовать динамические административные представления (DMV) для получения сведений о последнем обновлении конечной точки аналитики SQL. sys.dm_db_external_tables_log_status Используйте dmV для получения сведений о последней синхронизации метаданных:

  • last_update_time_utc: метка времени последнего обновления таблицы с новыми данными.
  • latest_log_version: Максимальная версия журнала транзакций Delta для обновлённой таблицы.
  • latest_checkpoint_version: Последняя обработанная версия контрольной точки Delta.
  • is_blocked: указывает, была ли последняя попытка обновления таблицы заблокирована (1) или успешно (0).

Дополнительные сведения см. в sys.dm_db_external_tables_log_status.

Ограничения новой синхронизации метаданных

  • Новая синхронизация метаданных не поддерживает многочастную контрольную точку — устаревшую delta-функцию. Если таблицы Lakehouse содержат многокомпонентные контрольные точки, они не могут обновляться в новой синхронизации метаданных.

Обновление вручную

Помимо фоновых процессов, которые автоматически обновляют данные, можно вручную обновить метаданные:

  • Обновление на портале: в редакторе конечной точки аналитики SQL на портале Fabric нажмите значок Обновить на панели инструментов Обозреватель, чтобы принудительно запустить синхронизацию метаданных по требованию. Перейдите на вкладку Запрос конечной точки аналитики SQL и найдите кнопку обновления на панели инструментов.

    Снимок экрана из портала Fabric, показывающий кнопку

  • Обновление с помощью REST API: Используйте REST API обновления метаданных конечной точки SQL, чтобы программно обновить метаданные конечной точки SQL-аналитики.

  • Обновление с помощью хранимой процедуры: используйте системную хранимую процедуру sys.sp_dw_refresh_ext_table для обновления данных для определенной таблицы в конечной точке аналитики SQL. Этот метод T-SQL доступен только в том случае, если конечная точка аналитики SQL была создана после включения синхронизации новых метаданных (предварительная версия). Рассмотрим пример.

    EXEC sys.sp_dw_refresh_ext_table "dbo.publicholidays";
    

Используйте API только в том случае, если у вас есть изменения схемы, например добавление или удаление таблиц или столбцов, изменение типов столбцов и необходимость обновления всего элемента. Для изменений, затрагивающих только данные, в конечной точке SQL Analytics используйте системную хранимую процедуру sys.sp_dw_refresh_ext_table для обновления конкретной таблицы.

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