Skip to content

Commit 4f076ba

Browse files
author
github-actions
committed
update MD by dispatch event pingcap/docs feature/preview-cloud-lake
1 parent 29b19dd commit 4f076ba

File tree

212 files changed

+979
-440
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

212 files changed

+979
-440
lines changed

markdown-pages/en/tidb/release-8.5/tidb-cloud-lake/guides/aggregating-index.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -124,12 +124,14 @@ EXPLAIN SELECT MIN(a), MAX(c) FROM agg;
124124
## Important Notes
125125

126126
**When to Use Aggregating Indexes:**
127+
127128
- Frequent analytical queries (dashboards, reports)
128129
- Large datasets with repeated aggregations
129130
- Stable query patterns
130131
- Performance-critical applications
131132

132133
**When NOT to Use:**
134+
133135
- Frequently changing data
134136
- One-time analytical queries
135137
- Simple queries on small tables

markdown-pages/en/tidb/release-8.5/tidb-cloud-lake/guides/audit-trail.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ summary: Databend system history tables automatically capture detailed records o
88
Databend system history tables automatically capture detailed records of database activities, providing a complete audit trail for compliance and security monitoring.
99

1010
Allows the auditing of the user:
11+
1112
- **Query execution** - Complete SQL execution audit trail (`query_history`)
1213
- **Data access** - Database object access and modifications (`access_history`)
1314
- **Authentication** - Login attempts and session tracking (`login_history`)
@@ -39,6 +40,7 @@ ORDER BY event_time DESC;
3940
```
4041

4142
Example output:
43+
4244
```
4345
event_time: 2025-06-03 06:07:32.512021
4446
user_name: root1
@@ -61,6 +63,7 @@ ORDER BY query_start DESC;
6163
```
6264

6365
Example for `CREATE TABLE` operation:
66+
6467
```
6568
query_id: c2c1c7be-cee4-4868-a28e-8862b122c365
6669
query_start: 2025-06-12 03:31:19.042128
@@ -95,6 +98,7 @@ ORDER BY query_start_time DESC;
9598
```
9699

97100
Example output:
101+
98102
```
99103
query_id: 4e1f50a9-bce2-45cc-86e4-c7a36b9b8d43
100104
sql_user: root

markdown-pages/en/tidb/release-8.5/tidb-cloud-lake/guides/authenticate-with-aws-iam-role.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ After Databend Cloud support shares the trusted principal information for your o
2626

2727
2. Goto AWS Console:
2828

29-
https://us-east-2.console.aws.amazon.com/iam/home?region=us-east-2#/policies
29+
<https://us-east-2.console.aws.amazon.com/iam/home?region=us-east-2#/policies>
3030

3131
Click `Create policy`, and select `Custom trust policy`, and input the policy document for S3 bucket access:
3232

@@ -52,7 +52,7 @@ After Databend Cloud support shares the trusted principal information for your o
5252

5353
3. Goto AWS Console:
5454

55-
https://us-east-2.console.aws.amazon.com/iam/home?region=us-east-2#/roles
55+
<https://us-east-2.console.aws.amazon.com/iam/home?region=us-east-2#/roles>
5656

5757
Click `Create role`, and select `Custom trust policy` in `Trusted entity type`:
5858

