This is an automated email from the ASF dual-hosted git repository.
dzamo pushed a commit to branch gh-pages
in repository https://gitbox.apache.org/repos/asf/drill.git
The following commit(s) were added to refs/heads/gh-pages by this push:
new b3705d0 Update instructions for multlingual in README.md.
b3705d0 is described below
commit b3705d03e5670efabfd85d5334920c8dd35dce90
Author: James Turton <[email protected]>
AuthorDate: Fri Jul 2 15:50:24 2021 +0200
Update instructions for multlingual in README.md.
---
README.md | 2 +
.../rest-api/010-rest-api-introduction.md | 47 +++++++++++++---------
2 files changed, 29 insertions(+), 20 deletions(-)
diff --git a/README.md b/README.md
index b07a79b..5d87b02 100644
--- a/README.md
+++ b/README.md
@@ -135,6 +135,8 @@ Multilingual support was added to the website in June 2021
using the polyglot Je
1. Add the two-letter language code (`lang-code` forthwith) to the `languages`
property in _config.yml.
2. Add a `lang-code/` subdirectory to the root directory.
3. Add a `lang-code/` subdirectory to each collection that will be translated,
e.g. `_docs/lang-code/`.
+4. Check the `exclude_from_localization` list in _config.yml to ensure that
the content you
+want to translate is not excluded from processing by the multlingual plugin.
## Add translated site pages
diff --git
a/_docs/en/developer-information/rest-api/010-rest-api-introduction.md
b/_docs/en/developer-information/rest-api/010-rest-api-introduction.md
index 21aeb41..0bdf56c 100644
--- a/_docs/en/developer-information/rest-api/010-rest-api-introduction.md
+++ b/_docs/en/developer-information/rest-api/010-rest-api-introduction.md
@@ -66,15 +66,19 @@ Submit a query and return results.
* `autoLimit`--Limits the number of rows returned from the result set. (Drill
1.16+)
* `defaultSchema`--Sets the default schema for the query. Equavalent to
executing a `USE <schema>` prior to the query. (Drill 1.18+)
-For Drill 1.19+ Drill switched to a streaming HTTP connection for REST
queries. The result being that
+In Drill 1.19+ Drill switched to a streaming HTTP connection for REST queries
+with the result that query result sets are no longer buffered in their entirety
+in heap memory before being returned to the HTTP requestor.
**Request Body**
- {
- "queryType" : "SQL",
- "query" : "<Drill query>",
- "autoLimit" : "<rows returned>"
- }
+```json
+{
+ "queryType" : "SQL",
+ "query" : "<Drill query>",
+ "autoLimit" : "<rows returned>"
+}
+```
**Example**
@@ -82,22 +86,25 @@ For Drill 1.19+ Drill switched to a streaming HTTP
connection for REST queries.
**Response Body**
- {
- "columns" : [ "id", "type", "name", "ppu", "sales", "batters",
"topping", "filling" ],
- "rows" : [ {
- "id" : "0001",
- "sales" : "35",
- "name" : "Cake",
- "topping" :
"[{\"id\":\"5001\",\"type\":\"None\"},{\"id\":\"5002\",\"type\":\"Glazed\"},{\"id\":\"5005\",\"type\":\"Sugar\"},{\"id\":\"5007\",\"type\":\"Powdered
Sugar\"},{\"id\":\"5006\",\"type\":\"Chocolate with
Sprinkles\"},{\"id\":\"5003\",\"type\":\"Chocolate\"},{\"id\":\"5004\",\"type\":\"Maple\"}]",
- "ppu" : "0.55",
- "type" : "donut",
- "batters" :
"{\"batter\":[{\"id\":\"1001\",\"type\":\"Regular\"},{\"id\":\"1002\",\"type\":\"Chocolate\"},{\"id\":\"1003\",\"type\":\"Blueberry\"},{\"id\":\"1004\",\"type\":\"Devil's
Food\"}]}",
- "filling" : "[]"
- } ]
- }
+```json
+{
+ "columns" : [ "id", "type", "name", "ppu", "sales", "batters", "topping",
"filling" ],
+ "rows" : [ {
+ "id" : "0001",
+ "sales" : "35",
+ "name" : "Cake",
+ "topping" :
"[{\"id\":\"5001\",\"type\":\"None\"},{\"id\":\"5002\",\"type\":\"Glazed\"},{\"id\":\"5005\",\"type\":\"Sugar\"},{\"id\":\"5007\",\"type\":\"Powdered
Sugar\"},{\"id\":\"5006\",\"type\":\"Chocolate with
Sprinkles\"},{\"id\":\"5003\",\"type\":\"Chocolate\"},{\"id\":\"5004\",\"type\":\"Maple\"}]",
+ "ppu" : "0.55",
+ "type" : "donut",
+ "batters" :
"{\"batter\":[{\"id\":\"1001\",\"type\":\"Regular\"},{\"id\":\"1002\",\"type\":\"Chocolate\"},{\"id\":\"1003\",\"type\":\"Blueberry\"},{\"id\":\"1004\",\"type\":\"Devil's
Food\"}]}",
+ "filling" : "[]"
+ } ]
+}
+```
**Error Reporting**
-Drill 1.19 added a streaming REST interface with the goal of reducing the
response times from REST calls. As of Drill 1.19, error reporting is no longer
enabled by default and in the event of a failed query, you will just get
results as shown below:
+
+Drill 1.19 added a streaming REST interface with the goal of reducing the
response times from REST calls. As of Drill 1.19, error reporting is no longer
enabled by default and in the event of a failed query, you will only get
results as shown below.
```json
{