الاسم
CreateTopology — تُنشئ مخطط طوبولوجيا جديدًا وتسجّله في الجدول topology.topology.
المختصر
integer CreateTopology(name topology_schema_name, integer srid, double precision prec, boolean hasz, integer topoid, boolean useslargeids);
الوصف
تُنشئ مخطط طوبولوجيا جديدًا باسم topology_name وتسجّله في الجدول topology.topology. يجب أن تكون أسماء الطوبولوجيات فريدة. تُنشأ جداول الطوبولوجيا (edge_data وface وnode وrelation) في المخطط. تُعيد معرّف الطوبولوجيا.
srid هو قيمة SRID لـالنظام المرجعي المكاني الخاص بالطوبولوجيا. القيمة الافتراضية لـ SRID هي -1 (غير معروف) إذا لم تُحدَّد.
تُقاس التسامح prec بوحدات النظام المرجعي المكاني. القيمة الافتراضية للتسامح هي 0.
القيمة الافتراضية لـ hasz هي false إذا لم تُحدَّد.
topoid معرّف صريح اختياري (يتيح تعيين معرّف طوبولوجيا حتمي، ويجب أن يكون فريدًا)
useslargeids اختياري، قيمته الافتراضية false. إذا كانت قيمته true فستُنشأ الطوبولوجيا بدعم المعرّفات الكبيرة (int8) للطوبولوجيا وللعناصر الأوّلية.
هذه الدالة مشابهة لدالة SQL/MM ST_InitTopoGeo لكنها توفّر وظائف أكثر.
متاحة منذ: 1.1
حُسّنت في: 2.0 أُضيفت الصيغة التي تقبل hasZ
أمثلة
إنشاء مخطط طوبولوجيا يُسمى ma_topo يخزّن الحواف والعقد في نظام Massachusetts State Plane-meters (SRID = 26986). تمثّل التسامح 0.5 متر لأن النظام المرجعي المكاني يعتمد على المتر.
SELECT topology.CreateTopology('ma_topo', 26986, 0.5);
إنشاء طوبولوجيا لولاية رود آيلاند تُسمى ri_topo في النظام المرجعي المكاني State Plane-feet (SRID = 3438)
SELECT topology.CreateTopology('ri_topo', 3438) AS topoid;
topoid
------
2