markdown-pages/en/tidb/release-8.5/tidb-cloud-lake/guides/automate-data-loading-with-tasks.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,33 +10,42 @@ Tasks wrap SQL so Databend can run it for you on a schedule or when a condition
1010
![alt text](https://docs-download.pingcap.com/media/images/docs/tidb-cloud-lake/task.png)
1111

1212
- **Name & warehouse** – every task needs a warehouse.
13+
1314
```sql
1415
CREATE TASK ingest_orders
1516
WAREHOUSE = 'etl_wh'
1617
AS SELECT 1;
1718
```
19+
1820
- **Trigger** – fixed interval, CRON, or `AFTER another_task`.
21+
1922
```sql
2023
CREATE TASK mytask
2124
WAREHOUSE = 'default'
2225
SCHEDULE = 2 MINUTE
2326
AS ...;
2427
```
28+
2529
- **Guards** – only run when a predicate is true.
30+
2631
```sql
2732
CREATE TASK mytask
2833
WAREHOUSE = 'default'
2934
WHEN STREAM_STATUS('mystream') = TRUE
3035
AS ...;
3136
```
37+
3238
- **Error handling** – pause after N failures or send notifications.
39+
3340
```sql
3441
CREATE TASK mytask
3542
WAREHOUSE = 'default'
3643
SUSPEND_TASK_AFTER_NUM_FAILURES = 3
3744
AS ...;
3845
```
46+
3947
- **SQL payload** – whatever you place after `AS` is what the task executes.
48+
4049
```sql
4150
CREATE TASK bump_age
4251
WAREHOUSE = 'default'

markdown-pages/en/tidb/release-8.5/tidb-cloud-lake/guides/cluster-key-performance.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,12 +25,14 @@ Large tables without proper organization create significant performance and main
2525
## Benefits of Automatic Clustering
2626

2727
**Ease-of-Maintenance**: Databend eliminates the need for:
28+
2829
- Monitoring the state of clustered tables
2930
- Manually triggering re-clustering operations
3031
- Designating compute resources for clustering
3132
- Scheduling maintenance windows
3233

3334
**How it Works**: After you define a cluster key, Databend automatically:
35+
3436
- Monitors table changes from DML operations
3537
- Evaluates when tables would benefit from re-clustering
3638
- Performs background clustering optimization
@@ -114,6 +116,7 @@ ALTER TABLE your_table RECLUSTER;
114116
## Performance Tuning
115117

116118
### Custom Block Size
119+
117120
Adjust block size for better performance:
118121

119122
```sql
@@ -125,6 +128,7 @@ ALTER TABLE sales SET OPTIONS(
125128
```
126129

127130
### Automatic Re-clustering
131+
128132
- `COPY INTO` and `REPLACE INTO` automatically trigger re-clustering
129133
- Monitor clustering metrics regularly
130134
- Re-cluster when `average_depth` becomes too high
@@ -142,12 +146,14 @@ ALTER TABLE sales SET OPTIONS(
142146
## Important Notes
143147

144148
**When to Use Cluster Keys:**
149+
145150
- Large tables (millions+ rows)
146151
- Slow query performance
147152
- Frequent filter-based queries
148153
- Analytical workloads
149154

150155
**When NOT to Use:**
156+
151157
- Small tables
152158
- Random access patterns
153159
- Frequently changing data

markdown-pages/en/tidb/release-8.5/tidb-cloud-lake/guides/connect-using-bendsql.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -460,7 +460,7 @@ root,%,no_password,YES,account_admin,false
460460
// highlight-next-line
461461
root@localhost:8000/default> !set output_format tsv
462462
root@localhost:8000/default> show users;
463-
root % no_password YES account_admin false
463+
root % no_password YES account_admin false
464464
1 row read in 0.076 sec. Processed 1 row, 113 B (13.16 rows/s, 1.45 KiB/s)
465465
466466
// highlight-next-line

markdown-pages/en/tidb/release-8.5/tidb-cloud-lake/guides/connect-using-java.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -115,6 +115,7 @@ conn.close();
115115
## Configuration Reference
116116

117117
For complete databend-jdbc driver configuration options including:
118+
118119
- Connection string parameters
119120
- SSL/TLS configuration
120121
- Authentication methods

markdown-pages/en/tidb/release-8.5/tidb-cloud-lake/guides/connect-using-python.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@ Choose your preferred approach:
2323
## databend-driver (Recommended)
2424

2525
### Features
26+
2627
-**Native Performance**: Direct connection to Databend
2728
-**Async/Sync Support**: Choose your programming style
2829
-**PEP 249 Compatible**: Standard Python DB API

markdown-pages/en/tidb/release-8.5/tidb-cloud-lake/guides/connect-using-rust.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,7 @@ tokio = { version = "1", features = ["full"] }
3232
## Data Type Mappings
3333

3434
### Basic Types
35+
3536
| Databend | Rust | Notes |
3637
| --------- | --------------------- | ------------------------ |
3738
| BOOLEAN | bool | |
@@ -46,12 +47,14 @@ tokio = { version = "1", features = ["full"] }
4647
| BINARY | `Vec<u8>` | |
4748

4849
### Date/Time Types
50+
4951
| Databend | Rust | Notes |
5052
| --------- | --------------------- | ------------------------ |
5153
| DATE | chrono::NaiveDate | Requires chrono crate |
5254
| TIMESTAMP | chrono::NaiveDateTime | Requires chrono crate |
5355

5456
### Complex Types
57+
5558
| Databend | Rust | Notes |
5659
| ----------- | --------------- | ------------------------ |
5760
| ARRAY[T] | `Vec<T>` | Nested arrays supported |

markdown-pages/en/tidb/release-8.5/tidb-cloud-lake/guides/connect-with-aws-privatelink.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ After Databend Cloud approves the cloud account or project you plan to connect,
4040

4141
5. Goto AWS Console:
4242

43-
https://us-east-2.console.aws.amazon.com/vpcconsole/home?region=us-east-2#Endpoints:
43+
<https://us-east-2.console.aws.amazon.com/vpcconsole/home?region=us-east-2#Endpoints>:
4444

4545
Click `Create endpoint`:
4646

0 commit comments

Comments
 (0)