Difference between revisions of "REST API:execSQL Resource"

From LongJump Support Wiki
imported>Aeric
imported>Aeric
Line 1: Line 1:
Use the SQL query language to access Object tables, using the [[REST API]].
Use the SQL query language to access Object tables, using the [[REST API]].
:''Learn more:''
:''Learn more:'' REST API [[REST API#Conventions and Considerations|Conventions and Considerations]].
:* [[SQL Syntax ]]
:* REST API [[REST API#Conventions and Considerations|Conventions and Considerations]].


{{TBD|<br/>
{{TBD|<br/>
Line 16: Line 14:


===Execute a SQL Query===
===Execute a SQL Query===


;Method:GET
;Method:GET
Line 23: Line 20:


{{Query Parameters|
{{Query Parameters|
:*<tt>sql</tt> - The SQL language query to execute.}}
:*<tt>sql</tt> - The [[SQL Syntax|SQL language query]] to execute.}}


;Response:
;Response:

Revision as of 01:41, 16 November 2011

Use the SQL query language to access Object tables, using the REST API.

Learn more: REST API Conventions and Considerations.

__TBD:

  1. Add an entry to the REST API CheatSheet
  2. Add an entry to the REST API (categorized) page
  3. Add an entry to the REST Resources page

__

Permissions

__TBD: Are the permission(s) right?__

Lock-tiny.gif

Users that have the Manage Develop Features permission can use this resource. 

Execute a SQL Query

Method
GET
URI
https://{domain}/networking/rest/execSQL?sql={query}
Query Parameters
For more information, see: Specifying Query Parameters in REST APIs
Response
<platform>
    <execSQL>
        <id>...</id>
        <field>data</field>
         ...
    </execSQL>

    <message>
        <code>0</code>
        <description>Success</description>
    </message>
    <recordCount>N</recordCount>      <!-- Number of __ records returned -->
</platform>

where:

  • The column names are the columns from the queried rows, or their aliases.
See also: REST API:Error Codes