Синхронизация метаданных конечной точки 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 содержат многокомпонентные контрольные точки, они не смогут обновиться в новой синхронизации метаданных.
  • Если для вашей рабочей области используется Private Link, в настоящее время новую синхронизацию метаданных нельзя включить.

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

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

  • Обновление на портале: в редакторе конечной точки аналитики 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.