diff --git a/src/.vuepress/sidebar/V2.0.x/en-Table.ts b/src/.vuepress/sidebar/V2.0.x/en-Table.ts index e55c28288..897877a16 100644 --- a/src/.vuepress/sidebar/V2.0.x/en-Table.ts +++ b/src/.vuepress/sidebar/V2.0.x/en-Table.ts @@ -216,6 +216,7 @@ export const enSidebar = { collapsible: true, prefix: 'SQL-Manual/', children: [ + { text: 'QuickStart Only SQL', link: 'QuickStart-Only-Sql_apache' }, { text: 'Metadata Operations', link: 'SQL-Metadata-Operations_apache' }, { text: 'Data Addition&Deletion', link: 'SQL-Data-Addition-Deletion_apache' }, { diff --git a/src/.vuepress/sidebar/V2.0.x/en-Tree.ts b/src/.vuepress/sidebar/V2.0.x/en-Tree.ts index c968a81ec..97c3dfe57 100644 --- a/src/.vuepress/sidebar/V2.0.x/en-Tree.ts +++ b/src/.vuepress/sidebar/V2.0.x/en-Tree.ts @@ -269,6 +269,7 @@ export const enSidebar = { collapsible: true, prefix: 'SQL-Manual/', children: [ + { text: 'QuickStart Only SQL', link: 'QuickStart-Only-Sql_apache' }, { text: 'Identifiers', link: 'Syntax-Rule' }, { text: 'Keywords', link: 'Keywords' }, { text: 'SQL Manual', link: 'SQL-Manual_apache' }, diff --git a/src/.vuepress/sidebar/V2.0.x/zh-Table.ts b/src/.vuepress/sidebar/V2.0.x/zh-Table.ts index 57ecd67bf..4a736a964 100644 --- a/src/.vuepress/sidebar/V2.0.x/zh-Table.ts +++ b/src/.vuepress/sidebar/V2.0.x/zh-Table.ts @@ -213,6 +213,7 @@ export const zhSidebar = { collapsible: true, prefix: 'SQL-Manual/', children: [ + { text: '快速 SQL 体验', link: 'QuickStart-Only-Sql_apache' }, { text: '元数据操作', link: 'SQL-Metadata-Operations_apache' }, { text: '数据增删', link: 'SQL-Data-Addition-Deletion_apache' }, { diff --git a/src/.vuepress/sidebar/V2.0.x/zh-Tree.ts b/src/.vuepress/sidebar/V2.0.x/zh-Tree.ts index 5e2acafe2..b6b4981c2 100644 --- a/src/.vuepress/sidebar/V2.0.x/zh-Tree.ts +++ b/src/.vuepress/sidebar/V2.0.x/zh-Tree.ts @@ -260,6 +260,7 @@ export const zhSidebar = { collapsible: true, prefix: 'SQL-Manual/', children: [ + { text: '快速 SQL 体验', link: 'QuickStart-Only-Sql_apache' }, { text: '标识符', link: 'Syntax-Rule' }, { text: '关键字', link: 'Keywords' }, { text: 'SQL手册', link: 'SQL-Manual_apache' }, diff --git a/src/.vuepress/sidebar_timecho/V2.0.x/en-Table.ts b/src/.vuepress/sidebar_timecho/V2.0.x/en-Table.ts index 083726d5b..618393941 100644 --- a/src/.vuepress/sidebar_timecho/V2.0.x/en-Table.ts +++ b/src/.vuepress/sidebar_timecho/V2.0.x/en-Table.ts @@ -244,6 +244,7 @@ export const enSidebar = { collapsible: true, prefix: 'SQL-Manual/', children: [ + { text: 'QuickStart Only SQL', link: 'QuickStart-Only-Sql_timecho' }, { text: 'Metadata Operations', link: 'SQL-Metadata-Operations_timecho' }, { text: 'Data Addition&Deletion', link: 'SQL-Data-Addition-Deletion_timecho' }, { diff --git a/src/.vuepress/sidebar_timecho/V2.0.x/en-Tree.ts b/src/.vuepress/sidebar_timecho/V2.0.x/en-Tree.ts index af45bacfb..7ab5afb04 100644 --- a/src/.vuepress/sidebar_timecho/V2.0.x/en-Tree.ts +++ b/src/.vuepress/sidebar_timecho/V2.0.x/en-Tree.ts @@ -297,6 +297,7 @@ export const enSidebar = { collapsible: true, prefix: 'SQL-Manual/', children: [ + { text: 'QuickStart Only SQL', link: 'QuickStart-Only-Sql_timecho' }, { text: 'Identifiers', link: 'Syntax-Rule' }, { text: 'Keywords', link: 'Keywords' }, { text: 'SQL Manual', link: 'SQL-Manual_timecho' }, diff --git a/src/.vuepress/sidebar_timecho/V2.0.x/zh-Table.ts b/src/.vuepress/sidebar_timecho/V2.0.x/zh-Table.ts index 6485ccdd5..ad545e714 100644 --- a/src/.vuepress/sidebar_timecho/V2.0.x/zh-Table.ts +++ b/src/.vuepress/sidebar_timecho/V2.0.x/zh-Table.ts @@ -235,6 +235,7 @@ export const zhSidebar = { collapsible: true, prefix: 'SQL-Manual/', children: [ + { text: '快速 SQL 体验', link: 'QuickStart-Only-Sql_timecho' }, { text: '元数据操作', link: 'SQL-Metadata-Operations_timecho' }, { text: '数据增删', link: 'SQL-Data-Addition-Deletion_timecho' }, { diff --git a/src/.vuepress/sidebar_timecho/V2.0.x/zh-Tree.ts b/src/.vuepress/sidebar_timecho/V2.0.x/zh-Tree.ts index f2ed46887..8efa30325 100644 --- a/src/.vuepress/sidebar_timecho/V2.0.x/zh-Tree.ts +++ b/src/.vuepress/sidebar_timecho/V2.0.x/zh-Tree.ts @@ -279,6 +279,7 @@ export const zhSidebar = { collapsible: true, prefix: 'SQL-Manual/', children: [ + { text: '快速 SQL 体验', link: 'QuickStart-Only-Sql_timecho' }, { text: '标识符', link: 'Syntax-Rule' }, { text: '关键字', link: 'Keywords' }, { text: 'SQL手册', link: 'SQL-Manual_timecho' }, diff --git a/src/UserGuide/Master/Table/SQL-Manual/QuickStart-Only-Sql_apache.md b/src/UserGuide/Master/Table/SQL-Manual/QuickStart-Only-Sql_apache.md new file mode 100644 index 000000000..4ffbe5466 --- /dev/null +++ b/src/UserGuide/Master/Table/SQL-Manual/QuickStart-Only-Sql_apache.md @@ -0,0 +1,126 @@ + +# QuickStart Only SQL + +> **Before executing the following SQL statements, please ensure** +> +> * **IoTDB service has been successfully started** +> * **Connected to IoTDB via Cli client** +> +> Note: If your terminal does not support multi-line pasting (e.g., Windows CMD), please adjust the SQL statements to single-line format before execution. + +## 1. Database Management + +```SQL +-- Create database database1, and set the database TTL time to 1 year; +CREATE DATABASE IF NOT EXISTS database1; + +-- Use database database1; +USE database1; + +-- Modify the database TTL time to 1 week; +ALTER DATABASE database1 SET PROPERTIES TTL=604800000; + +-- Delete database database1; +DROP DATABASE IF EXISTS database1; +``` + +For detailed syntax description, please refer to: [Database Management](../Basic-Concept/Database-Management_apache.md) + +## 2. Table Management + +```SQL +-- Create table table1; +CREATE TABLE table1 ( + time TIMESTAMP TIME, + device_id STRING TAG, + maintenance STRING ATTRIBUTE COMMENT 'maintenance', + temperature FLOAT FIELD COMMENT 'temperature', + status Boolean FIELD COMMENT 'status' +); + +-- View column information of table table1; +DESC table1 DETAILS; + +-- Modify table; +-- Add column to table table1; +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS humidity FLOAT FIELD COMMENT 'humidity'; +-- Set table table1 TTL to 1 week; +ALTER TABLE table1 set properties TTL=604800000; + +-- Delete table table1; +DROP TABLE table1; +``` + +For detailed syntax description, please refer to: [Table Management](../Basic-Concept/Table-Management_apache.md) + +## 3. Data Writing + +```SQL +-- Single row writing; +INSERT INTO table1(device_id, time, temperature) VALUES ('100', '2025-11-26 13:37:00', 90.0); + +-- Multi-row writing; +INSERT INTO table1(device_id, maintenance, time, temperature) VALUES + ('101', '180', '2024-11-26 13:37:00', 88.0), + ('100', '180', '2024-11-26 13:38:00', 85.0), + ('101', '180', '2024-11-27 16:38:00', 80.0); +``` + +For detailed syntax description, please refer to: [Data Writing](../Basic-Concept/Write-Updata-Data_apache.md#_1-data-insertion) + +## 4. Data Query + +```SQL +-- Full table query; +SELECT * FROM table1; + +-- Function query; +SELECT count(*), sum(temperature) FROM table1; + +-- Query data for specified device and time period; +SELECT * +FROM table1 +WHERE time >= 2024-11-26 00:00:00 and time <= 2024-11-27 00:00:00 and device_id='101'; +``` + +For detailed syntax description, please refer to: [Data Query](../Basic-Concept/Query-Data_apache.md) + +## 5. Data Update + +```SQL +-- Update the maintenance attribute value for data where device_id is 100; +UPDATE table1 SET maintenance='45' WHERE device_id='100'; +``` + +For detailed syntax description, please refer to: [Data Update](../Basic-Concept/Write-Updata-Data_apache.md#_2-data-updates) + +## 6. Data Deletion + +```SQL +-- Delete data for specified device and time period; +DELETE FROM table1 WHERE time >= 2024-11-26 23:39:00 and time <= 2024-11-27 20:42:00 AND device_id='101'; + +-- Full table deletion; +DELETE FROM table1; +``` + +For detailed syntax description, please refer to: [Data Deletion](../Basic-Concept/Delete-Data.md) \ No newline at end of file diff --git a/src/UserGuide/Master/Table/SQL-Manual/QuickStart-Only-Sql_timecho.md b/src/UserGuide/Master/Table/SQL-Manual/QuickStart-Only-Sql_timecho.md new file mode 100644 index 000000000..97569de90 --- /dev/null +++ b/src/UserGuide/Master/Table/SQL-Manual/QuickStart-Only-Sql_timecho.md @@ -0,0 +1,126 @@ + +# QuickStart Only SQL + +> **Before executing the following SQL statements, please ensure** +> +> * **IoTDB service has been successfully started** +> * **Connected to IoTDB via Cli client** +> +> Note: If your terminal does not support multi-line pasting (e.g., Windows CMD), please adjust the SQL statements to single-line format before execution. + +## 1. Database Management + +```SQL +-- Create database database1, and set the database TTL time to 1 year; +CREATE DATABASE IF NOT EXISTS database1; + +-- Use database database1; +USE database1; + +-- Modify the database TTL time to 1 week; +ALTER DATABASE database1 SET PROPERTIES TTL=604800000; + +-- Delete database database1; +DROP DATABASE IF EXISTS database1; +``` + +For detailed syntax description, please refer to: [Database Management](../Basic-Concept/Database-Management_timecho.md) + +## 2. Table Management + +```SQL +-- Create table table1; +CREATE TABLE table1 ( + time TIMESTAMP TIME, + device_id STRING TAG, + maintenance STRING ATTRIBUTE COMMENT 'maintenance', + temperature FLOAT FIELD COMMENT 'temperature', + status Boolean FIELD COMMENT 'status' +); + +-- View column information of table table1; +DESC table1 DETAILS; + +-- Modify table; +-- Add column to table table1; +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS humidity FLOAT FIELD COMMENT 'humidity'; +-- Set table table1 TTL to 1 week; +ALTER TABLE table1 set properties TTL=604800000; + +-- Delete table table1; +DROP TABLE table1; +``` + +For detailed syntax description, please refer to: [Table Management](../Basic-Concept/Table-Management_timecho.md) + +## 3. Data Writing + +```SQL +-- Single row writing; +INSERT INTO table1(device_id, time, temperature) VALUES ('100', '2025-11-26 13:37:00', 90.0); + +-- Multi-row writing; +INSERT INTO table1(device_id, maintenance, time, temperature) VALUES + ('101', '180', '2024-11-26 13:37:00', 88.0), + ('100', '180', '2024-11-26 13:38:00', 85.0), + ('101', '180', '2024-11-27 16:38:00', 80.0); +``` + +For detailed syntax description, please refer to: [Data Writing](../Basic-Concept/Write-Updata-Data_timecho.md#_1-data-insertion) + +## 4. Data Query + +```SQL +-- Full table query; +SELECT * FROM table1; + +-- Function query; +SELECT count(*), sum(temperature) FROM table1; + +-- Query data for specified device and time period; +SELECT * +FROM table1 +WHERE time >= 2024-11-26 00:00:00 and time <= 2024-11-27 00:00:00 and device_id='101'; +``` + +For detailed syntax description, please refer to: [Data Query](../Basic-Concept/Query-Data_timecho.md) + +## 5. Data Update + +```SQL +-- Update the maintenance attribute value for data where device_id is 100; +UPDATE table1 SET maintenance='45' WHERE device_id='100'; +``` + +For detailed syntax description, please refer to: [Data Update](../Basic-Concept/Write-Updata-Data_timecho.md#_2-data-updates) + +## 6. Data Deletion + +```SQL +-- Delete data for specified device and time period; +DELETE FROM table1 WHERE time >= 2024-11-26 23:39:00 and time <= 2024-11-27 20:42:00 AND device_id='101'; + +-- Full table deletion; +DELETE FROM table1; +``` + +For detailed syntax description, please refer to: [Data Deletion](../Basic-Concept/Delete-Data.md) \ No newline at end of file diff --git a/src/UserGuide/Master/Tree/SQL-Manual/QuickStart-Only-Sql_apache.md b/src/UserGuide/Master/Tree/SQL-Manual/QuickStart-Only-Sql_apache.md new file mode 100644 index 000000000..6983ea450 --- /dev/null +++ b/src/UserGuide/Master/Tree/SQL-Manual/QuickStart-Only-Sql_apache.md @@ -0,0 +1,111 @@ + + +# QuickStart Only SQL + +> **Before executing the following SQL statements, please ensure** +> +> * **IoTDB service has been successfully started** +> * **Connected to IoTDB via Cli client** +> +> Note: If your terminal does not support multi-line pasting (e.g., Windows CMD), please adjust the SQL statements to single-line format before execution. + +## 1. Database Management + +```SQL +-- Create database; +CREATE DATABASE root.ln; + +-- View database; +SHOW DATABASES root.**; + +-- Delete database; +DELETE DATABASE root.ln; + +-- Count database; +COUNT DATABASES root.**; +``` + +For detailed syntax description, please refer to: [Database Management](../Basic-Concept/Operate-Metadata_apache.md#_1-database-management) + +## 2. Time Series Management + +```SQL +-- Create time series; +CREATE TIMESERIES root.ln.wf01.wt01.status BOOLEAN; +CREATE TIMESERIES root.ln.wf01.wt01.temperature FLOAT; + +-- Create aligned time series; +CREATE ALIGNED TIMESERIES root.ln.wf01.GPS(latitude FLOAT, longitude FLOAT); + +-- Delete time series; +DELETE TIMESERIES root.ln.wf01.wt01.status; + +-- View time series; +SHOW TIMESERIES root.ln.**; + +-- Count time series; +COUNT TIMESERIES root.ln.**; +``` + +For detailed syntax description, please refer to: [Time Series Management](../Basic-Concept/Operate-Metadata_apache.md#_2-timeseries-management) + +## 3. Data Writing + +```SQL +-- Single column writing; +INSERT INTO root.ln.wf01.wt01(timestamp, temperature) VALUES(1, 23.0),(2, 42.6); + +-- Multi-column writing; +INSERT INTO root.ln.wf01.wt01(timestamp, status, temperature) VALUES (3, false, 33.1),(4, true, 24.6); +``` + +For detailed syntax description, please refer to: [Data Writing](../Basic-Concept/Write-Data_apache.md) + +## 4. Data Query + +```SQL +-- Time filter query; +SELECT * from root.ln.** where time > 1; + +-- Value filter query; +SELECT temperature FROM root.ln.wf01.wt01 where temperature > 36.5; + +-- Function query; +SELECT count(temperature) FROM root.ln.wf01.wt01; + +-- Latest point query; +SELECT LAST status FROM root.ln.wf01.wt01; +``` + +For detailed syntax description, please refer to: [Data Query](../Basic-Concept/Query-Data_apache.md) + +## 5. Data Deletion + +```SQL +-- Single column deletion; +DELETE FROM root.ln.wf01.wt01.status WHERE time >= 20; + +-- Multi-column deletion; +DELETE FROM root.ln.wf01.wt01.* where time <= 10; +``` + +For detailed syntax description, please refer to: [Data Deletion](../Basic-Concept/Delete-Data.md) \ No newline at end of file diff --git a/src/UserGuide/Master/Tree/SQL-Manual/QuickStart-Only-Sql_timecho.md b/src/UserGuide/Master/Tree/SQL-Manual/QuickStart-Only-Sql_timecho.md new file mode 100644 index 000000000..a0a58fba3 --- /dev/null +++ b/src/UserGuide/Master/Tree/SQL-Manual/QuickStart-Only-Sql_timecho.md @@ -0,0 +1,111 @@ + + +# QuickStart Only SQL + +> **Before executing the following SQL statements, please ensure** +> +> * **IoTDB service has been successfully started** +> * **Connected to IoTDB via Cli client** +> +> Note: If your terminal does not support multi-line pasting (e.g., Windows CMD), please adjust the SQL statements to single-line format before execution. + +## 1. Database Management + +```SQL +-- Create database; +CREATE DATABASE root.ln; + +-- View database; +SHOW DATABASES root.**; + +-- Delete database; +DELETE DATABASE root.ln; + +-- Count database; +COUNT DATABASES root.**; +``` + +For detailed syntax description, please refer to: [Database Management](../Basic-Concept/Operate-Metadata_timecho.md#_1-database-management) + +## 2. Time Series Management + +```SQL +-- Create time series; +CREATE TIMESERIES root.ln.wf01.wt01.status BOOLEAN; +CREATE TIMESERIES root.ln.wf01.wt01.temperature FLOAT; + +-- Create aligned time series; +CREATE ALIGNED TIMESERIES root.ln.wf01.GPS(latitude FLOAT, longitude FLOAT); + +-- Delete time series; +DELETE TIMESERIES root.ln.wf01.wt01.status; + +-- View time series; +SHOW TIMESERIES root.ln.**; + +-- Count time series; +COUNT TIMESERIES root.ln.**; +``` + +For detailed syntax description, please refer to: [Time Series Management](../Basic-Concept/Operate-Metadata_timecho.md#_2-timeseries-management) + +## 3. Data Writing + +```SQL +-- Single column writing; +INSERT INTO root.ln.wf01.wt01(timestamp, temperature) VALUES(1, 23.0),(2, 42.6); + +-- Multi-column writing; +INSERT INTO root.ln.wf01.wt01(timestamp, status, temperature) VALUES (3, false, 33.1),(4, true, 24.6); +``` + +For detailed syntax description, please refer to: [Data Writing](../Basic-Concept/Write-Data_timecho.md) + +## 4. Data Query + +```SQL +-- Time filter query; +SELECT * from root.ln.** where time > 1; + +-- Value filter query; +SELECT temperature FROM root.ln.wf01.wt01 where temperature > 36.5; + +-- Function query; +SELECT count(temperature) FROM root.ln.wf01.wt01; + +-- Latest point query; +SELECT LAST status FROM root.ln.wf01.wt01; +``` + +For detailed syntax description, please refer to: [Data Query](../Basic-Concept/Query-Data_timecho.md) + +## 5. Data Deletion + +```SQL +-- Single column deletion; +DELETE FROM root.ln.wf01.wt01.status WHERE time >= 20; + +-- Multi-column deletion; +DELETE FROM root.ln.wf01.wt01.* where time <= 10; +``` + +For detailed syntax description, please refer to: [Data Deletion](../Basic-Concept/Delete-Data.md) \ No newline at end of file diff --git a/src/UserGuide/latest-Table/SQL-Manual/QuickStart-Only-Sql_apache.md b/src/UserGuide/latest-Table/SQL-Manual/QuickStart-Only-Sql_apache.md new file mode 100644 index 000000000..4ffbe5466 --- /dev/null +++ b/src/UserGuide/latest-Table/SQL-Manual/QuickStart-Only-Sql_apache.md @@ -0,0 +1,126 @@ + +# QuickStart Only SQL + +> **Before executing the following SQL statements, please ensure** +> +> * **IoTDB service has been successfully started** +> * **Connected to IoTDB via Cli client** +> +> Note: If your terminal does not support multi-line pasting (e.g., Windows CMD), please adjust the SQL statements to single-line format before execution. + +## 1. Database Management + +```SQL +-- Create database database1, and set the database TTL time to 1 year; +CREATE DATABASE IF NOT EXISTS database1; + +-- Use database database1; +USE database1; + +-- Modify the database TTL time to 1 week; +ALTER DATABASE database1 SET PROPERTIES TTL=604800000; + +-- Delete database database1; +DROP DATABASE IF EXISTS database1; +``` + +For detailed syntax description, please refer to: [Database Management](../Basic-Concept/Database-Management_apache.md) + +## 2. Table Management + +```SQL +-- Create table table1; +CREATE TABLE table1 ( + time TIMESTAMP TIME, + device_id STRING TAG, + maintenance STRING ATTRIBUTE COMMENT 'maintenance', + temperature FLOAT FIELD COMMENT 'temperature', + status Boolean FIELD COMMENT 'status' +); + +-- View column information of table table1; +DESC table1 DETAILS; + +-- Modify table; +-- Add column to table table1; +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS humidity FLOAT FIELD COMMENT 'humidity'; +-- Set table table1 TTL to 1 week; +ALTER TABLE table1 set properties TTL=604800000; + +-- Delete table table1; +DROP TABLE table1; +``` + +For detailed syntax description, please refer to: [Table Management](../Basic-Concept/Table-Management_apache.md) + +## 3. Data Writing + +```SQL +-- Single row writing; +INSERT INTO table1(device_id, time, temperature) VALUES ('100', '2025-11-26 13:37:00', 90.0); + +-- Multi-row writing; +INSERT INTO table1(device_id, maintenance, time, temperature) VALUES + ('101', '180', '2024-11-26 13:37:00', 88.0), + ('100', '180', '2024-11-26 13:38:00', 85.0), + ('101', '180', '2024-11-27 16:38:00', 80.0); +``` + +For detailed syntax description, please refer to: [Data Writing](../Basic-Concept/Write-Updata-Data_apache.md#_1-data-insertion) + +## 4. Data Query + +```SQL +-- Full table query; +SELECT * FROM table1; + +-- Function query; +SELECT count(*), sum(temperature) FROM table1; + +-- Query data for specified device and time period; +SELECT * +FROM table1 +WHERE time >= 2024-11-26 00:00:00 and time <= 2024-11-27 00:00:00 and device_id='101'; +``` + +For detailed syntax description, please refer to: [Data Query](../Basic-Concept/Query-Data_apache.md) + +## 5. Data Update + +```SQL +-- Update the maintenance attribute value for data where device_id is 100; +UPDATE table1 SET maintenance='45' WHERE device_id='100'; +``` + +For detailed syntax description, please refer to: [Data Update](../Basic-Concept/Write-Updata-Data_apache.md#_2-data-updates) + +## 6. Data Deletion + +```SQL +-- Delete data for specified device and time period; +DELETE FROM table1 WHERE time >= 2024-11-26 23:39:00 and time <= 2024-11-27 20:42:00 AND device_id='101'; + +-- Full table deletion; +DELETE FROM table1; +``` + +For detailed syntax description, please refer to: [Data Deletion](../Basic-Concept/Delete-Data.md) \ No newline at end of file diff --git a/src/UserGuide/latest-Table/SQL-Manual/QuickStart-Only-Sql_timecho.md b/src/UserGuide/latest-Table/SQL-Manual/QuickStart-Only-Sql_timecho.md new file mode 100644 index 000000000..97569de90 --- /dev/null +++ b/src/UserGuide/latest-Table/SQL-Manual/QuickStart-Only-Sql_timecho.md @@ -0,0 +1,126 @@ + +# QuickStart Only SQL + +> **Before executing the following SQL statements, please ensure** +> +> * **IoTDB service has been successfully started** +> * **Connected to IoTDB via Cli client** +> +> Note: If your terminal does not support multi-line pasting (e.g., Windows CMD), please adjust the SQL statements to single-line format before execution. + +## 1. Database Management + +```SQL +-- Create database database1, and set the database TTL time to 1 year; +CREATE DATABASE IF NOT EXISTS database1; + +-- Use database database1; +USE database1; + +-- Modify the database TTL time to 1 week; +ALTER DATABASE database1 SET PROPERTIES TTL=604800000; + +-- Delete database database1; +DROP DATABASE IF EXISTS database1; +``` + +For detailed syntax description, please refer to: [Database Management](../Basic-Concept/Database-Management_timecho.md) + +## 2. Table Management + +```SQL +-- Create table table1; +CREATE TABLE table1 ( + time TIMESTAMP TIME, + device_id STRING TAG, + maintenance STRING ATTRIBUTE COMMENT 'maintenance', + temperature FLOAT FIELD COMMENT 'temperature', + status Boolean FIELD COMMENT 'status' +); + +-- View column information of table table1; +DESC table1 DETAILS; + +-- Modify table; +-- Add column to table table1; +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS humidity FLOAT FIELD COMMENT 'humidity'; +-- Set table table1 TTL to 1 week; +ALTER TABLE table1 set properties TTL=604800000; + +-- Delete table table1; +DROP TABLE table1; +``` + +For detailed syntax description, please refer to: [Table Management](../Basic-Concept/Table-Management_timecho.md) + +## 3. Data Writing + +```SQL +-- Single row writing; +INSERT INTO table1(device_id, time, temperature) VALUES ('100', '2025-11-26 13:37:00', 90.0); + +-- Multi-row writing; +INSERT INTO table1(device_id, maintenance, time, temperature) VALUES + ('101', '180', '2024-11-26 13:37:00', 88.0), + ('100', '180', '2024-11-26 13:38:00', 85.0), + ('101', '180', '2024-11-27 16:38:00', 80.0); +``` + +For detailed syntax description, please refer to: [Data Writing](../Basic-Concept/Write-Updata-Data_timecho.md#_1-data-insertion) + +## 4. Data Query + +```SQL +-- Full table query; +SELECT * FROM table1; + +-- Function query; +SELECT count(*), sum(temperature) FROM table1; + +-- Query data for specified device and time period; +SELECT * +FROM table1 +WHERE time >= 2024-11-26 00:00:00 and time <= 2024-11-27 00:00:00 and device_id='101'; +``` + +For detailed syntax description, please refer to: [Data Query](../Basic-Concept/Query-Data_timecho.md) + +## 5. Data Update + +```SQL +-- Update the maintenance attribute value for data where device_id is 100; +UPDATE table1 SET maintenance='45' WHERE device_id='100'; +``` + +For detailed syntax description, please refer to: [Data Update](../Basic-Concept/Write-Updata-Data_timecho.md#_2-data-updates) + +## 6. Data Deletion + +```SQL +-- Delete data for specified device and time period; +DELETE FROM table1 WHERE time >= 2024-11-26 23:39:00 and time <= 2024-11-27 20:42:00 AND device_id='101'; + +-- Full table deletion; +DELETE FROM table1; +``` + +For detailed syntax description, please refer to: [Data Deletion](../Basic-Concept/Delete-Data.md) \ No newline at end of file diff --git a/src/UserGuide/latest/SQL-Manual/QuickStart-Only-Sql_apache.md b/src/UserGuide/latest/SQL-Manual/QuickStart-Only-Sql_apache.md new file mode 100644 index 000000000..6983ea450 --- /dev/null +++ b/src/UserGuide/latest/SQL-Manual/QuickStart-Only-Sql_apache.md @@ -0,0 +1,111 @@ + + +# QuickStart Only SQL + +> **Before executing the following SQL statements, please ensure** +> +> * **IoTDB service has been successfully started** +> * **Connected to IoTDB via Cli client** +> +> Note: If your terminal does not support multi-line pasting (e.g., Windows CMD), please adjust the SQL statements to single-line format before execution. + +## 1. Database Management + +```SQL +-- Create database; +CREATE DATABASE root.ln; + +-- View database; +SHOW DATABASES root.**; + +-- Delete database; +DELETE DATABASE root.ln; + +-- Count database; +COUNT DATABASES root.**; +``` + +For detailed syntax description, please refer to: [Database Management](../Basic-Concept/Operate-Metadata_apache.md#_1-database-management) + +## 2. Time Series Management + +```SQL +-- Create time series; +CREATE TIMESERIES root.ln.wf01.wt01.status BOOLEAN; +CREATE TIMESERIES root.ln.wf01.wt01.temperature FLOAT; + +-- Create aligned time series; +CREATE ALIGNED TIMESERIES root.ln.wf01.GPS(latitude FLOAT, longitude FLOAT); + +-- Delete time series; +DELETE TIMESERIES root.ln.wf01.wt01.status; + +-- View time series; +SHOW TIMESERIES root.ln.**; + +-- Count time series; +COUNT TIMESERIES root.ln.**; +``` + +For detailed syntax description, please refer to: [Time Series Management](../Basic-Concept/Operate-Metadata_apache.md#_2-timeseries-management) + +## 3. Data Writing + +```SQL +-- Single column writing; +INSERT INTO root.ln.wf01.wt01(timestamp, temperature) VALUES(1, 23.0),(2, 42.6); + +-- Multi-column writing; +INSERT INTO root.ln.wf01.wt01(timestamp, status, temperature) VALUES (3, false, 33.1),(4, true, 24.6); +``` + +For detailed syntax description, please refer to: [Data Writing](../Basic-Concept/Write-Data_apache.md) + +## 4. Data Query + +```SQL +-- Time filter query; +SELECT * from root.ln.** where time > 1; + +-- Value filter query; +SELECT temperature FROM root.ln.wf01.wt01 where temperature > 36.5; + +-- Function query; +SELECT count(temperature) FROM root.ln.wf01.wt01; + +-- Latest point query; +SELECT LAST status FROM root.ln.wf01.wt01; +``` + +For detailed syntax description, please refer to: [Data Query](../Basic-Concept/Query-Data_apache.md) + +## 5. Data Deletion + +```SQL +-- Single column deletion; +DELETE FROM root.ln.wf01.wt01.status WHERE time >= 20; + +-- Multi-column deletion; +DELETE FROM root.ln.wf01.wt01.* where time <= 10; +``` + +For detailed syntax description, please refer to: [Data Deletion](../Basic-Concept/Delete-Data.md) \ No newline at end of file diff --git a/src/UserGuide/latest/SQL-Manual/QuickStart-Only-Sql_timecho.md b/src/UserGuide/latest/SQL-Manual/QuickStart-Only-Sql_timecho.md new file mode 100644 index 000000000..a0a58fba3 --- /dev/null +++ b/src/UserGuide/latest/SQL-Manual/QuickStart-Only-Sql_timecho.md @@ -0,0 +1,111 @@ + + +# QuickStart Only SQL + +> **Before executing the following SQL statements, please ensure** +> +> * **IoTDB service has been successfully started** +> * **Connected to IoTDB via Cli client** +> +> Note: If your terminal does not support multi-line pasting (e.g., Windows CMD), please adjust the SQL statements to single-line format before execution. + +## 1. Database Management + +```SQL +-- Create database; +CREATE DATABASE root.ln; + +-- View database; +SHOW DATABASES root.**; + +-- Delete database; +DELETE DATABASE root.ln; + +-- Count database; +COUNT DATABASES root.**; +``` + +For detailed syntax description, please refer to: [Database Management](../Basic-Concept/Operate-Metadata_timecho.md#_1-database-management) + +## 2. Time Series Management + +```SQL +-- Create time series; +CREATE TIMESERIES root.ln.wf01.wt01.status BOOLEAN; +CREATE TIMESERIES root.ln.wf01.wt01.temperature FLOAT; + +-- Create aligned time series; +CREATE ALIGNED TIMESERIES root.ln.wf01.GPS(latitude FLOAT, longitude FLOAT); + +-- Delete time series; +DELETE TIMESERIES root.ln.wf01.wt01.status; + +-- View time series; +SHOW TIMESERIES root.ln.**; + +-- Count time series; +COUNT TIMESERIES root.ln.**; +``` + +For detailed syntax description, please refer to: [Time Series Management](../Basic-Concept/Operate-Metadata_timecho.md#_2-timeseries-management) + +## 3. Data Writing + +```SQL +-- Single column writing; +INSERT INTO root.ln.wf01.wt01(timestamp, temperature) VALUES(1, 23.0),(2, 42.6); + +-- Multi-column writing; +INSERT INTO root.ln.wf01.wt01(timestamp, status, temperature) VALUES (3, false, 33.1),(4, true, 24.6); +``` + +For detailed syntax description, please refer to: [Data Writing](../Basic-Concept/Write-Data_timecho.md) + +## 4. Data Query + +```SQL +-- Time filter query; +SELECT * from root.ln.** where time > 1; + +-- Value filter query; +SELECT temperature FROM root.ln.wf01.wt01 where temperature > 36.5; + +-- Function query; +SELECT count(temperature) FROM root.ln.wf01.wt01; + +-- Latest point query; +SELECT LAST status FROM root.ln.wf01.wt01; +``` + +For detailed syntax description, please refer to: [Data Query](../Basic-Concept/Query-Data_timecho.md) + +## 5. Data Deletion + +```SQL +-- Single column deletion; +DELETE FROM root.ln.wf01.wt01.status WHERE time >= 20; + +-- Multi-column deletion; +DELETE FROM root.ln.wf01.wt01.* where time <= 10; +``` + +For detailed syntax description, please refer to: [Data Deletion](../Basic-Concept/Delete-Data.md) \ No newline at end of file diff --git a/src/zh/UserGuide/Master/Table/SQL-Manual/QuickStart-Only-Sql_apache.md b/src/zh/UserGuide/Master/Table/SQL-Manual/QuickStart-Only-Sql_apache.md new file mode 100644 index 000000000..41ce7190a --- /dev/null +++ b/src/zh/UserGuide/Master/Table/SQL-Manual/QuickStart-Only-Sql_apache.md @@ -0,0 +1,127 @@ + + +# 快速 SQL 体验 + +> **在执行以下 SQL 语句前,请确保** +> +> * **已成功启动 IoTDB 服务** +> * **已通过 Cli 客户端连接 IoTDB** +> +> 注意:若您使用的终端不支持多行粘贴(例如 Windows CMD),请将 SQL 语句调整为单行格式后再执行。 + +## 1. 数据库管理 + +```SQL +--创建数据库 database1,并将数据库的 TTL 时间设置为1年; +CREATE DATABASE IF NOT EXISTS database1; + +--使用数据库 database1; +USE database1; + +--修改数据库的 TTL 时间为1周; +ALTER DATABASE database1 SET PROPERTIES TTL=604800000; + +--删除数据库 database1; +DROP DATABASE IF EXISTS database1; +``` + +详细语法说明可参考:[数据库管理](../Basic-Concept/Database-Management_apache.md) + +## 2. 表管理 + +```SQL +--创建表 table1; +CREATE TABLE table1 ( + time TIMESTAMP TIME, + device_id STRING TAG, + maintenance STRING ATTRIBUTE COMMENT 'maintenance', + temperature FLOAT FIELD COMMENT 'temperature', + status Boolean FIELD COMMENT 'status' +); + +-- 查看表 table1 的列信息; +DESC table1 DETAILS; + +-- 修改表; +-- 表 table1 增加列; +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS humidity FLOAT FIELD COMMENT 'humidity'; +-- 表 table1 TTL 设置为1周; +ALTER TABLE table1 set properties TTL=604800000; + +--删除表 table1; +DROP TABLE table1; +``` + +详细语法说明可参考:[表管理](../Basic-Concept/Table-Management_apache.md) + +## 3. 数据写入 + +```SQL +--单行写入; +INSERT INTO table1(device_id, time, temperature) VALUES ('100', '2025-11-26 13:37:00', 90.0); + +--多行写入; +INSERT INTO table1(device_id, maintenance, time, temperature) VALUES + ('101', '180', '2024-11-26 13:37:00', 88.0), + ('100', '180', '2024-11-26 13:38:00', 85.0), + ('101', '180', '2024-11-27 16:38:00', 80.0); +``` + +详细语法说明可参考:[数据写入](../Basic-Concept/Write-Updata-Data_apache.md#_1-数据写入) + +## 4. 数据查询 + +```SQL +--全表查询; +SELECT * FROM table1; + +--函数查询; +SELECT count(*), sum(temperature) FROM table1; + +--查询指定设备及时间段的数据; +SELECT * +FROM table1 +WHERE time >= 2024-11-26 00:00:00 and time <= 2024-11-27 00:00:00 and device_id='101'; +``` + +详细语法说明可参考:[数据查询](../Basic-Concept/Query-Data_apache.md) + +## 5. 数据更新 + +```SQL +-- 更新 device_id 是 100 的数据的属性 maintenance 值; +UPDATE table1 SET maintenance='45' WHERE device_id='100'; +``` + +详细语法说明可参考:[数据更新](../Basic-Concept/Write-Updata-Data_apache.md#_2-数据更新) + +## 6. 数据删除 + +```SQL +-- 删除指定设备及时间段的数据; +DELETE FROM table1 WHERE time >= 2024-11-26 23:39:00 and time <= 2024-11-27 20:42:00 AND device_id='101'; + +-- 全表删除; +DELETE FROM table1; +``` + +详细语法说明可参考:[数据删除](../Basic-Concept/Delete-Data.md) diff --git a/src/zh/UserGuide/Master/Table/SQL-Manual/QuickStart-Only-Sql_timecho.md b/src/zh/UserGuide/Master/Table/SQL-Manual/QuickStart-Only-Sql_timecho.md new file mode 100644 index 000000000..26e1dac30 --- /dev/null +++ b/src/zh/UserGuide/Master/Table/SQL-Manual/QuickStart-Only-Sql_timecho.md @@ -0,0 +1,127 @@ + + +# 快速 SQL 体验 + +> **在执行以下 SQL 语句前,请确保** +> +> * **已成功启动 IoTDB 服务** +> * **已通过 Cli 客户端连接 IoTDB** +> +> 注意:若您使用的终端不支持多行粘贴(例如 Windows CMD),请将 SQL 语句调整为单行格式后再执行。 + +## 1. 数据库管理 + +```SQL +--创建数据库 database1,并将数据库的 TTL 时间设置为1年; +CREATE DATABASE IF NOT EXISTS database1; + +--使用数据库 database1; +USE database1; + +--修改数据库的 TTL 时间为1周; +ALTER DATABASE database1 SET PROPERTIES TTL=604800000; + +--删除数据库 database1; +DROP DATABASE IF EXISTS database1; +``` + +详细语法说明可参考:[数据库管理](../Basic-Concept/Database-Management_timecho.md) + +## 2. 表管理 + +```SQL +--创建表 table1; +CREATE TABLE table1 ( + time TIMESTAMP TIME, + device_id STRING TAG, + maintenance STRING ATTRIBUTE COMMENT 'maintenance', + temperature FLOAT FIELD COMMENT 'temperature', + status Boolean FIELD COMMENT 'status' +); + +-- 查看表 table1 的列信息; +DESC table1 DETAILS; + +-- 修改表; +-- 表 table1 增加列; +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS humidity FLOAT FIELD COMMENT 'humidity'; +-- 表 table1 TTL 设置为1周; +ALTER TABLE table1 set properties TTL=604800000; + +--删除表 table1; +DROP TABLE table1; +``` + +详细语法说明可参考:[表管理](../Basic-Concept/Table-Management_timecho.md) + +## 3. 数据写入 + +```SQL +--单行写入; +INSERT INTO table1(device_id, time, temperature) VALUES ('100', '2025-11-26 13:37:00', 90.0); + +--多行写入; +INSERT INTO table1(device_id, maintenance, time, temperature) VALUES + ('101', '180', '2024-11-26 13:37:00', 88.0), + ('100', '180', '2024-11-26 13:38:00', 85.0), + ('101', '180', '2024-11-27 16:38:00', 80.0); +``` + +详细语法说明可参考:[数据写入](../Basic-Concept/Write-Updata-Data_timecho.md#_1-数据写入) + +## 4. 数据查询 + +```SQL +--全表查询; +SELECT * FROM table1; + +--函数查询; +SELECT count(*), sum(temperature) FROM table1; + +--查询指定设备及时间段的数据; +SELECT * +FROM table1 +WHERE time >= 2024-11-26 00:00:00 and time <= 2024-11-27 00:00:00 and device_id='101'; +``` + +详细语法说明可参考:[数据查询](../Basic-Concept/Query-Data_timecho.md) + +## 5. 数据更新 + +```SQL +-- 更新 device_id 是 100 的数据的属性 maintenance 值; +UPDATE table1 SET maintenance='45' WHERE device_id='100'; +``` + +详细语法说明可参考:[数据更新](../Basic-Concept/Write-Updata-Data_timecho.md#_2-数据更新) + +## 6. 数据删除 + +```SQL +-- 删除指定设备及时间段的数据; +DELETE FROM table1 WHERE time >= 2024-11-26 23:39:00 and time <= 2024-11-27 20:42:00 AND device_id='101'; + +-- 全表删除; +DELETE FROM table1; +``` + +详细语法说明可参考:[数据删除](../Basic-Concept/Delete-Data.md) diff --git a/src/zh/UserGuide/Master/Tree/SQL-Manual/QuickStart-Only-Sql_apache.md b/src/zh/UserGuide/Master/Tree/SQL-Manual/QuickStart-Only-Sql_apache.md new file mode 100644 index 000000000..e135d5860 --- /dev/null +++ b/src/zh/UserGuide/Master/Tree/SQL-Manual/QuickStart-Only-Sql_apache.md @@ -0,0 +1,111 @@ + + +# 快速 SQL 体验 + +> **在执行以下 SQL 语句前,请确保** +> +> * **已成功启动 IoTDB 服务** +> * **已通过 Cli 客户端连接 IoTDB** +> +> 注意:若您使用的终端不支持多行粘贴(例如 Windows CMD),请将 SQL 语句调整为单行格式后再执行。 + +## 1. 数据库管理 + +```SQL +-- 创建数据库; +CREATE DATABASE root.ln; + +-- 查看数据库; +SHOW DATABASES root.**; + +-- 删除数据库; +DELETE DATABASE root.ln; + +-- 统计数据库; +COUNT DATABASES root.**; +``` + +详细语法说明可参考:[数据库管理](../Basic-Concept/Operate-Metadata_apache.md#_1-数据库管理) + +## 2. 时间序列管理 + +```SQL +-- 创建时间序列; +CREATE TIMESERIES root.ln.wf01.wt01.status BOOLEAN; +CREATE TIMESERIES root.ln.wf01.wt01.temperature FLOAT; + +-- 创建对齐时间序列; +CREATE ALIGNED TIMESERIES root.ln.wf01.GPS(latitude FLOAT, longitude FLOAT); + +-- 删除时间序列; +DELETE TIMESERIES root.ln.wf01.wt01.status; + +-- 查看时间序列; +SHOW TIMESERIES root.ln.**; + +-- 统计时间序列; +COUNT TIMESERIES root.ln.**; +``` + +详细语法说明可参考:[时间序列管理](../Basic-Concept/Operate-Metadata_apache.md#_2-时间序列管理) + +## 3. 数据写入 + +```SQL +-- 单列写入; +INSERT INTO root.ln.wf01.wt01(timestamp, temperature) VALUES(1, 23.0),(2, 42.6); + +-- 多列写入; +INSERT INTO root.ln.wf01.wt01(timestamp, status, temperature) VALUES (3, false, 33.1),(4, true, 24.6); +``` + +详细语法说明可参考:[数据写入](../Basic-Concept/Write-Data_apache.md) + +## 4. 数据查询 + +```SQL +-- 时间过滤查询; +SELECT * from root.ln.** where time > 1; + +-- 值过滤查询; +SELECT temperature FROM root.ln.wf01.wt01 where temperature > 36.5; + +-- 函数查询; +SELECT count(temperature) FROM root.ln.wf01.wt01; + +-- 最新点查询; +SELECT LAST status FROM root.ln.wf01.wt01; +``` + +详细语法说明可参考:[数据查询](../Basic-Concept/Query-Data_apache.md) + +## 5. 数据删除 + +```SQL +-- 单列删除; +DELETE FROM root.ln.wf01.wt01.status WHERE time >= 20; + +-- 多列删除; +DELETE FROM root.ln.wf01.wt01.* where time <= 10; +``` + +详细语法说明可参考:[数据删除](../Basic-Concept/Delete-Data.md) diff --git a/src/zh/UserGuide/Master/Tree/SQL-Manual/QuickStart-Only-Sql_timecho.md b/src/zh/UserGuide/Master/Tree/SQL-Manual/QuickStart-Only-Sql_timecho.md new file mode 100644 index 000000000..55f835bb8 --- /dev/null +++ b/src/zh/UserGuide/Master/Tree/SQL-Manual/QuickStart-Only-Sql_timecho.md @@ -0,0 +1,111 @@ + + +# 快速 SQL 体验 + +> **在执行以下 SQL 语句前,请确保** +> +> * **已成功启动 IoTDB 服务** +> * **已通过 Cli 客户端连接 IoTDB** +> +> 注意:若您使用的终端不支持多行粘贴(例如 Windows CMD),请将 SQL 语句调整为单行格式后再执行。 + +## 1. 数据库管理 + +```SQL +-- 创建数据库; +CREATE DATABASE root.ln; + +-- 查看数据库; +SHOW DATABASES root.**; + +-- 删除数据库; +DELETE DATABASE root.ln; + +-- 统计数据库; +COUNT DATABASES root.**; +``` + +详细语法说明可参考:[数据库管理](../Basic-Concept/Operate-Metadata_timecho.md#_1-数据库管理) + +## 2. 时间序列管理 + +```SQL +-- 创建时间序列; +CREATE TIMESERIES root.ln.wf01.wt01.status BOOLEAN; +CREATE TIMESERIES root.ln.wf01.wt01.temperature FLOAT; + +-- 创建对齐时间序列; +CREATE ALIGNED TIMESERIES root.ln.wf01.GPS(latitude FLOAT, longitude FLOAT); + +-- 删除时间序列; +DELETE TIMESERIES root.ln.wf01.wt01.status; + +-- 查看时间序列; +SHOW TIMESERIES root.ln.**; + +-- 统计时间序列; +COUNT TIMESERIES root.ln.**; +``` + +详细语法说明可参考:[时间序列管理](../Basic-Concept/Operate-Metadata_timecho.md#_2-时间序列管理) + +## 3. 数据写入 + +```SQL +-- 单列写入; +INSERT INTO root.ln.wf01.wt01(timestamp, temperature) VALUES(1, 23.0),(2, 42.6); + +-- 多列写入; +INSERT INTO root.ln.wf01.wt01(timestamp, status, temperature) VALUES (3, false, 33.1),(4, true, 24.6); +``` + +详细语法说明可参考:[数据写入](../Basic-Concept/Write-Data_timecho.md) + +## 4. 数据查询 + +```SQL +-- 时间过滤查询; +SELECT * from root.ln.** where time > 1; + +-- 值过滤查询; +SELECT temperature FROM root.ln.wf01.wt01 where temperature > 36.5; + +-- 函数查询; +SELECT count(temperature) FROM root.ln.wf01.wt01; + +-- 最新点查询; +SELECT LAST status FROM root.ln.wf01.wt01; +``` + +详细语法说明可参考:[数据查询](../Basic-Concept/Query-Data_timecho.md) + +## 5. 数据删除 + +```SQL +-- 单列删除; +DELETE FROM root.ln.wf01.wt01.status WHERE time >= 20; + +-- 多列删除; +DELETE FROM root.ln.wf01.wt01.* where time <= 10; +``` + +详细语法说明可参考:[数据删除](../Basic-Concept/Delete-Data.md) diff --git a/src/zh/UserGuide/latest-Table/SQL-Manual/QuickStart-Only-Sql_apache.md b/src/zh/UserGuide/latest-Table/SQL-Manual/QuickStart-Only-Sql_apache.md new file mode 100644 index 000000000..41ce7190a --- /dev/null +++ b/src/zh/UserGuide/latest-Table/SQL-Manual/QuickStart-Only-Sql_apache.md @@ -0,0 +1,127 @@ + + +# 快速 SQL 体验 + +> **在执行以下 SQL 语句前,请确保** +> +> * **已成功启动 IoTDB 服务** +> * **已通过 Cli 客户端连接 IoTDB** +> +> 注意:若您使用的终端不支持多行粘贴(例如 Windows CMD),请将 SQL 语句调整为单行格式后再执行。 + +## 1. 数据库管理 + +```SQL +--创建数据库 database1,并将数据库的 TTL 时间设置为1年; +CREATE DATABASE IF NOT EXISTS database1; + +--使用数据库 database1; +USE database1; + +--修改数据库的 TTL 时间为1周; +ALTER DATABASE database1 SET PROPERTIES TTL=604800000; + +--删除数据库 database1; +DROP DATABASE IF EXISTS database1; +``` + +详细语法说明可参考:[数据库管理](../Basic-Concept/Database-Management_apache.md) + +## 2. 表管理 + +```SQL +--创建表 table1; +CREATE TABLE table1 ( + time TIMESTAMP TIME, + device_id STRING TAG, + maintenance STRING ATTRIBUTE COMMENT 'maintenance', + temperature FLOAT FIELD COMMENT 'temperature', + status Boolean FIELD COMMENT 'status' +); + +-- 查看表 table1 的列信息; +DESC table1 DETAILS; + +-- 修改表; +-- 表 table1 增加列; +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS humidity FLOAT FIELD COMMENT 'humidity'; +-- 表 table1 TTL 设置为1周; +ALTER TABLE table1 set properties TTL=604800000; + +--删除表 table1; +DROP TABLE table1; +``` + +详细语法说明可参考:[表管理](../Basic-Concept/Table-Management_apache.md) + +## 3. 数据写入 + +```SQL +--单行写入; +INSERT INTO table1(device_id, time, temperature) VALUES ('100', '2025-11-26 13:37:00', 90.0); + +--多行写入; +INSERT INTO table1(device_id, maintenance, time, temperature) VALUES + ('101', '180', '2024-11-26 13:37:00', 88.0), + ('100', '180', '2024-11-26 13:38:00', 85.0), + ('101', '180', '2024-11-27 16:38:00', 80.0); +``` + +详细语法说明可参考:[数据写入](../Basic-Concept/Write-Updata-Data_apache.md#_1-数据写入) + +## 4. 数据查询 + +```SQL +--全表查询; +SELECT * FROM table1; + +--函数查询; +SELECT count(*), sum(temperature) FROM table1; + +--查询指定设备及时间段的数据; +SELECT * +FROM table1 +WHERE time >= 2024-11-26 00:00:00 and time <= 2024-11-27 00:00:00 and device_id='101'; +``` + +详细语法说明可参考:[数据查询](../Basic-Concept/Query-Data_apache.md) + +## 5. 数据更新 + +```SQL +-- 更新 device_id 是 100 的数据的属性 maintenance 值; +UPDATE table1 SET maintenance='45' WHERE device_id='100'; +``` + +详细语法说明可参考:[数据更新](../Basic-Concept/Write-Updata-Data_apache.md#_2-数据更新) + +## 6. 数据删除 + +```SQL +-- 删除指定设备及时间段的数据; +DELETE FROM table1 WHERE time >= 2024-11-26 23:39:00 and time <= 2024-11-27 20:42:00 AND device_id='101'; + +-- 全表删除; +DELETE FROM table1; +``` + +详细语法说明可参考:[数据删除](../Basic-Concept/Delete-Data.md) diff --git a/src/zh/UserGuide/latest-Table/SQL-Manual/QuickStart-Only-Sql_timecho.md b/src/zh/UserGuide/latest-Table/SQL-Manual/QuickStart-Only-Sql_timecho.md new file mode 100644 index 000000000..26e1dac30 --- /dev/null +++ b/src/zh/UserGuide/latest-Table/SQL-Manual/QuickStart-Only-Sql_timecho.md @@ -0,0 +1,127 @@ + + +# 快速 SQL 体验 + +> **在执行以下 SQL 语句前,请确保** +> +> * **已成功启动 IoTDB 服务** +> * **已通过 Cli 客户端连接 IoTDB** +> +> 注意:若您使用的终端不支持多行粘贴(例如 Windows CMD),请将 SQL 语句调整为单行格式后再执行。 + +## 1. 数据库管理 + +```SQL +--创建数据库 database1,并将数据库的 TTL 时间设置为1年; +CREATE DATABASE IF NOT EXISTS database1; + +--使用数据库 database1; +USE database1; + +--修改数据库的 TTL 时间为1周; +ALTER DATABASE database1 SET PROPERTIES TTL=604800000; + +--删除数据库 database1; +DROP DATABASE IF EXISTS database1; +``` + +详细语法说明可参考:[数据库管理](../Basic-Concept/Database-Management_timecho.md) + +## 2. 表管理 + +```SQL +--创建表 table1; +CREATE TABLE table1 ( + time TIMESTAMP TIME, + device_id STRING TAG, + maintenance STRING ATTRIBUTE COMMENT 'maintenance', + temperature FLOAT FIELD COMMENT 'temperature', + status Boolean FIELD COMMENT 'status' +); + +-- 查看表 table1 的列信息; +DESC table1 DETAILS; + +-- 修改表; +-- 表 table1 增加列; +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS humidity FLOAT FIELD COMMENT 'humidity'; +-- 表 table1 TTL 设置为1周; +ALTER TABLE table1 set properties TTL=604800000; + +--删除表 table1; +DROP TABLE table1; +``` + +详细语法说明可参考:[表管理](../Basic-Concept/Table-Management_timecho.md) + +## 3. 数据写入 + +```SQL +--单行写入; +INSERT INTO table1(device_id, time, temperature) VALUES ('100', '2025-11-26 13:37:00', 90.0); + +--多行写入; +INSERT INTO table1(device_id, maintenance, time, temperature) VALUES + ('101', '180', '2024-11-26 13:37:00', 88.0), + ('100', '180', '2024-11-26 13:38:00', 85.0), + ('101', '180', '2024-11-27 16:38:00', 80.0); +``` + +详细语法说明可参考:[数据写入](../Basic-Concept/Write-Updata-Data_timecho.md#_1-数据写入) + +## 4. 数据查询 + +```SQL +--全表查询; +SELECT * FROM table1; + +--函数查询; +SELECT count(*), sum(temperature) FROM table1; + +--查询指定设备及时间段的数据; +SELECT * +FROM table1 +WHERE time >= 2024-11-26 00:00:00 and time <= 2024-11-27 00:00:00 and device_id='101'; +``` + +详细语法说明可参考:[数据查询](../Basic-Concept/Query-Data_timecho.md) + +## 5. 数据更新 + +```SQL +-- 更新 device_id 是 100 的数据的属性 maintenance 值; +UPDATE table1 SET maintenance='45' WHERE device_id='100'; +``` + +详细语法说明可参考:[数据更新](../Basic-Concept/Write-Updata-Data_timecho.md#_2-数据更新) + +## 6. 数据删除 + +```SQL +-- 删除指定设备及时间段的数据; +DELETE FROM table1 WHERE time >= 2024-11-26 23:39:00 and time <= 2024-11-27 20:42:00 AND device_id='101'; + +-- 全表删除; +DELETE FROM table1; +``` + +详细语法说明可参考:[数据删除](../Basic-Concept/Delete-Data.md) diff --git a/src/zh/UserGuide/latest/SQL-Manual/QuickStart-Only-Sql_apache.md b/src/zh/UserGuide/latest/SQL-Manual/QuickStart-Only-Sql_apache.md new file mode 100644 index 000000000..e135d5860 --- /dev/null +++ b/src/zh/UserGuide/latest/SQL-Manual/QuickStart-Only-Sql_apache.md @@ -0,0 +1,111 @@ + + +# 快速 SQL 体验 + +> **在执行以下 SQL 语句前,请确保** +> +> * **已成功启动 IoTDB 服务** +> * **已通过 Cli 客户端连接 IoTDB** +> +> 注意:若您使用的终端不支持多行粘贴(例如 Windows CMD),请将 SQL 语句调整为单行格式后再执行。 + +## 1. 数据库管理 + +```SQL +-- 创建数据库; +CREATE DATABASE root.ln; + +-- 查看数据库; +SHOW DATABASES root.**; + +-- 删除数据库; +DELETE DATABASE root.ln; + +-- 统计数据库; +COUNT DATABASES root.**; +``` + +详细语法说明可参考:[数据库管理](../Basic-Concept/Operate-Metadata_apache.md#_1-数据库管理) + +## 2. 时间序列管理 + +```SQL +-- 创建时间序列; +CREATE TIMESERIES root.ln.wf01.wt01.status BOOLEAN; +CREATE TIMESERIES root.ln.wf01.wt01.temperature FLOAT; + +-- 创建对齐时间序列; +CREATE ALIGNED TIMESERIES root.ln.wf01.GPS(latitude FLOAT, longitude FLOAT); + +-- 删除时间序列; +DELETE TIMESERIES root.ln.wf01.wt01.status; + +-- 查看时间序列; +SHOW TIMESERIES root.ln.**; + +-- 统计时间序列; +COUNT TIMESERIES root.ln.**; +``` + +详细语法说明可参考:[时间序列管理](../Basic-Concept/Operate-Metadata_apache.md#_2-时间序列管理) + +## 3. 数据写入 + +```SQL +-- 单列写入; +INSERT INTO root.ln.wf01.wt01(timestamp, temperature) VALUES(1, 23.0),(2, 42.6); + +-- 多列写入; +INSERT INTO root.ln.wf01.wt01(timestamp, status, temperature) VALUES (3, false, 33.1),(4, true, 24.6); +``` + +详细语法说明可参考:[数据写入](../Basic-Concept/Write-Data_apache.md) + +## 4. 数据查询 + +```SQL +-- 时间过滤查询; +SELECT * from root.ln.** where time > 1; + +-- 值过滤查询; +SELECT temperature FROM root.ln.wf01.wt01 where temperature > 36.5; + +-- 函数查询; +SELECT count(temperature) FROM root.ln.wf01.wt01; + +-- 最新点查询; +SELECT LAST status FROM root.ln.wf01.wt01; +``` + +详细语法说明可参考:[数据查询](../Basic-Concept/Query-Data_apache.md) + +## 5. 数据删除 + +```SQL +-- 单列删除; +DELETE FROM root.ln.wf01.wt01.status WHERE time >= 20; + +-- 多列删除; +DELETE FROM root.ln.wf01.wt01.* where time <= 10; +``` + +详细语法说明可参考:[数据删除](../Basic-Concept/Delete-Data.md) diff --git a/src/zh/UserGuide/latest/SQL-Manual/QuickStart-Only-Sql_timecho.md b/src/zh/UserGuide/latest/SQL-Manual/QuickStart-Only-Sql_timecho.md new file mode 100644 index 000000000..55f835bb8 --- /dev/null +++ b/src/zh/UserGuide/latest/SQL-Manual/QuickStart-Only-Sql_timecho.md @@ -0,0 +1,111 @@ + + +# 快速 SQL 体验 + +> **在执行以下 SQL 语句前,请确保** +> +> * **已成功启动 IoTDB 服务** +> * **已通过 Cli 客户端连接 IoTDB** +> +> 注意:若您使用的终端不支持多行粘贴(例如 Windows CMD),请将 SQL 语句调整为单行格式后再执行。 + +## 1. 数据库管理 + +```SQL +-- 创建数据库; +CREATE DATABASE root.ln; + +-- 查看数据库; +SHOW DATABASES root.**; + +-- 删除数据库; +DELETE DATABASE root.ln; + +-- 统计数据库; +COUNT DATABASES root.**; +``` + +详细语法说明可参考:[数据库管理](../Basic-Concept/Operate-Metadata_timecho.md#_1-数据库管理) + +## 2. 时间序列管理 + +```SQL +-- 创建时间序列; +CREATE TIMESERIES root.ln.wf01.wt01.status BOOLEAN; +CREATE TIMESERIES root.ln.wf01.wt01.temperature FLOAT; + +-- 创建对齐时间序列; +CREATE ALIGNED TIMESERIES root.ln.wf01.GPS(latitude FLOAT, longitude FLOAT); + +-- 删除时间序列; +DELETE TIMESERIES root.ln.wf01.wt01.status; + +-- 查看时间序列; +SHOW TIMESERIES root.ln.**; + +-- 统计时间序列; +COUNT TIMESERIES root.ln.**; +``` + +详细语法说明可参考:[时间序列管理](../Basic-Concept/Operate-Metadata_timecho.md#_2-时间序列管理) + +## 3. 数据写入 + +```SQL +-- 单列写入; +INSERT INTO root.ln.wf01.wt01(timestamp, temperature) VALUES(1, 23.0),(2, 42.6); + +-- 多列写入; +INSERT INTO root.ln.wf01.wt01(timestamp, status, temperature) VALUES (3, false, 33.1),(4, true, 24.6); +``` + +详细语法说明可参考:[数据写入](../Basic-Concept/Write-Data_timecho.md) + +## 4. 数据查询 + +```SQL +-- 时间过滤查询; +SELECT * from root.ln.** where time > 1; + +-- 值过滤查询; +SELECT temperature FROM root.ln.wf01.wt01 where temperature > 36.5; + +-- 函数查询; +SELECT count(temperature) FROM root.ln.wf01.wt01; + +-- 最新点查询; +SELECT LAST status FROM root.ln.wf01.wt01; +``` + +详细语法说明可参考:[数据查询](../Basic-Concept/Query-Data_timecho.md) + +## 5. 数据删除 + +```SQL +-- 单列删除; +DELETE FROM root.ln.wf01.wt01.status WHERE time >= 20; + +-- 多列删除; +DELETE FROM root.ln.wf01.wt01.* where time <= 10; +``` + +详细语法说明可参考:[数据删除](../Basic-Concept/Delete-Data.md)