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.

Nota: Debe tener permisos de visualización para la tabla con nombre, así como permisos de creación/modificación/eliminación para el conjunto de datos asociado de la tabla con nombre a fin de realizar operaciones de inserción, actualización y eliminación en tablas donde se pueda escribir. Consulte Control de acceso para los conjuntos de datos en la sección Administración para obtener más información.
Nota: Se admite la inserción en PostGreSQL/PostGIS, Oracle, SQL Server, SAP HANA, GeoPackage y las tablas JDBC genéricas. También se admite en archivos TAB nativo extendido (NativeX) y TAB nativo MapInfo solo en los sistemas operativos Windows. La tabla debe poseer una clave principal o se considerará solamente como una tabla de solo lectura. Las tablas con nombre asignado con claves principales compuestas no permiten la escritura.

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"
        }
    }]
}