sa_describe_shapefile 系统过程

sa_describe_shapefile( 
shp_filename 
, srid 
[, encoding ] 
)

shp_filename 标识 ESRI shapefile 位置的 VARCHAR(512) 参数。文件名必须包含扩展名 .shp，并且在相同目录中还必须有与相同基本名相关联的 .dbf 文件。路径相对于数据库服务器，而不是客户端应用程序。
srid 标识 shapefile 中几何的 SRID 的 INTEGER 参数。指定 NULL 以表明该列可以存储多个 SRID。指定 NULL 限制可以在几何值上执行的操作。
编码可选的 VARCHAR(50) 参数，用于标识在读取 shapefile 时要使用的编码。缺省值为 NULL。如果编码为 NULL，则使用 ISO-8859-1 字符集。

列名	数据类型	说明
column_number	INTEGER	此行描述的列的顺序位置，从 1 开始。
name	VARCHAR(128)	列的名称。
domain_name_with_size	VARCHAR(160)	数据类型名称，包括大小和精度（如 CREATE TABLE 或 CAST 函数中所用）。

sa_describe_shapefile 系统过程用于说明 ESRI shapefile 中的列的名称和类型。此信息可用于创建一个表，以便使用 LOAD TABLE 或 INPUT 语句从 shapefile 装载数据。或者，也可以通过为 OPENSTRING...FORMAT SHAPEFILE 指定 WITH 子句来使用该系统过程读取 shapefile。

如果 -gl 数据库选项设置为 DBA，您必须具有以下其中一种系统特权：
- ALTER ANY TABLE
- ALTER ANY OBJECT
- LOAD ANY TABLE
- READ FILE
如果 -gl 数据库选项设置为 ALL，则不需要任何特权。
如果 -gl 数据库选项设置为 NONE，您必须具有 READ FILE 系统特权。

以下示例将显示一个字符串，该字符串用于创建存储 shapefile 数据的表：

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

可使用以下语句将 shapefile 数据装载到表中（条件是您具有 LOAD ANY TABLE 系统特权，并且 -gl 数据库选项未设置为 NONE）：

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

sa_describe_shapefile 系统过程

语法

参数

结果集

注释

特权

另请参见

示例