You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@doris.apache.org by mo...@apache.org on 2024/09/03 03:23:02 UTC
(doris-website) branch master updated: [doc][stream-load-manual] Add usage details for importing JSON files to the stream-load-manual documentation (#888)
This is an automated email from the ASF dual-hosted git repository.
morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new 0d3aab1b52 [doc][stream-load-manual] Add usage details for importing JSON files to the stream-load-manual documentation (#888)
0d3aab1b52 is described below
commit 0d3aab1b52a8b35e63a48ddc6b043fd3998568b8
Author: bingquanzhao <bi...@icloud.com>
AuthorDate: Tue Sep 3 11:22:57 2024 +0800
[doc][stream-load-manual] Add usage details for importing JSON files to the stream-load-manual documentation (#888)
Add usage details for importing JSON files to the stream-load-manual
documentation.
Reduce the user’s understanding cost when using stream load to import
JSON files.
---
docs/data-operate/import/import-way/stream-load-manual.md | 4 ++++
.../current/data-operate/import/import-way/stream-load-manual.md | 3 +++
.../version-2.0/data-operate/import/stream-load-manual.md | 3 +++
.../version-2.1/data-operate/import/stream-load-manual.md | 3 +++
.../version-3.0/data-operate/import/stream-load-manual.md | 3 +++
versioned_docs/version-2.0/data-operate/import/stream-load-manual.md | 4 ++++
versioned_docs/version-2.1/data-operate/import/stream-load-manual.md | 4 ++++
versioned_docs/version-3.0/data-operate/import/stream-load-manual.md | 4 ++++
8 files changed, 28 insertions(+)
diff --git a/docs/data-operate/import/import-way/stream-load-manual.md b/docs/data-operate/import/import-way/stream-load-manual.md
index 1f4d640331..9bb6f33549 100644
--- a/docs/data-operate/import/import-way/stream-load-manual.md
+++ b/docs/data-operate/import/import-way/stream-load-manual.md
@@ -210,6 +210,10 @@ curl --location-trusted -u <doris_user>:<doris_password> \
-T streamload_example.json \
-XPUT http://<fe_ip>:<fe_http_port>/api/testdb/test_streamload/_stream_load
```
+:::info Note
+
+If the JSON file is not a JSON array but each line is a JSON object, add the headers `-H "strip_outer_array:false"` and `-H "read_json_by_line:true"`.
+:::
Stream Load is a synchronous method, where the result is directly returned to the user.
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/data-operate/import/import-way/stream-load-manual.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/data-operate/import/import-way/stream-load-manual.md
index df3c36b677..6f5b05da52 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/data-operate/import/import-way/stream-load-manual.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/data-operate/import/import-way/stream-load-manual.md
@@ -213,6 +213,9 @@ Stream Load 需要对目标表的 INSERT 权限。如果没有 INSERT 权限，
-T streamload_example.json \
-XPUT http://<fe_ip>:<fe_http_port>/api/testdb/test_streamload/_stream_load
```
+ :::info 备注
+ 若 JSON 文件内容不是 JSON Array，而是每行一个JSON对象， 添加 Header `-H "strip_outer_array:false"` `-H "read_json_by_line:true"`。
+ :::
Stream Load 是一种同步导入方式，导入结果会直接返回给用户。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/data-operate/import/stream-load-manual.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/data-operate/import/stream-load-manual.md
index 8ab59fbe9b..aab8c5043b 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/data-operate/import/stream-load-manual.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/data-operate/import/stream-load-manual.md
@@ -213,6 +213,9 @@ Stream Load 需要对目标表的 INSERT 权限。如果没有 INSERT 权限，
-T streamload_example.json \
-XPUT http://<fe_ip>:<fe_http_port>/api/testdb/test_streamload/_stream_load
```
+ :::info 备注
+ 若 JSON 文件内容不是 JSON Array，而是每行一个JSON对象， 添加 Header `-H "strip_outer_array:false"` `-H "read_json_by_line:true"`。
+ :::
Stream Load 是一种同步导入方式，导入结果会直接返回给用户。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/data-operate/import/stream-load-manual.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/data-operate/import/stream-load-manual.md
index 853170caae..d1b0769cd2 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/data-operate/import/stream-load-manual.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/data-operate/import/stream-load-manual.md
@@ -213,6 +213,9 @@ Stream Load 需要对目标表的 INSERT 权限。如果没有 INSERT 权限，
-T streamload_example.json \
-XPUT http://<fe_ip>:<fe_http_port>/api/testdb/test_streamload/_stream_load
```
+ :::info 备注
+ 若 JSON 文件内容不是 JSON Array，而是每行一个JSON对象， 添加 Header `-H "strip_outer_array:false"` `-H "read_json_by_line:true"`。
+ :::
Stream Load 是一种同步导入方式，导入结果会直接返回给用户。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/data-operate/import/stream-load-manual.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/data-operate/import/stream-load-manual.md
index e3ec81dfc0..ddbaf00901 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/data-operate/import/stream-load-manual.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/data-operate/import/stream-load-manual.md
@@ -213,6 +213,9 @@ Stream Load 需要对目标表的 INSERT 权限。如果没有 INSERT 权限，
-T streamload_example.json \
-XPUT http://<fe_ip>:<fe_http_port>/api/testdb/test_streamload/_stream_load
```
+ :::info 备注
+ 若 JSON 文件内容不是 JSON Array，而是每行一个JSON对象， 添加 Header `-H "strip_outer_array:false"` `-H "read_json_by_line:true"`。
+ :::
Stream Load 是一种同步导入方式，导入结果会直接返回给用户。
diff --git a/versioned_docs/version-2.0/data-operate/import/stream-load-manual.md b/versioned_docs/version-2.0/data-operate/import/stream-load-manual.md
index 177e7cca74..b0866a0095 100644
--- a/versioned_docs/version-2.0/data-operate/import/stream-load-manual.md
+++ b/versioned_docs/version-2.0/data-operate/import/stream-load-manual.md
@@ -210,6 +210,10 @@ curl --location-trusted -u <doris_user>:<doris_password> \
-T streamload_example.json \
-XPUT http://<fe_ip>:<fe_http_port>/api/testdb/test_streamload/_stream_load
```
+:::info Note
+
+If the JSON file is not a JSON array but each line is a JSON object, add the headers `-H "strip_outer_array:false"` and `-H "read_json_by_line:true"`.
+:::
Stream Load is a synchronous method, where the result is directly returned to the user.
diff --git a/versioned_docs/version-2.1/data-operate/import/stream-load-manual.md b/versioned_docs/version-2.1/data-operate/import/stream-load-manual.md
index ac3eb3eb57..aa3377f0c0 100644
--- a/versioned_docs/version-2.1/data-operate/import/stream-load-manual.md
+++ b/versioned_docs/version-2.1/data-operate/import/stream-load-manual.md
@@ -210,6 +210,10 @@ curl --location-trusted -u <doris_user>:<doris_password> \
-T streamload_example.json \
-XPUT http://<fe_ip>:<fe_http_port>/api/testdb/test_streamload/_stream_load
```
+:::info Note
+
+If the JSON file is not a JSON array but each line is a JSON object, add the headers `-H "strip_outer_array:false"` and `-H "read_json_by_line:true"`.
+:::
Stream Load is a synchronous method, where the result is directly returned to the user.
diff --git a/versioned_docs/version-3.0/data-operate/import/stream-load-manual.md b/versioned_docs/version-3.0/data-operate/import/stream-load-manual.md
index aab97f78aa..e6cfc5f712 100644
--- a/versioned_docs/version-3.0/data-operate/import/stream-load-manual.md
+++ b/versioned_docs/version-3.0/data-operate/import/stream-load-manual.md
@@ -210,6 +210,10 @@ curl --location-trusted -u <doris_user>:<doris_password> \
-T streamload_example.json \
-XPUT http://<fe_ip>:<fe_http_port>/api/testdb/test_streamload/_stream_load
```
+:::info Note
+
+If the JSON file is not a JSON array but each line is a JSON object, add the headers `-H "strip_outer_array:false"` and `-H "read_json_by_line:true"`.
+:::
Stream Load is a synchronous method, where the result is directly returned to the user.
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org
For additional commands, e-mail: commits-help@doris.apache.org