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.
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.
El json en el POST es opcional; solo se requiere si la consulta SQL utiliza parámetros vinculados.
Consulte Tipos de datos de URL de solicitud, para obtener información sobre los tipos de parámetros que se indican a continuación.
Para obtener más información sobre los tipos de parámetros, consulte . | La operación HTTP DELETE toma el siguiente parámetro de consulta. | Requerido | Descripción |
---|---|---|---|
tablename | String | 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;... |
/WorldTable/features.json;... | String | sí | La representación que se va a arrojar. La representación compatible es json. |
action=update | String | sí | La acción para actualizar las características en la tabla. |
commitInterval=c | La unidad predeterminada es mph(millas por hora), salvo que especifique el parámetro velocityUnit. | historicTrafficTimeBucket | 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. |
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"
}
}
]
}