الاسم
ST_EstimatedExtent — تُعيد الامتداد التقديري لجدول مكاني.
المختصر
box2d ST_EstimatedExtent(text schema_name, text table_name, text geocolumn_name, boolean parent_only);
box2d ST_EstimatedExtent(text schema_name, text table_name, text geocolumn_name);
box2d ST_EstimatedExtent(text table_name, text geocolumn_name);
الوصف
تُعيد الامتداد التقديري لجدول مكاني بوصفه box2d. يُستخدم المخطط (schema) الحالي إذا لم يُحدَّد. ويُؤخذ الامتداد التقديري من إحصاءات عمود الأشكال الهندسية. وهذا عادةً أسرع بكثير من حساب الامتداد الدقيق للجدول باستخدام ST_Extent أو ST_3DExtent.
السلوك الافتراضي هو استخدام الإحصاءات المجمّعة من الجداول الفرعية أيضًا (الجداول ذات INHERITS) إن توفرت. وإذا ضُبط parent_only على TRUE، فلا تُستخدم إلا إحصاءات الجدول المُعطى وتُتجاهل الجداول الفرعية.
في PostgreSQL >= 8.0.0 تُجمع الإحصاءات بواسطة VACUUM ANALYZE ويكون الامتداد الناتج نحو 95% من الامتداد الفعلي. وفي PostgreSQL < 8.0.0 تُجمع الإحصاءات بتشغيل update_geometry_stats() ويكون الامتداد الناتج دقيقًا.
![[ملاحظة]](../images/note.png)
|
|
|
في غياب الإحصاءات (جدول فارغ أو لم يُستدعَ ANALYZE) تُعيد هذه الدالة NULL. وقبل الإصدار 1.5.4 كانت تُطلق استثناءً بدلًا من ذلك. |
|
|
|
|
قد يتطلب تهريب أسماء الجداول و/أو مساحات الأسماء التي تتضمن أحرفًا خاصة وعلامات اقتباس معالجة خاصة. يشير أحد المستخدمين إلى ما يلي: «بالنسبة إلى المخططات والجداول، استخدم قواعد تهريب المعرّفات لإنتاج سلسلة نصية بين علامتي اقتباس مزدوجتين، ثم احذف علامة الاقتباس المزدوجة الأولى والأخيرة. أما عمود الأشكال الهندسية فمرّره كما هو.» |
متاحة منذ: 1.0.0
تغيّرت في: 2.1.0. حتى 2.0.x كانت تُسمّى ST_Estimated_Extent.
تدعم هذه الدالة الأقواس الدائرية (Circular Strings) والمنحنيات.
أمثلة
SELECT ST_EstimatedExtent('ny', 'edges', 'geom');
--result--
BOX(-8877653 4912316,-8010225.5 5589284)
SELECT ST_EstimatedExtent('feature_poly', 'geom');
--result--
BOX(-124.659652709961 24.6830825805664,-67.7798080444336 49.0012092590332)