全部产品
Search
文档中心

ApsaraDB RDS:ST_RasterDrivers

更新时间:Jun 25, 2025

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

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

Parameter

Deskripsi

idx

ID dari driver.

short_name

Nama singkat dari driver.

long_name

Nama lengkap dari driver.

can_read

Nilai 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_export

Nilai 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_asfile

Nilai 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_options

Opsi 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 information about the netCDF driver. 
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 all drivers that are supported by the ST_ImportFrom and ST_CreateRast functions. 
select short_name from 
st_rasterdrivers()  
where can_read =true;

-- Query all drivers that are supported by the ST_ExportTo function. 
select short_name from 
st_rasterdrivers()  
where can_export =true;

-- Query all drivers that are supported by the ST_AsDatasetFile function. 
select short_name from 
st_rasterdrivers()  
where can_asfile =true;