Búsqueda de características mediante el uso de consultas SQL

Descripción

Devuelve funciones en una tabla con nombre asignado en el repositorio, a partir de una consulta MapInfo SQL. Consulte la Referencia de idioma SQL de MapInfo para obtener información detallada sobre las funciones MI SQL.

Nota: Todas las funciones de MapInfo SQL son compatibles, salvo las funciones de cuadrícula MI_GridMinValue y MI_GridMaxValue.

En esta operación se devuelve una recopilación de funciones JSON que se pueden traspasar a una solicitud para generar mapa o generar leyenda en Mapping Service.

Flujo de autorización de ACL

Para arrojar metadatos para una sola tabla con nombre asignado en el repository según una consulta MapInfo SQL, será necesario que el usuario (o las funciones a las que pertenezca) ejecute permisos en la tabla con nombre asignado de la siguiente manera:

"EJECUTAR" para el tipo de entidad "Location Intelligence.Named Resources"

Nota: Si la consulta SQL refiere a más de una tabla, entonces los permisos para EJECUTAR serán necesarios en todas las tablas, incluida la consulta. (compruebe con el equipo)

Parámetros

Consulte Tipos de datos de URL de solicitud, para obtener información acerca de los tipos de parámetros que se indican a continuación.

Parámetro	Tipo	Requerido	Descripción
`rep`	Cadena	sí	La representación que se va a arrojar. La representación compatible es json.
q=`consulta MI SQL`	Cadena	sí	La consulta que se va a realizar en formato MI SQL.
page=`pagenumber`	Cadena	no	El número de página que se va a arrojar.
pageLength=`pagelength`	Cadena	no	La cantidad de características arrojadas en cada página. Si se especifica el parámetro página en la solicitud, debe definir pageLength.

Formato de dirección URL de HTTP GET

El siguiente formato se utiliza para solicitudes HTTP GET:


HTTP GET /tables/features.rep;[q=SQL query]
&[page=pagenumber]&[pageLength=pagelength]

Devolución

Devuelve las funciones especificadas en una tabla con nombre asignado en el repositorio.


{
"type":"FeatureCollection","Metadata":[{"type":"Geometry","name":"Obj",
"style":{},"styleColumn":"MI_Style"},{"type":"String","name":"Country"},
{"type":"String","name":"Capital"},{"type":"String","name":"Continent"},
{"type":"Integer","name":"Numeric_code"},{"type":"String","name":"FIPS"},
{"type":"String","name":"ISO_2"},{"type":"String","name":"ISO_3"},
{"type":"Integer","name":"Pop_1994"},{"type":"Decimal","name":"Pop_Grw_Rt",
"fractionalDigits":1,"totalDigits":6},{"type":"Integer","name":"Pop_Male"},
{"type":"Integer","name":"Pop_Fem"},{"type":"Integer","name":"Pop_0_14"},
{"type":"Integer","name":"Pop_15_64"},{"type":"Integer","name":"Pop_65Plus"},
{"type":"Integer","name":"Male_0_14"},{"type":"Integer","name":"Male_15_64"},
{"type":"Integer","name":"Male_65Plus"},{"type":"Integer","name":"Fem_0_14"},
{"type":"Integer","name":"Fem_15_64"},{"type":"Integer","name":"Fem_65Plus"},
{"type":"Integer","name":"Pop_Urban"},{"type":"Integer","name":"Pop_Rural"},
{"type":"Integer","name":"Pop_Urb_Male"},{"type":"Integer","name":"Pop_Urb_Fem"},
{"type":"Integer","name":"Pop_Rur_Male"},{"type":"Integer","name":"Pop_Rur_Fem"},
{"type":"Decimal","name":"Arable_Pct","fractionalDigits":1,"totalDigits":6},
{"type":"Decimal","name":"Literacy","fractionalDigits":1,"totalDigits":4},
{"type":"Decimal","name":"Inflat_Rate","fractionalDigits":1,"totalDigits":4},
{"type":"Decimal","name":"Unempl_Rate","fractionalDigits":1,"totalDigits":4},
{"type":"Decimal","name":"Indust_Growth","fractionalDigits":1,"totalDigits":4},
{"type":"Integer","name":"ColorCode"},{"type":"Style","name":"MI_Style"}]
}

Ejemplo

Arroja las características de los registros donde el país es CANADÁ para la tabla WorldTable ubicada en el directorio /Samples/NamedTables en el repositorio.


http://www.<website>.com/rest/Spatial/FeatureService/tables/features.json?q=SELECT * FROM 
"/Samples/NamedTables/WorldTable" WHERE Country='CANADA'

Formato de dirección URL de HTTP POST

El siguiente formato se utiliza para las solicitudes HTTP POST para la opción Buscar por SQL con el uso de parámetros vinculados:


HTTP POST:  /FeatureService/tables/features.rep?
POST Data: [q=MI SQL query]
POST BODY: Content-Type:application/json {bound parameters}

La opción {parámetros vinculados} es un cuerpo json POST (Content-Type: application/json) para la consulta de búsqueda MI SQL que contiene uno o varios parámetros por incluir. Se admiten valores nulos; sin embargo, aún se requiere un tipo.

Nota: El json en el POST es opcional; solo se requiere si la consulta SQL utiliza parámetros vinculados.

Devolución

Devuelve las funciones especificadas en una tabla con nombre asignado en el repositorio.

Ejemplos

Búsqueda de funciones mediante el uso de parámetros vinculados:


SELECT WORLD.Capital FROM "/WORLD" as WORLD WHERE MI_CONTAINS(Obj, @geomParam)
{
     "parameters": [{
           "name": "geomParam",
           "value": {
                 "type": "Point",
                 "coordinates": [-72, 42],
                 "crs": {
                       "type": "name",
                       "properties": {
                             "name": "epsg:4326"
                       }
                 }
                             }
             }]
}