هل يحافظ Dataset v3 على الأعمدة والأنواع ومستوى التفصيل ومعنى المصدر الذي يتطلبه التقرير، أم ينبغي أن يظل Report v5 مثبتاً على Dataset v2 حتى إعادة تصميم العقد التحليلي؟
دليل تشغيلي · تطور الإصدارات
طوّر Dataset وتقريراً من دون إعادة كتابة سجلهما.
استخدم مسار العمل هذا عندما تتغير SQL المملوكة لـDataset أو تسلسل نسب المصدر أو المخطط أو الأعمدة أو بيانات الأعمدة الوصفية، ويجب على تقرير قائم أن يقرر ما إذا كان سيعتمد العقد الجديد.
تحمل Dataset وDatasetVersion وDatasetColumn عقد البيانات الأساسي. ويحمل ReportVersion القصد التحليلي وعمليات الربط الدقيقة بـDatasetVersion. ويسجل AnalyticsRun تنفيذاً واحداً ضمن الحوكمة الحالية.
لا ينقل DatasetVersion الجديد ReportVersion قائماً بمفرده أبداً.
يُبقي رفض المرشح إصدار التقرير السابق الموجّه للإنتاج وعمليات ربط تشغيلاته التاريخية من دون تغيير.
توفر مقارنة الإصدارات وهوية DatasetVersion المقبولة وربط ReportVersion غير القابل للتغيير وتجزئات التجميع والإعداد والمرشحات وأمن مستوى الصفوف وAnalyticsRun اللاحقة السلسلة المسجلة للتغيير المدعوم.
سؤال القرار
هل يحافظ Dataset v3 على الأعمدة والأنواع ومستوى التفصيل ومعنى المصدر الذي يتطلبه التقرير، أم ينبغي أن يظل Report v5 مثبتاً على Dataset v2 حتى إعادة تصميم العقد التحليلي؟
الكائنات والضوابط المستخدمة
تحمل Dataset وDatasetVersion وDatasetColumn عقد البيانات الأساسي. ويحمل ReportVersion القصد التحليلي وعمليات الربط الدقيقة بـDatasetVersion. ويسجل AnalyticsRun تنفيذاً واحداً ضمن الحوكمة الحالية.
دورة حياة Dataset وهوية DatasetVersion غير القابلة للتغيير
SQL المطبعة وتسلسل نسب المصدر والأعمدة والأنواع وبيانات الملف التعريفي المعروفة
أبعاد التقرير ومقاييسه ورسمه ومرشحاته الدائمة وعمليات الربط الدقيقة
سياق التجميع والصلاحيات وأمن مستوى الصفوف والمعاينة الذي يملكه الخادم
تدفق القبول
لا ينقل DatasetVersion الجديد ReportVersion قائماً بمفرده أبداً.
-
إنشاء DatasetVersion الجديد
احفظ عقد SQL والمخطط والأعمدة المتغير والمملوك لـDataset، مع الحفاظ على هوية Dataset الثابتة وجميع الإصدارات السابقة.
-
مقارنة الإصدارات الدقيقة
راجع فرق SQL المطبعة وتسلسل نسب المصدر والأعمدة المضافة والمحذوفة والمتغيرة والأنواع وحالة قبول القيم الفارغة والبيانات الوصفية التاريخية غير المتاحة.
-
تقييم التوافق التحليلي
أكّد مستوى التفصيل والأبعاد وحقول المصدر المقصودة التي يتطلبها كل مقياس؛ ولا تستنتج التوافق من تطابق الأسماء وحده.
-
فتح مسودة تقرير جديدة
أبقِ ReportVersion السابق غير قابل للتغيير واربط المسودة بـDatasetVersion المرشح.
-
التحقق والتجميع
حدد البيانات الوصفية وتحقق من سياق الاستعلام واجمع SQL للقراءة فقط والتي يملكها الخادم لمسار اللهجة المدعوم حالياً.
-
المعاينة ضمن الحوكمة
نفّذ معاينة محدودة ضمن نطاق الصلاحيات وأمن مستوى الصفوف الحالي، وراجع التشخيصات بدلاً من الاكتفاء بالتحقق من المخطط.
-
حفظ ReportVersion المقبول
احفظ الربط الجديد بعد القبول فقط؛ وتشير AnalyticsRuns اللاحقة إلى زوج ReportVersion وDatasetVersion الدقيق ذلك.
مسارات الفشل والنتائج الجزئية
يُبقي رفض المرشح إصدار التقرير السابق الموجّه للإنتاج وعمليات ربط تشغيلاته التاريخية من دون تغيير.
حقل محذوف أو متغير
يمنع التجميع أو التحقق الدلالي المسودة؛ فأعد تصميم البعد أو المقياس بدلاً من تغيير ReportVersion القديم.
اختلاف غير متوقع في المعاينة
تعامل مع انجراف الصفوف الحية وتغير المصدر ونطاق المرشحات وأمن مستوى الصفوف وتغير العقد بوصفها فرضيات منفصلة؛ فـDatasetVersion الافتراضي ليس لقطة للصفوف.
الربط المتعدد جزئي
راجع تشخيص كل ربط واحفظ الحالة الجزئية؛ ولا تعتمد التقرير انطلاقاً من الربط الناجح وحده.
الأدلة المنتجة
توفر مقارنة الإصدارات وهوية DatasetVersion المقبولة وربط ReportVersion غير القابل للتغيير وتجزئات التجميع والإعداد والمرشحات وأمن مستوى الصفوف وAnalyticsRun اللاحقة السلسلة المسجلة للتغيير المدعوم.
Report v4 → Dataset v2 · Report v5 → Dataset v2 · Report v6 → Dataset v3
الحدود الحالية
تغطي المقارنة SQL والمخطط والأعمدة والبيانات الوصفية والنسب المسجلة، ولا تختلق أثراً تجارياً شاملاً لاحقاً. وتظل مقاييس Analytics وأمن مستوى الصفوف وصلاحيات التقارير خارج تجميع Dataset الأساسي، وتتطلب الصفوف التاريخية الدقيقة أصلاً أو عقد لقطة مادية صريحاً.
الخطوة التالية
راجع حدود الإصدارات في نموذج المنتج.
تملك Dataset عقد البيانات، بينما تملك Analytics قصد التقرير والمقاييس وأمن مستوى الصفوف والتنفيذ.
استكشف Datasets المحكومة