sa_describe_shapefile-Systemprozedur

Beschreibt die Namen und Typen der Spalten in einer ESRI-Formdatei. Diese Systemfunktion wird zusammen mit den Funktionen für räumliche Daten verwendet.

Syntax

sa_describe_shapefile( 
shp_filename 
, srid 
[, encoding ] 
)

Argumente

shp_filename Ein VARCHAR(512)-Parameter, der den Speicherort der ESRI-Formdatei identifiziert. Der Dateiname muss die die Erweiterung .shp haben und ihm muss eine .dbf-Datei zugeordnet sein, die denselben Basisnamen hat und sich in demselben Verzeichnis befindet. Der Pfad ist relativ zum Datenbankserver, nicht zur Clientanwendung.
srid Ein INTEGER-Parameter, der die SRID für die Geometrien in der Formdatei identifiziert. Geben Sie NULL an, um anzuzeigen, dass in der Spalte mehrere SRIDs gespeichert werden können. Wenn Sie NULL angeben, beschränkt dies allerdings die Vorgänge, die mit den Geometriewerten durchgeführt werden können.
encoding Ein optionaler VARCHAR(50)-Parameter, der die beim Lesen der Formdatei zu verwendende Kodierung identifiziert. Der Standardwert ist NULL. Wenn die Kodierung NULL ist, wird der ISO-8859-1-Zeichensatz verwendet.

Ergebnismenge

Spaltenname	Datentyp	Beschreibung
column_number	INTEGER	Die Ordinalposition der von dieser Zeile beschriebenen Spalte, beginnend mit 1.
name	VARCHAR(128)	Der Name der Spalte.
domain_name_with_size	VARCHAR(160)	Der Datentypname mit Größe und Gesamtstellenzahl (wie in CREATE TABLE- und CAST-Funktionen verwendet).

Die sa_describe_shapefile-Systemprozedur wird verwendet, um Namen und Typ der Spalten in einer ESRI-Formdatei zu beschreiben. Diese Informationen können verwendet werden, um eine Tabelle zu erstellen, anhand derer Daten aus einer Formdatei mithilfe der LOAD TABLE- oder INPUT-Anweisung geladen werden. Alternativ kann diese Systemprozedur verwendet werden, um eine Formdatei durch Angeben der WITH-Klausel für OPENSTRING ... FORMAT SHAPEFILE zu lesen.

Privilegien

Wenn die Datenbankoption -gl auf DBA gesetzt ist, müssen Sie eines der folgenden Systemprivilegien haben:
- ALTER ANY TABLE
- ALTER ANY TABLE
- LOAD ANY TABLE
- READ FILE
Wenn die Datenbankoption -gl auf ALL gesetzt ist, sind keine Privilegien erforderlich.
Wenn Datenbankoption -gl auf NONE gesetzt ist, müssen Sie das READ FILE-Systemprivileg haben.

Siehe auch

Beispiel

Im folgenden Beispiel wird eine Zeichenfolge angezeigt, die verwendet werden kann, um eine Tabelle zum Speichern von Formdatei-Daten zu erstellen:

BEGIN
    DECLARE create_cmd LONG VARCHAR;
    SELECT 'create table if not exists esri_load( record_number int primary key, ' ||
         (SELECT list( name || ' ' || domain_name_with_size, ', ' ORDER BY column_number )
     FROM sa_describe_shapefile( 'c:\\esri\\tgr36069trt00.shp', 1000004326 )
     WHERE column_number > 1 ) || ' )' 
     INTO create_cmd;
     SELECT create_cmd;
     EXECUTE IMMEDIATE create_cmd;
END

Sie können die Formdatei-Daten in die Tabelle laden, indem Sie die folgende Anweisung ausführen (vorausgesetzt, Sie haben das LOAD ANY TABLE-Systemprivileg und die Datenbankoption -gl wurde nicht auf NONE gesetzt):

LOAD TABLE esri_load 
USING FILE 'c:\\esri\\tgr36069trt00.shp' 
FORMAT SHAPEFILE;

Kommentieren Sie diese Seite in DocCommentXchange.