Inserción de una característica en una tabla
Descripción
Inserta uno o más registros en una 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. Cada una de estas características contiene cero o más valores de columna. Si no se especifica una columna, se insertará un valor nulo en su lugar. Se debe especificar un valor de columna si es parte de la clave principal cuyo valor no se maneja en la base de datos (es decir, a través de una secuencia o restricción de incremento automático). Para determinar la clave principal, examine la definición principal en la respuesta de describeTable. La respuesta contiene las claves principales de las funciones que fueron insertadas correctamente.
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 poder insertar uno o más registros en una tabla con nombre asignado, será necesario que el usuario (o las funciones a las que pertenezca) ejecute y cree permisos en la tabla con nombre asignado de la siguiente manera:
- "EJECUTAR" para el tipo de entidad "Location Intelligence.Named Resources"
- "CREAR" 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=insert&[commitInterval=c]
POST BODY: Content-Type:application/json {table insert}
La inserción de tabla es un cuerpo json POST (Content-Type: application/json) para la inserción de tabla que contiene uno o varios elementos a insertar.
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 característica 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=insert | Cadena | sí | La acción para actualizar las características en la tabla. |
commitInterval=c | Integer | no | La cantidad de inserciones que se van a procesar en una transacción. Por ejemplo, si se insertan 50 características en una tabla, y la opción commitInterval se establece en 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. En el caso de los archivos TAB nativos y NativeX, se obtiene una respuesta de SuccessfulInserts
que indica la cantidad de filas insertadas correctamente.
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=insert&commitInterval=1
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [-73, 41]
},
"properties": {
"Column1": 456,
"Column2": "four five six"
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [-72, 42]
},
"properties": {
"Column1": 123,
"Column2": "one two three"
}
}]
}