ST_Raster.export
Definition
Mit der ST_Raster.export-Funktion wird entweder ein ganzes ST_Raster-Objekt oder Teile davon in eine Bilddatei geschrieben. Diese Funktion ist nur zur Verwendung als Teil der Auswahlliste einer SQL-SELECT-Anweisung vorgesehen.
Syntax
Oracle
export (filename IN VARCHAR2) RETURN VARCHAR2 export (filename IN VARCHAR2, parameter_list IN VARCHAR2) RETURN VARCHAR2
PostgreSQL
export (raster IN ST_RASTER, filename IN TEXT) RETURN TEXT export (raster IN ST_RASTER, filename IN TEXT, parameter_list IN TEXT) RETURN TEXT
SQL Server
export (filename IN NVARCHAR, parameter_list IN NVARCHAR) RETURN NVARCHAR
Rückgaben
VARCHAR
Parameter
Parameter | Beschreibungen |
---|---|
Dateiname | Der Name der exportierten Raster-Datei. Der Dateinamenparameter ist ein VARCHAR, das heißt, er muss in einfache Anführungszeichen eingeschlossen werden. Die Erweiterung des Dateinamens legt das Raster-Format fest, das zum Exportieren der Datei verwendet wird. Derzeit wird als Raster-Format für den Export "GeoTIFF" unterstützt. Daher wird die Erweiterung ".tif" angehängt. |
Raster | Der zu exportierende ST_Raster-Wert. |
parameter_list | Eine kommagetrennte Liste mit in einfachen Anführungszeichen eingeschlossenen Parametern, die folgende Parameter umfassen kann:
|
Beispiele
In diesen Beispielen wird Folgendes veranschaulicht:
- Exportieren eines ST_Raster-Objekts in eine GeoTIFF-Datei mit dem Namen "border.tif"
- Exportieren einer zweiten Pyramidenebene eines ST_Raster-Objekts, einer GeoTIFF-Datei und der Datei "pyramid.tif", in absteigender Bandsequenz-Reihenfolge
In diesen Beispielen werden die Dateien in den Speicherort auf dem DBMS-Server exportiert, in dem SQL verarbeitet wird. Sie werden höchstwahrscheinlich einen bestimmten Pfad mit den Dateinamen angeben. Stellen Sie dabei sicher, dass der Pfad für den DBMS-Server gültig ist.
Oracle
-
SELECT image.export('border.tif', 'compression=zip') FROM BORDER t WHERE t.image.raster_id = 10;
-
SELECT image.export('pyramid.tif', 'level=2, band=(3,2,1)') FROM BORDER WHERE image.raster_id = 20;
PostgreSQL
-
SELECT export(image,'border.tif', 'compression=zip') FROM border WHERE raster_id(image) = 10;
-
SELECT export(image, 'pyramid.tif', 'level=2, band=(3,2,1)') FROM border WHERE raster_id(image) = 20;
SQL Server
-
SELECT image.export('border.tif', 'compression=zip') FROM border WHERE image.raster_id = 10;
-
SELECT image.export('pyramid.tif', 'level=2, band=(3,2,1)') FROM border WHERE image.raster_id = 20;