Actualizar las características por clave principal
Descripción
Actualiza las características en una tabla pasando una colección de características con un commitInterval opcional. Cada característica de la colección debe tener un ID (clave principal) que se utiliza para que coincida con la característica de entrada con la característica de la tabla. El cuerpo de la solicitud que contiene la representación JSON de la colección de características, aunque ciertos elementos no requieren especificación. La respuesta contiene el número de características que se actualizaron de manera exitosa.
La representación del cuerpo JSON está en el formato GeoJSON. Para obtener más información sobre GeoJSON, consulte geojson.org/geojson-spec.html.
Flujo de autorización de ACL
Para actualizar características en una tabla con nombre asignado pasando una colección de claves principales con un intervalo de confirmación opcional, será necesario que el usuario (o las funciones a las que pertenezca) ejecute y modifique permisos en la tabla con nombre asignado de la siguiente manera:
- "EJECUTAR" para el tipo de entidad "Location Intelligence.Named Resources"
- "MODIFICAR" para el tipo de entidad "Location Intelligence.Dataset.DML", respectivamente
Formato de dirección URL de HTTP POST
El siguiente formato se utiliza para solicitudes HTTP POST:
HTTP POST: /tables/tablename/features.rep?
POST Data: action=update;[commitInterval=c]
POST BODY: Content-Type:application/json {table update}
La actualización de tabla es un cuerpo json POST (Content-Type: application/json) para la actualización de tabla que contengan uno o varios elementos a actualizar.
Parámetros
Consulte Tipos de datos de URL de solicitud, para obtener información sobre los tipos de parámetros que se indican a continuación.
Parámetro | La operación HTTP DELETE toma el siguiente parámetro de consulta. | Requerido | Descripción |
---|---|---|---|
tablename | Cadena | sí | El nombre de la tabla para el cual está actualizando las características. La tabla se especifica mediante un nombre completo para la tabla con nombre asignado, a partir de la ubicación de la tabla con nombre asignado en el repositorio. El nombre de la tabla con nombre asignado se define entre la parte /tables de la dirección URL y la parte /features.rep de la misma. Por ejemplo, para actualizar funciones en una tabla con nombre asignado ubicada en /Samples/NamedTables/WorldTable en el repositorio, se usaría la siguiente dirección URL:.../FeatureService/tables/Samples/NamedTables /WorldTable/features.json;... |
rep | Cadena | sí | La representación que se va a arrojar. La representación compatible es <parmname>json</parmname>. |
action=update | Cadena | sí | La acción para actualizar las características en la tabla. |
commitInterval=c | Integer | no | La cantidad de actualizaciones que se van a procesar en una transacción. Por ejemplo, si se actualizan 50 funciones en una tabla y la opción commitInterval se define con el valor 20, habrá tres transacciones (20, 20, 10). El valor predeterminado es 50. Se ignora el valor commitInterval para los archivos TAB nativos y NativeX. |
Devolución
Arroja la clave principal de cada característica agregada a la tabla.
Ejemplo
Agrega dos nuevas características a MyTable, que consta de puntos en la columna de geometría, valores de 456 y 123 para Column1 y valores de "cuatro cinco seis" y "uno dos tres" para Column2.
http://www.pbbi.com/rest/Spatial/FeatureService/tables/MyTable/features.json
?action=update&commitInterval=2
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"id": "1",
"geometry": {
"type": "Point",
"coordinates": [
-73,
41
]
},
"properties": {
"Column1": 456,
"Column2": "four five six"
}
},
{
"type": "Feature",
"id": "2",
"geometry": {
"type": "Point",
"coordinates": [
-72,
42
]
},
"properties": {
"Column1": 123,
"Column2": "one two three"
}
}
]
}