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:

  • band <1. Bandnummer>[,<2. Bandnummer>,…,<n-te Bandnummer>] - Eine kommagetrennte Liste der Sequenznummern der Bänder, die exportiert werden sollen.

    Die Pixeldaten werden in der Reihenfolge der Bandsequenznummern exportiert. Wenn dieser Parameter nicht angegeben wird, werden die Bänder in der regulären Bandsequenz-Reihenfolge exportiert.

  • level <Pyramidenebene> - Die Pyramidenebene des zu exportierenden ST_Raster-Objekts; die Standardeinstellung ist die Basisebene (0).
  • compression <lzw | g3 | g4 | zip> - Die zum Erstellen der Bilddatei verwendete Komprimierung; standardmäßig wird die Bilddatei ohne Komprimierung erstellt.
  • window (minx,miny,maxx,maxy) - Die Ausdehnung des in eine Bilddatei zu exportierenden ST_Raster-Objekts, angegeben in Pixelkoordinaten.
  • extent (minx,miny,maxx,maxy) - Die Ausdehnung des in eine Bilddatei zu exportierenden ST_Raster-Objekts, angegeben in geographischen Koordinaten.
  • overwrite - Wenn die Datei vorhanden ist, wird sie überschrieben. Standardmäßig wird ein Fehler zurückgegeben, wenn die Datei bereits vorhanden ist.

Beispiele

In diesen Beispielen wird Folgendes veranschaulicht:

  1. Exportieren eines ST_Raster-Objekts in eine GeoTIFF-Datei mit dem Namen "border.tif"
  2. 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

  1. SELECT image.export('border.tif', 'compression=zip') 
      FROM BORDER t
      WHERE t.image.raster_id = 10;
    
  2. SELECT image.export('pyramid.tif', 'level=2, band=(3,2,1)')
      FROM BORDER
      WHERE image.raster_id = 20;
    

PostgreSQL

  1. SELECT export(image,'border.tif', 'compression=zip') 
      FROM border
      WHERE raster_id(image) = 10;
    
  2. SELECT export(image, 'pyramid.tif', 'level=2, band=(3,2,1)')
      FROM border
      WHERE raster_id(image) = 20;
    

SQL Server

  1. SELECT image.export('border.tif', 'compression=zip')
     FROM border
     WHERE image.raster_id = 10;
  2.  SELECT image.export('pyramid.tif', 'level=2, band=(3,2,1)')
    FROM border
    WHERE image.raster_id = 20;

7/10/2012