Todos os produtos
Search
Central de documentação

ApsaraDB RDS:ST_RasterDrivers

Última atualização: Aug 24, 2026

Este tópico descreve a função ST_RasterDrivers, usada para consultar todos os drivers compatíveis com fontes de dados raster no GanosBase.

Ganos

Sintaxe

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);

Parâmetros

Parâmetro

Descrição

idx

ID do driver.

short_name

Nome abreviado do driver.

long_name

Nome completo do driver.

can_read

Valores válidos:

  • true: os formatos de arquivo compatíveis com o driver podem ser usados nas funções ST_CreateRast e ST_ImportFrom. Para obter mais informações, consulte ST_CreateRast e ST_ImportFrom.

  • false: os formatos de arquivo compatíveis com o driver não podem ser usados nas funções ST_CreateRast ou ST_ImportFrom. O uso desses formatos nessas funções gera erros. Para obter mais informações, consulte ST_CreateRast e ST_ImportFrom.

can_export

Valores válidos:

  • true: os formatos de arquivo compatíveis com o driver podem ser usados na função ST_ExportTo. Para obter mais informações, consulte ST_ExportTo.

  • false: os formatos de arquivo compatíveis com o driver não podem ser usados na função ST_ExportTo. O uso desses formatos nessa função gera erros. Para obter mais informações, consulte ST_ExportTo.

can_asfile

Valores válidos:

  • true: os formatos de arquivo compatíveis com o driver podem ser usados na função ST_AsDatasetFile. Para obter mais informações, consulte ST_AsDatasetFile.

  • false: os formatos de arquivo compatíveis com o driver não podem ser usados na função ST_AsDatasetFile. O uso desses formatos nessa função gera erros. Para obter mais informações, consulte ST_AsDatasetFile.

create_options

Opções incluídas no parâmetro create_option das funções ST_ExportTo e ST_AsDatasetFile. Para obter mais informações, consulte ST_ExportTo e ST_AsDatasetFile.

Exemplos

-- 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;