This is an automated email from the ASF dual-hosted git repository.
yiguolei 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 1a7e187a0ba add native file format docs (#3190)
1a7e187a0ba is described below
commit 1a7e187a0ba2e05714c9079ac76513d5c1c7c021
Author: lihangyu <[email protected]>
AuthorDate: Wed Dec 17 19:01:46 2025 +0800
add native file format docs (#3190)
## Versions
- [x] dev
- [ ] 4.x
- [ ] 3.x
- [ ] 2.1
## Languages
- [x] Chinese
- [x] English
## Docs Checklist
- [ ] Checked by AI
- [ ] Test Cases Built
---
docs/data-operate/import/file-format/native.md | 57 +++++++++++++++++++++
.../data-operate/import/file-format/native.md | 58 ++++++++++++++++++++++
2 files changed, 115 insertions(+)
diff --git a/docs/data-operate/import/file-format/native.md
b/docs/data-operate/import/file-format/native.md
new file mode 100644
index 00000000000..1798b94f55c
--- /dev/null
+++ b/docs/data-operate/import/file-format/native.md
@@ -0,0 +1,57 @@
+---
+{
+ "title": "Native",
+ "language": "en"
+}
+---
+
+This document explains how to load Native format data files in Doris.It is
suitable as an ** internal data exchange and backup format **, rather than a
general-purpose file exchange format. When data is circulated only within
Doris, Native should be preferred to achieve the highest efficiency.
+
+## Supported Loading Methods
+
+The following loading methods support Native format data:
+
+- [Stream Load](../import-way/stream-load-manual.md)
+- [Broker Load](../import-way/broker-load-manual.md)
+- [INSERT INTO FROM S3
TVF](../../../sql-manual/sql-functions/table-valued-functions/s3)
+- [INSERT INTO FROM HDFS
TVF](../../../sql-manual/sql-functions/table-valued-functions/hdfs)
+
+## Usage Examples
+
+This section demonstrates the usage of Native format in different loading
methods.
+
+### Stream Load
+
+```shell
+curl --location-trusted -u <user>:<passwd> \
+ -H "format: native" \
+ -T example.native \
+ http://<fe_host>:<fe_http_port>/api/example_db/example_table/_stream_load
+```
+
+### Broker Load
+
+```sql
+LOAD LABEL example_db.example_label
+(
+ DATA INFILE("s3://bucket/example.native")
+ INTO TABLE example_table
+ FORMAT AS "native"
+)
+WITH S3
+(
+ ...
+);
+```
+
+### TVF Load
+
+```sql
+INSERT INTO example_table
+SELECT *
+FROM S3
+(
+ "path" = "s3://bucket/example.native",
+ "format" = "native",
+ ...
+);
\ No newline at end of file
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/data-operate/import/file-format/native.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/data-operate/import/file-format/native.md
new file mode 100644
index 00000000000..1bb5e418161
--- /dev/null
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/data-operate/import/file-format/native.md
@@ -0,0 +1,58 @@
+---
+{
+ "title": "Native",
+ "language": "zh-CN"
+}
+---
+
+本文介绍如何在 Doris 中导入 Native 格式的数据文件。适合作为 **内部数据交换与备份格式**，而非通用文件交换格式；当你只在 Doris
内部流转数据时，应优先考虑 Native，以获得最高效率。
+
+## 支持的导入方式
+
+以下导入方式支持 Native 格式的数据导入：
+
+- [Stream Load](../import-way/stream-load-manual.md)
+- [Broker Load](../import-way/broker-load-manual.md)
+- [INSERT INTO FROM S3
TVF](../../../sql-manual/sql-functions/table-valued-functions/s3)
+- [INSERT INTO FROM HDFS
TVF](../../../sql-manual/sql-functions/table-valued-functions/hdfs)
+
+## 使用示例
+
+本节展示了不同导入方式下的 Native 格式使用方法。
+
+### Stream Load 导入
+
+```shell
+curl --location-trusted -u <user>:<passwd> \
+ -H "format: native" \
+ -T example.native \
+ http://<fe_host>:<fe_http_port>/api/example_db/example_table/_stream_load
+```
+
+### Broker Load 导入
+
+```sql
+LOAD LABEL example_db.example_label
+(
+ DATA INFILE("s3://bucket/example.native")
+ INTO TABLE example_table
+ FORMAT AS "native"
+)
+WITH S3
+(
+ ...
+);
+```
+
+### TVF 导入
+
+```sql
+INSERT INTO example_table
+SELECT *
+FROM S3
+(
+ "uri" = "s3://bucket/example.native",
+ "format" = "native",
+ ...
+);
+```
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
