Požadavek sql-query

Obálka pro sadu SQL dotazů.

Na základě znalosti struktury dokumentových tabulek databáze je možné odesílat SQL dotazy do databáze. Jedná se výhradně o příkazy SELECT.

Obálka jednoho nebo více uzlů s SQL SELECT dotazem.

Základní typ(y) uzlu(ů): sql-query;

syntax
<request>
<sql-query>
<select ... {string}</select> *
</sql-query>
</request>

Atributy

Požadavek sql-query neobsahuje žádné atributy.


Potomci


Uzel select

Obsahuje zápis SQL výrazu SELECT pro získání dat z databáze.

Jde o uzel obsahující text TYP HODNOTY: string;

syntax
<select
type="{string}"
setting="{number}"
user="{number}"
>
{string}
</select>

Atributy

type - Typový název - Název bez mezer a diakritiky s možností pomlček a podrtřítek sloužící pro identifikaci položky.(typ: string)

setting - Setting id - Jedinečný celočíselný identifikátor položky.(typ: number)

user - číslo uživatele - User ID pro správnou identifikaci souboru nastavení (statistiky).(typ: number)


Potomci

Uzel select neobsahuje žádné další elementy. Uzel může obsahovat prostý text.


Odpověď

Struktura odpovědi na požadavek sql-query vrácená v obálce response:

syntax
<response>
<sql-query-result>
<result ... /> *
<error ... /> ?
</sql-query-result>
</response>

Atributy

Odpověď sql-query-result neobsahuje žádné atributy.


Potomci


Uzel result

syntax
<result
type="{string}"
>
<row ... /> *
</result>

Atributy

type - Typový název - Název bez mezer a diakritiky s možností pomlček a podrtřítek sloužící pro identifikaci položky.(typ: string)


Potomci

syntax
<row/>

Atributy

Uzel row nabízí možnost uvést libovoný atribut.


Potomci

Uzel row neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty. Uzel nemá povolen prázdný obsah.


Uzel error

Popis uzlu error, který je potomkem uzlu sql-query-result je umístěn v popisu typových uzlů.

Bližší popis viz. error.

Výraz pro identifikaci chyb v odpovědi serveru: sql-query-result[error] (odkaz na popis detailu: error).


Další info

Je pravidlem, že obsah atributu type není v rámci sql-query duplicitní. Každý select je tedy v rámci jednoho požadavku atributem type jednoznačně identifikovatelný. Tato identifikace je pak serverem přenášena i do výsledků požadavků. Atributy user a setting slouží pro identifikaci v rámci statistik - doplnit.

Další informace viz. též příklady dotazů a identifikace chyb.


Požadavek sql-queryPožadavek get-draft-listPožadavek save-draftPožadavek get-draftPožadavek remove-draftPožadavek get-settingsPožadavek save-settings