全部产品
Search
文档中心

PolarDB:ST_RasterDrivers

更新时间:Jul 02, 2025

Topik ini menjelaskan fungsi ST_RasterDrivers, yang digunakan untuk menanyakan semua driver yang didukung oleh sumber data raster di Ganos.

Sintaksis

setof record ST_RasterDrivers(out idx integer,
            out short_name text,
          out long_name text,
          out can_read boolean,
              out can_export boolean,
          out can_asfile boolean,
              out create_options text);

Parameter

ParameterDeskripsi
idxID dari driver.
short_nameNama singkat dari driver.
long_nameNama lengkap dari driver.
can_readNilai valid:
  • true: Format file yang didukung oleh driver dapat digunakan dalam fungsi ST_CreateRast dan ST_ImportFrom. Untuk informasi lebih lanjut, lihat ST_CreateRast dan ST_ImportFrom.
  • false: Format file yang didukung oleh driver tidak dapat digunakan dalam fungsi ST_CreateRast atau ST_ImportFrom. Jika Anda menggunakan format file ini dalam fungsi ST_CreateRast atau ST_ImportFrom, kesalahan akan dilaporkan. Untuk informasi lebih lanjut, lihat ST_CreateRast dan ST_ImportFrom.
can_exportNilai valid:
  • true: Format file yang didukung oleh driver dapat digunakan dalam fungsi S​T_ExportTo. Untuk informasi lebih lanjut, lihat ST_ExportTo.
  • false: Format file yang didukung oleh driver tidak dapat digunakan dalam fungsi S​T_ExportTo. Jika Anda menggunakan format file ini dalam fungsi S​T_ExportTo, kesalahan akan dilaporkan. Untuk informasi lebih lanjut, lihat ST_ExportTo.
can_asfileNilai valid:
  • true: Format file yang didukung oleh driver dapat digunakan dalam fungsi ST_AsDatasetFile. Untuk informasi lebih lanjut, lihat ST_AsDatasetFile.
  • false: Format file yang didukung oleh driver tidak dapat digunakan dalam fungsi ST_AsDatasetFile. Jika Anda menggunakan format file ini dalam fungsi ST_AsDatasetFile, kesalahan akan dilaporkan. Untuk informasi lebih lanjut, lihat ST_AsDatasetFile.
create_optionsOpsi yang termasuk dalam parameter create_option dalam fungsi S​T_ExportTo dan ST_AsDatasetFile. Untuk informasi lebih lanjut, lihat ST_ExportTo dan ST_AsDatasetFile.

Contoh

-- Query informasi tentang driver netCDF. 
SELECT * FROM
st_rasterdrivers()
where short_name='netCDF';

 idx | short_name |         long_name          | can_read | can_export | can_asfile | 
create_options    

-----+------------+----------------------------+----------+------------+-----------

 36 | netCDF     | Network Common Data Format | t        | t          | t          
| <CreationOptionList>   <Option name='FORMAT' type='string-select' 
default='NC'>     <Value>NC</Value>     <Value>NC2</Value> 
    <Value>NC4</Value>     <Value>NC4C</Value>   </Option>   <Option 
name='COMPRESS' type='string-select' default='NONE'>     <Value>NONE</Value>     
<Value>DEFLATE</Value>   </Option>   <Option name='ZLEVEL' ty
pe='int' description='DEFLATE compression level 1-9' default='1'/>   <Option 
name='WRITE_BOTTOMUP' type='boolean' default='YES'>   </Option>   <Option 
name='WRITE_GDAL_TAGS' type='boolean' default='YES'>   </Opt
ion>   <Option name='WRITE_LONLAT' type='string-select'>     <Value>YES</Value>     
<Value>NO</Value>     <Value>IF_NEEDED</Value>   </Option>   <Option 
name='TYPE_LONLAT' type='string-select'>     <Value>float<
/Value>     <Value>double</Value>   </Option>   <Option name='PIXELTYPE' 
type='string-select' description='only used in Create()'>       
<Value>DEFAULT</Value>       <Value>SIGNEDBYTE</Value>   </Option>   <Opti
on name='CHUNKING' type='boolean' default='YES' description='define chunking 
when creating netcdf4 file'/>   <Option name='MULTIPLE_LAYERS' type='string-
select' description='Behaviour regarding multiple vector l
ayer creation' default='NO'>       <Value>NO</Value>       
<Value>SEPARATE_FILES</Value>       <Value>SEPARATE_GROUPS</Value>   </Option>   
<Option name='CONFIG_FILE' type='string' description='Path to a XML con
figuration file (or content inlined)'/></CreationOptionList>

-- Query semua driver yang didukung oleh fungsi ST_ImportFrom dan ST_CreateRast. 
select short_name from 
st_rasterdrivers()  
where can_read =true;

-- Query semua driver yang didukung oleh fungsi ST_ExportTo. 
select short_name from 
st_rasterdrivers()  
where can_export =true;

-- Query semua driver yang didukung oleh fungsi ST_AsDatasetFile. 
select short_name from 
st_rasterdrivers()  
where can_asfile =true;