Insérer des fonctionnalités à l'aide de SQL

Description

Insert les fonctions dans une table en lançant une requête sur une table à l'aide d'une chaîne de commande MI SQL Insert. Pour obtenir des informations détaillées sur l'utilisation de des fonctions de MapInfo SQL, reportez-vous au Guide de référence linguistique SQL MapInfo.

La représentation JSON du corps des géométries est au format GeoJSON. Pour plus d’informations sur GeoJSON, reportez-vous à geojson.org/geojson-spec.html.

Remarque : Vous devez disposer de droits d’affichage sur la table nommée ainsi que de droits de création/modification/suppression sur le jeu de données associé de la table nommée pour effectuer des opérations d'insertion, de mise à jour et de suppression sur des tables accessibles en écriture. Pour plus d'informations, reportez-vous à Contrôle d’accès pour les jeux de données dans la section Administration.
Remarque : L'insertion est prise en charge dans les tables PostGIS, Oracle, SQL Server, SAP HANA, GeoPackage et JDBC génériques. Elle est également prise en charge dans les fichiers MapInfo native TAB et extended native TAB (NativeX) sous les systèmes d'exploitation Windows uniquement. Les tables nommées avec des clés primaires composites ne sont pas accessibles en écriture.

Flux d'autorisation ACL

Pour insérer des fonctions dans une table nommée en effectuant une requête sur une table à l'aide d'une chaîne de commande MI SQL Insert, l'utilisateur (ou les rôles auxquels il appartient) aura besoin des autorisations Execute et Create sur la table nommée de la façon suivante :

  • « EXECUTE » pour le type d'entité « Location Intelligence.Named Resources » pour l'utilisateur
  • « CREATE » pour le type d'entité « Location Intelligence.Dataset.DML », respectivement

Format d'URL POST HTTP

Les requêtes POST HTTP se présentent au format suivant :


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

{bound parameters} (paramètres de limite) est un corps POST json (type de contenu : application/json) de la mise à jour MI SQL Update contenant un ou plusieurs paramètres à inclure. Les valeurs Null sont prises en charge ; toutefois, un type est tout de même requis.

Remarque : L'élément json de POST est facultatif ; il n'est requis que si la requête SQL utilise des paramètres de limite.

Pour plus d'informations sur les types de paramètres répertoriés ci-dessous, reportez-vous à la section Types de données d'URL de requête.

Paramètre Type Obligatoire Description
rep Chaîne oui Représentation à renvoyer. La représentation prise en charge est json.
Insérer =requête MI SQL Chaîne oui Requête de mise à jour à lancer au format MI SQL.

Résultat

Renvoie le nombre de fonctions correctement supprimées dans une table nommée du référentiel. Pour les fichiers native et NativeX TAB, une réponse SuccessfulInserts est renvoyée à la place, indiquant le nombre de lignes correctement insérées.

Exemples

Insère les fonctions de MyTable à l'aide d'un paramètre de limite :


http://<hostname>:<port>/rest/Spatial/FeatureService/tables/features.json?
insert= INSERT INTO “/WORLDTABLE”(MI_PRINX, COUNTRY, CAPITAL, CONTINENT, OBJ) 
VALUES (257,'Bahrain', 'Manama', 'Asia', @geomParam) 
{
     "parameters": [{
           "name": "geomParam",
           "value": {
                 "type": "Point",
                 "coordinates": [-72, 42],
                 "crs": {
                       "type": "name",
                       "properties": {
                             "name": "epsg:4269"
                       }
                 }
           }
     }]
}