Сохраняет ли Dataset v3 столбцы, типы, гранулярность и смысл источника, необходимые отчёту, или Report v5 должна оставаться привязанной к Dataset v2 до переработки аналитического контракта?
Операционное руководство · Развитие версий
Развивайте Dataset и отчет, не переписывая их историю.
Используйте этот рабочий процесс, когда меняется принадлежащий Dataset SQL, происхождение источника, схема, столбцы или метаданные столбцов и существующий отчет должен решить, принимать ли новый контракт.
Dataset, DatasetVersion и DatasetColumn несут базовый контракт данных. ReportVersion несёт аналитическое намерение и точные привязки DatasetVersion. AnalyticsRun фиксирует одно выполнение под текущим управлением.
Новая DatasetVersion никогда не перемещает существующую ReportVersion автоматически.
Отклонённый кандидат не меняет прежнюю рабочую версию отчёта и её исторические привязки запусков.
Сравнение версий, идентичность принятой DatasetVersion, неизменяемый привязка ReportVersion, хеши компиляции, конфигурации, фильтров и RLS и последующий AnalyticsRun образуют зафиксированную цепочку поддерживаемого изменения.
Вопрос решения
Сохраняет ли Dataset v3 столбцы, типы, гранулярность и смысл источника, необходимые отчёту, или Report v5 должна оставаться привязанной к Dataset v2 до переработки аналитического контракта?
Используемые объекты и контроли
Dataset, DatasetVersion и DatasetColumn несут базовый контракт данных. ReportVersion несёт аналитическое намерение и точные привязки DatasetVersion. AnalyticsRun фиксирует одно выполнение под текущим управлением.
Жизненный цикл Dataset и неизменяемая идентичность DatasetVersion
Нормализованный SQL, происхождение источника, столбцы, типы и известные метаданные профиля
Измерения, метрики, диаграмма, постоянные фильтры и точные привязки отчёта
Принадлежащие серверу компиляция, разрешения, RLS и контекст предварительного просмотра
Поток принятия
Новая DatasetVersion никогда не перемещает существующую ReportVersion автоматически.
-
Создайте новую DatasetVersion
Сохраните изменённый принадлежащий Dataset контракт SQL, схемы и столбцов, сохранив стабильную идентичность Dataset и все прежние версии.
-
Сравните точные версии
Изучите различия нормализованного SQL, происхождения источника, добавленных, удалённых и изменённых столбцов, типов, допустимости NULL и недоступных исторических метаданных.
-
Оцените аналитическую совместимость
Подтвердите предполагаемую гранулярность, измерения и поля источника, необходимые каждой метрике; не выводите совместимость только из совпадающих имён.
-
Откройте новый черновик отчёта
Сохраните прежнюю ReportVersion неизменяемой и привяжите черновик к кандидатной DatasetVersion.
-
Проверьте и скомпилируйте
Разрешите метаданные, проверьте контекст запроса и скомпилируйте принадлежащий серверу SQL только для чтения по текущему поддерживаемому пути диалекта.
-
Выполните контролируемый предварительный просмотр
Выполните ограниченный предварительный просмотр в текущей области разрешений и RLS и изучите диагностику, не ограничиваясь проверкой схемы.
-
Сохраните принятую ReportVersion
Сохраняйте новую привязку только после принятия; последующие AnalyticsRuns указывают на точную пару ReportVersion и DatasetVersion.
Пути сбоя и частичного результата
Отклонённый кандидат не меняет прежнюю рабочую версию отчёта и её исторические привязки запусков.
Поле удалено или изменено
Ошибка компиляции или семантической проверки блокирует черновик; переработайте измерение или метрику вместо изменения старой ReportVersion.
Предварительный просмотр неожиданно отличается
Рассматривайте дрейф актуальных строк, изменение источника, область фильтров и RLS и изменение контракта как отдельные гипотезы; виртуальная DatasetVersion не является снимком строк.
Выполнение с несколькими привязками частично
Проверяйте диагностику каждой привязки и сохраняйте частичное состояние; не сертифицируйте отчёт только по успешной привязке.
Создаваемые доказательства
Сравнение версий, идентичность принятой DatasetVersion, неизменяемый привязка ReportVersion, хеши компиляции, конфигурации, фильтров и RLS и последующий AnalyticsRun образуют зафиксированную цепочку поддерживаемого изменения.
Report v4 → Dataset v2 · Report v5 → Dataset v2 · Report v6 → Dataset v3
Текущая граница
Сравнение охватывает записанные SQL, схему, столбцы, метаданные и происхождение, но не изобретает универсальное влияние на последующие системы. Метрики Analytics, RLS и разрешения отчёта остаются за пределами базового агрегированного Dataset, а точные исторические строки требуют артефакта или явного контракта материализованного снимка.
Следующий шаг
Изучите границы версий в модели продукта.
Dataset владеет контрактом данных; Analytics владеет намерением отчёта, метриками, RLS и выполнением.
Изучить управляемые Dataset