GISarabia.org
PostGIS › الدليل الرسمي › 11. مرجع الرستر › 11.5. دوال الوصول إلى نطاقات الرستر
PostGIS 3.6 · Official Manual · ترجمة عربية

ST_BandMetaData

الصفحة الأصلية بالإنجليزية postgis.net ↗

الاسم

ST_BandMetaData — تُعيد البيانات الوصفية الأساسية لنطاق رستر محدد. يُفترض النطاق رقم 1 إذا لم يُحدَّد.

المختصر

(1) record ST_BandMetaData(raster rast, integer band=1);

(2) record ST_BandMetaData(raster rast, integer[] band);

الوصف

تُعيد البيانات الوصفية الأساسية عن نطاق رستر. الأعمدة المُعادة: pixeltype وnodatavalue وisoutdb وpath وoutdbbandnum وfilesize وfiletimestamp.

[ملاحظة]

إذا لم يحتوِ الرستر على أي نطاقات، يُطلَق خطأ.

[ملاحظة]

إذا لم تكن للنطاق قيمة NODATA، تكون nodatavalue مساوية NULL.

[ملاحظة]

إذا كانت isoutdb تساوي False، تكون path وoutdbbandnum وfilesize وfiletimestamp مساوية NULL. وإذا كان الوصول إلى البيانات خارج قاعدة البيانات (outdb) معطَّلًا، فستكون filesize وfiletimestamp أيضًا مساوية NULL.

حُسّنت في: 2.5.0 لتتضمن outdbbandnum وfilesize وfiletimestamp للرسترات المخزّنة خارج قاعدة البيانات.

أمثلة: الصيغة 1

SELECT
    rid,
    (foo.md).*
FROM (
    SELECT
        rid,
        ST_BandMetaData(rast, 1) AS md
    FROM dummy_rast
    WHERE rid=2
) As foo;

 rid | pixeltype | nodatavalue | isoutdb | path | outdbbandnum
-----+-----------+---- --------+---------+------+--------------
   2 | 8BUI      |           0 | f       |      |
                

أمثلة: الصيغة 2

WITH foo AS (
    SELECT
        ST_AddBand(NULL::raster, '/home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif', NULL::int[]) AS rast
)
SELECT
    *
FROM ST_BandMetadata(
    (SELECT rast FROM foo),
    ARRAY[1,3,2]::int[]
);

 bandnum | pixeltype | nodatavalue | isoutdb |                                      path                                      | outdbbandnum  | filesize | filetimestamp |
---------+-----------+-------------+---------+--------------------------------------------------------------------------------+---------------+----------+---------------+-
       1 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif      |            1  |    12345 |    1521807257 |
       3 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif      |            3  |    12345 |    1521807257 |
       2 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif      |            2  |    12345 |    1521807257 |
                

انظر أيضًا

ST_MetaData، ST_BandPixelType