ClickHouse/docs/en/formats/xml.rst

75 lines
2.8 KiB
ReStructuredText
Raw Normal View History

2017-04-03 19:49:50 +00:00
XML
CLICKHOUSE-2720: progress on website (#865) * update presentations * CLICKHOUSE-2936: redirect from clickhouse.yandex.ru and clickhouse.yandex.com * update submodule * lost files * CLICKHOUSE-2981: prefer sphinx docs over original reference * CLICKHOUSE-2981: docs styles more similar to main website + add flags to switch language links * update presentations * Less confusing directory structure (docs -> doc/reference/) * Minify sphinx docs too * Website release script: fail fast + pass docker hash on deploy * Do not underline links in docs * shorter * cleanup docker images * tune nginx config * CLICKHOUSE-3043: get rid of habrastorage links * Lost translation * CLICKHOUSE-2936: temporary client-side redirect * behaves weird in test * put redirect back * CLICKHOUSE-3047: copy docs txts to public too * move to proper file * remove old pages to avoid confusion * Remove reference redirect warning for now * Refresh README.md * Yellow buttons in docs * Use svg flags instead of unicode ones in docs * fix test website instance * Put flags to separate files * wrong flag * Copy Yandex.Metrica introduction from main page to docs * Yet another home page structure change, couple new blocks (CLICKHOUSE-3045) * Update Contacts section * CLICKHOUSE-2849: more detailed legal information * CLICKHOUSE-2978 preparation - split by files * More changes in Contacts block * Tune texts on index page * update presentations * One more benchmark * Add usage sections to index page, adapted from slides * Get the roadmap started, based on slides from last ClickHouse Meetup * CLICKHOUSE-2977: some rendering tuning * Get rid of excessive section in the end of getting started * Make headers linkable * CLICKHOUSE-2981: links to editing reference - https://github.com/yandex/ClickHouse/issues/849 * CLICKHOUSE-2981: fix mobile styles in docs * Ban crawling of duplicating docs * Open some external links in new tab * Ban old docs too * Lots of trivial fixes in english docs * Lots of trivial fixes in russian docs * Remove getting started copies in markdown * Add Yandex.Webmaster * Fix some sphinx warnings * More warnings fixed in english docs * More sphinx warnings fixed * Add code-block:: text * More code-block:: text * These headers look not that well * Better switch between documentation languages * merge use_case.rst into ya_metrika_task.rst * Edit the agg_functions.rst texts * Add lost empty lines
2017-06-13 04:15:47 +00:00
---
2017-04-03 19:49:50 +00:00
2017-04-26 18:02:30 +00:00
XML format is supported only for displaying data, not for INSERTS. Example:
2017-04-03 19:49:50 +00:00
.. code-block:: xml
<?xml version='1.0' encoding='UTF-8' ?>
<result>
<meta>
<columns>
<column>
<name>SearchPhrase</name>
<type>String</type>
</column>
<column>
<name>count()</name>
<type>UInt64</type>
</column>
</columns>
</meta>
<data>
<row>
<SearchPhrase></SearchPhrase>
<field>8267016</field>
</row>
<row>
2017-04-26 18:02:30 +00:00
<SearchPhrase>bathroom interior</SearchPhrase>
2017-04-03 19:49:50 +00:00
<field>2166</field>
</row>
<row>
2017-04-26 18:02:30 +00:00
<SearchPhrase>yandex>
2017-04-03 19:49:50 +00:00
<field>1655</field>
</row>
<row>
2017-04-26 18:02:30 +00:00
<SearchPhrase>spring 2014 fashion</SearchPhrase>
2017-04-03 19:49:50 +00:00
<field>1549</field>
</row>
<row>
2017-04-26 18:02:30 +00:00
<SearchPhrase>free-form photo</SearchPhrase>
2017-04-03 19:49:50 +00:00
<field>1480</field>
</row>
<row>
2017-04-26 18:02:30 +00:00
<SearchPhrase>Angelina Jolie</SearchPhrase>
2017-04-03 19:49:50 +00:00
<field>1245</field>
</row>
<row>
2017-04-26 18:02:30 +00:00
<SearchPhrase>omsk</SearchPhrase>
2017-04-03 19:49:50 +00:00
<field>1112</field>
</row>
<row>
2017-04-26 18:02:30 +00:00
<SearchPhrase>photos of dog breeds</SearchPhrase>
2017-04-03 19:49:50 +00:00
<field>1091</field>
</row>
<row>
2017-04-26 18:02:30 +00:00
<SearchPhrase>curtain design</SearchPhrase>
2017-04-03 19:49:50 +00:00
<field>1064</field>
</row>
<row>
2017-04-26 18:02:30 +00:00
<SearchPhrase>baku</SearchPhrase>
2017-04-03 19:49:50 +00:00
<field>1000</field>
</row>
</data>
<rows>10</rows>
<rows_before_limit_at_least>141137</rows_before_limit_at_least>
</result>
2017-04-26 18:02:30 +00:00
If name of a column contains some unacceptable character, field is used as a name. In other aspects XML uses JSON structure.
As in case of JSON, invalid UTF-8 sequences are replaced by replacement character <20> so displayed text will only contain valid UTF-8 sequences.
2017-04-03 19:49:50 +00:00
2017-04-26 18:02:30 +00:00
In string values ``<`` and ``&`` are displayed as ``&lt;`` and ``&amp;``.
2017-04-03 19:49:50 +00:00
2017-04-26 18:02:30 +00:00
Arrays are displayed as ``<array><elem>Hello</elem><elem>World</elem>...</array>``,
and tuples as ``<tuple><elem>Hello</elem><elem>World</elem>...</tuple>``.