This is an automated email from the ASF dual-hosted git repository.
sivabalan pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/hudi.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 488438fbb6a [HUDI-7978][DOCS] Add a note on field oldering in
partitioned by clause of create sql (#11610)
488438fbb6a is described below
commit 488438fbb6ae2f8dfcc9257016c66a38c0352171
Author: Sagar Sumit <[email protected]>
AuthorDate: Thu Jul 11 08:38:42 2024 +0530
[HUDI-7978][DOCS] Add a note on field oldering in partitioned by clause of
create sql (#11610)
---
website/docs/sql_ddl.md | 5 ++++-
website/versioned_docs/version-0.11.0/quick-start-guide.md | 7 +++++++
website/versioned_docs/version-0.11.1/quick-start-guide.md | 7 +++++++
website/versioned_docs/version-0.12.0/quick-start-guide.md | 7 +++++++
website/versioned_docs/version-0.12.1/quick-start-guide.md | 7 +++++++
website/versioned_docs/version-0.12.2/quick-start-guide.md | 7 +++++++
website/versioned_docs/version-0.12.3/quick-start-guide.md | 7 +++++++
website/versioned_docs/version-0.13.0/quick-start-guide.md | 7 +++++++
website/versioned_docs/version-0.13.1/quick-start-guide.md | 7 +++++++
website/versioned_docs/version-0.14.0/sql_ddl.md | 5 ++++-
website/versioned_docs/version-0.14.1/sql_ddl.md | 5 ++++-
website/versioned_docs/version-0.15.0/sql_ddl.md | 5 ++++-
12 files changed, 72 insertions(+), 4 deletions(-)
diff --git a/website/docs/sql_ddl.md b/website/docs/sql_ddl.md
index 61e7d33cd7f..a85d8a7bb04 100644
--- a/website/docs/sql_ddl.md
+++ b/website/docs/sql_ddl.md
@@ -67,7 +67,10 @@ PARTITIONED BY (dt);
```
:::note
-You can also create a table partitioned by multiple fields by supplying
comma-separated field names. For, e.g., "partitioned by dt, hh"
+You can also create a table partitioned by multiple fields by supplying
comma-separated field names.
+When creating a table partitioned by multiple fields, ensure that you specify
the columns in the `PARTITIONED BY` clause
+in the same order as they appear in the `CREATE TABLE` schema. For example,
for the above table, the partition fields
+should be specified as `PARTITIONED BY (dt, hh)`.
:::
### Create table with record keys and ordering fields
diff --git a/website/versioned_docs/version-0.11.0/quick-start-guide.md
b/website/versioned_docs/version-0.11.0/quick-start-guide.md
index 9f670871f6a..35336d3f4d4 100644
--- a/website/versioned_docs/version-0.11.0/quick-start-guide.md
+++ b/website/versioned_docs/version-0.11.0/quick-start-guide.md
@@ -298,6 +298,13 @@ partitioned by (dt, hh)
location '/tmp/hudi/hudi_cow_pt_tbl';
```
+:::note
+You can also create a table partitioned by multiple fields by supplying
comma-separated field names.
+When creating a table partitioned by multiple fields, ensure that you specify
the columns in the `PARTITIONED BY` clause
+in the same order as they appear in the `CREATE TABLE` schema. For example,
for the above table, the partition fields
+should be specified as `PARTITIONED BY (dt, hh)`.
+:::
+
**Create Table for an existing Hudi Table**
We can create a table on an existing hudi table(created with spark-shell or
deltastreamer). This is useful to
diff --git a/website/versioned_docs/version-0.11.1/quick-start-guide.md
b/website/versioned_docs/version-0.11.1/quick-start-guide.md
index d45b535ef42..d0c32790d5a 100644
--- a/website/versioned_docs/version-0.11.1/quick-start-guide.md
+++ b/website/versioned_docs/version-0.11.1/quick-start-guide.md
@@ -296,6 +296,13 @@ partitioned by (dt, hh)
location '/tmp/hudi/hudi_cow_pt_tbl';
```
+:::note
+You can also create a table partitioned by multiple fields by supplying
comma-separated field names.
+When creating a table partitioned by multiple fields, ensure that you specify
the columns in the `PARTITIONED BY` clause
+in the same order as they appear in the `CREATE TABLE` schema. For example,
for the above table, the partition fields
+should be specified as `PARTITIONED BY (dt, hh)`.
+:::
+
**Create Table for an existing Hudi Table**
We can create a table on an existing hudi table(created with spark-shell or
deltastreamer). This is useful to
diff --git a/website/versioned_docs/version-0.12.0/quick-start-guide.md
b/website/versioned_docs/version-0.12.0/quick-start-guide.md
index aac9a9bd048..9fc3a0414f5 100644
--- a/website/versioned_docs/version-0.12.0/quick-start-guide.md
+++ b/website/versioned_docs/version-0.12.0/quick-start-guide.md
@@ -322,6 +322,13 @@ partitioned by (dt, hh)
location '/tmp/hudi/hudi_cow_pt_tbl';
```
+:::note
+You can also create a table partitioned by multiple fields by supplying
comma-separated field names.
+When creating a table partitioned by multiple fields, ensure that you specify
the columns in the `PARTITIONED BY` clause
+in the same order as they appear in the `CREATE TABLE` schema. For example,
for the above table, the partition fields
+should be specified as `PARTITIONED BY (dt, hh)`.
+:::
+
**Create Table for an existing Hudi Table**
We can create a table on an existing hudi table(created with spark-shell or
deltastreamer). This is useful to
diff --git a/website/versioned_docs/version-0.12.1/quick-start-guide.md
b/website/versioned_docs/version-0.12.1/quick-start-guide.md
index 96de2bbd62c..2c936ca7d8e 100644
--- a/website/versioned_docs/version-0.12.1/quick-start-guide.md
+++ b/website/versioned_docs/version-0.12.1/quick-start-guide.md
@@ -322,6 +322,13 @@ partitioned by (dt, hh)
location '/tmp/hudi/hudi_cow_pt_tbl';
```
+:::note
+You can also create a table partitioned by multiple fields by supplying
comma-separated field names.
+When creating a table partitioned by multiple fields, ensure that you specify
the columns in the `PARTITIONED BY` clause
+in the same order as they appear in the `CREATE TABLE` schema. For example,
for the above table, the partition fields
+should be specified as `PARTITIONED BY (dt, hh)`.
+:::
+
**Create Table for an existing Hudi Table**
We can create a table on an existing hudi table(created with spark-shell or
deltastreamer). This is useful to
diff --git a/website/versioned_docs/version-0.12.2/quick-start-guide.md
b/website/versioned_docs/version-0.12.2/quick-start-guide.md
index 79b33e7a03a..c7df77171a9 100644
--- a/website/versioned_docs/version-0.12.2/quick-start-guide.md
+++ b/website/versioned_docs/version-0.12.2/quick-start-guide.md
@@ -327,6 +327,13 @@ partitioned by (dt, hh)
location '/tmp/hudi/hudi_cow_pt_tbl';
```
+:::note
+You can also create a table partitioned by multiple fields by supplying
comma-separated field names.
+When creating a table partitioned by multiple fields, ensure that you specify
the columns in the `PARTITIONED BY` clause
+in the same order as they appear in the `CREATE TABLE` schema. For example,
for the above table, the partition fields
+should be specified as `PARTITIONED BY (dt, hh)`.
+:::
+
**Create Table for an existing Hudi Table**
We can create a table on an existing hudi table(created with spark-shell or
deltastreamer). This is useful to
diff --git a/website/versioned_docs/version-0.12.3/quick-start-guide.md
b/website/versioned_docs/version-0.12.3/quick-start-guide.md
index 544705e9a4b..3dfd9737379 100644
--- a/website/versioned_docs/version-0.12.3/quick-start-guide.md
+++ b/website/versioned_docs/version-0.12.3/quick-start-guide.md
@@ -327,6 +327,13 @@ partitioned by (dt, hh)
location '/tmp/hudi/hudi_cow_pt_tbl';
```
+:::note
+You can also create a table partitioned by multiple fields by supplying
comma-separated field names.
+When creating a table partitioned by multiple fields, ensure that you specify
the columns in the `PARTITIONED BY` clause
+in the same order as they appear in the `CREATE TABLE` schema. For example,
for the above table, the partition fields
+should be specified as `PARTITIONED BY (dt, hh)`.
+:::
+
**Create Table for an existing Hudi Table**
We can create a table on an existing hudi table(created with spark-shell or
deltastreamer). This is useful to
diff --git a/website/versioned_docs/version-0.13.0/quick-start-guide.md
b/website/versioned_docs/version-0.13.0/quick-start-guide.md
index 76eb3cdbd13..3d5bc5ad70b 100644
--- a/website/versioned_docs/version-0.13.0/quick-start-guide.md
+++ b/website/versioned_docs/version-0.13.0/quick-start-guide.md
@@ -331,6 +331,13 @@ partitioned by (dt, hh)
location '/tmp/hudi/hudi_cow_pt_tbl';
```
+:::note
+You can also create a table partitioned by multiple fields by supplying
comma-separated field names.
+When creating a table partitioned by multiple fields, ensure that you specify
the columns in the `PARTITIONED BY` clause
+in the same order as they appear in the `CREATE TABLE` schema. For example,
for the above table, the partition fields
+should be specified as `PARTITIONED BY (dt, hh)`.
+:::
+
**Create Table for an existing Hudi Table**
We can create a table on an existing hudi table(created with spark-shell or
deltastreamer). This is useful to
diff --git a/website/versioned_docs/version-0.13.1/quick-start-guide.md
b/website/versioned_docs/version-0.13.1/quick-start-guide.md
index 2f168d00ffe..e2b90e0f8ee 100644
--- a/website/versioned_docs/version-0.13.1/quick-start-guide.md
+++ b/website/versioned_docs/version-0.13.1/quick-start-guide.md
@@ -331,6 +331,13 @@ partitioned by (dt, hh)
location '/tmp/hudi/hudi_cow_pt_tbl';
```
+:::note
+You can also create a table partitioned by multiple fields by supplying
comma-separated field names.
+When creating a table partitioned by multiple fields, ensure that you specify
the columns in the `PARTITIONED BY` clause
+in the same order as they appear in the `CREATE TABLE` schema. For example,
for the above table, the partition fields
+should be specified as `PARTITIONED BY (dt, hh)`.
+:::
+
**Create Table for an existing Hudi Table**
We can create a table on an existing hudi table(created with spark-shell or
deltastreamer). This is useful to
diff --git a/website/versioned_docs/version-0.14.0/sql_ddl.md
b/website/versioned_docs/version-0.14.0/sql_ddl.md
index 2211a5b88c4..98b6f93ab82 100644
--- a/website/versioned_docs/version-0.14.0/sql_ddl.md
+++ b/website/versioned_docs/version-0.14.0/sql_ddl.md
@@ -67,7 +67,10 @@ PARTITIONED BY (dt);
```
:::note
-You can also create a table partitioned by multiple fields by supplying
comma-separated field names. For, e.g., "partitioned by dt, hh"
+You can also create a table partitioned by multiple fields by supplying
comma-separated field names.
+When creating a table partitioned by multiple fields, ensure that you specify
the columns in the `PARTITIONED BY` clause
+in the same order as they appear in the `CREATE TABLE` schema. For example,
for the above table, the partition fields
+should be specified as `PARTITIONED BY (dt, hh)`.
:::
### Create table with record keys and ordering fields
diff --git a/website/versioned_docs/version-0.14.1/sql_ddl.md
b/website/versioned_docs/version-0.14.1/sql_ddl.md
index e1f659f4c88..0c953905fcb 100644
--- a/website/versioned_docs/version-0.14.1/sql_ddl.md
+++ b/website/versioned_docs/version-0.14.1/sql_ddl.md
@@ -67,7 +67,10 @@ PARTITIONED BY (dt);
```
:::note
-You can also create a table partitioned by multiple fields by supplying
comma-separated field names. For, e.g., "partitioned by dt, hh"
+You can also create a table partitioned by multiple fields by supplying
comma-separated field names.
+When creating a table partitioned by multiple fields, ensure that you specify
the columns in the `PARTITIONED BY` clause
+in the same order as they appear in the `CREATE TABLE` schema. For example,
for the above table, the partition fields
+should be specified as `PARTITIONED BY (dt, hh)`.
:::
### Create table with record keys and ordering fields
diff --git a/website/versioned_docs/version-0.15.0/sql_ddl.md
b/website/versioned_docs/version-0.15.0/sql_ddl.md
index 61e7d33cd7f..4651e819cdb 100644
--- a/website/versioned_docs/version-0.15.0/sql_ddl.md
+++ b/website/versioned_docs/version-0.15.0/sql_ddl.md
@@ -67,7 +67,10 @@ PARTITIONED BY (dt);
```
:::note
-You can also create a table partitioned by multiple fields by supplying
comma-separated field names. For, e.g., "partitioned by dt, hh"
+You can also create a table partitioned by multiple fields by supplying
comma-separated field names.
+When creating a table partitioned by multiple fields, ensure that you specify
the columns in the `PARTITIONED BY` clause
+in the same order as they appear in the `CREATE TABLE` schema. For example,
for the above table, the partition fields
+should be specified as `PARTITIONED BY (dt, hh)`.
:::
### Create table with record keys and ordering fields
