diff --git a/src/UserGuide/Master/Table/Basic-Concept/Database-Management_apache.md b/src/UserGuide/Master/Table/Basic-Concept/Database-Management_apache.md index d4414a17e..bfcb44b69 100644 --- a/src/UserGuide/Master/Table/Basic-Concept/Database-Management_apache.md +++ b/src/UserGuide/Master/Table/Basic-Concept/Database-Management_apache.md @@ -96,13 +96,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -132,19 +132,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 Update a Database diff --git a/src/UserGuide/Master/Table/Basic-Concept/Database-Management_timecho.md b/src/UserGuide/Master/Table/Basic-Concept/Database-Management_timecho.md index d24e95e28..49b16dd01 100644 --- a/src/UserGuide/Master/Table/Basic-Concept/Database-Management_timecho.md +++ b/src/UserGuide/Master/Table/Basic-Concept/Database-Management_timecho.md @@ -96,13 +96,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -132,19 +132,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 Update a Database diff --git a/src/UserGuide/Master/Table/Basic-Concept/Table-Management_apache.md b/src/UserGuide/Master/Table/Basic-Concept/Table-Management_apache.md index 9cc3cf18a..820279d38 100644 --- a/src/UserGuide/Master/Table/Basic-Concept/Table-Management_apache.md +++ b/src/UserGuide/Master/Table/Basic-Concept/Table-Management_apache.md @@ -95,7 +95,7 @@ CREATE TABLE table1 ( ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE if not exists table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( "Site" STRING TAG, @@ -103,6 +103,8 @@ CREATE TABLE tableC ( ) with (TTL=DEFAULT); ``` +Note: If your terminal does not support multi-line paste (e.g., Windows CMD), please reformat the SQL statement into a single line before execution. + #### 1.1.2 Automatically Create Tables via SESSION Tables can be created automatically when inserting data via session. @@ -201,21 +203,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **Examples:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 1.3 View Table Columns @@ -238,26 +238,37 @@ Used to view column names, data types, categories, and states of a table. **Examples:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 1.4 Update Tables @@ -284,9 +295,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **Example:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -304,6 +315,6 @@ DROP TABLE (IF EXISTS)? **Examples:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ``` \ No newline at end of file diff --git a/src/UserGuide/Master/Table/Basic-Concept/Table-Management_timecho.md b/src/UserGuide/Master/Table/Basic-Concept/Table-Management_timecho.md index b169d83de..19d3a5e01 100644 --- a/src/UserGuide/Master/Table/Basic-Concept/Table-Management_timecho.md +++ b/src/UserGuide/Master/Table/Basic-Concept/Table-Management_timecho.md @@ -95,7 +95,7 @@ CREATE TABLE table1 ( ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE if not exists table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( "Site" STRING TAG, @@ -103,6 +103,8 @@ CREATE TABLE tableC ( ) with (TTL=DEFAULT); ``` +Note: If your terminal does not support multi-line paste (e.g., Windows CMD), please reformat the SQL statement into a single line before execution. + #### 1.1.2 Automatically Create Tables via SESSION Tables can be created automatically when inserting data via session. @@ -201,21 +203,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **Examples:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 1.3 View Table Columns @@ -238,26 +238,37 @@ Used to view column names, data types, categories, and states of a table. **Examples:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 1.4 Update Tables @@ -284,9 +295,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **Example:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -304,6 +315,6 @@ DROP TABLE (IF EXISTS)? **Examples:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ``` \ No newline at end of file diff --git a/src/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_apache.md b/src/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_apache.md index af0f1cf90..8598de7ff 100644 --- a/src/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_apache.md +++ b/src/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_apache.md @@ -131,10 +131,9 @@ It is possible to insert data for specific columns. Columns not specified will r **Example:** ```SQL -insert into table1("region", "plant_id", "device_id", Time, "temperature", "displacement") values ('Hamburg', '3001', '3', 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) - -insert into table1("region", "plant_id", "device_id", Time, "temperature") values ('Hamburg, '3001', '3', 5, 90.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` ### 1.4 Null Value Insertion @@ -147,9 +146,9 @@ Equivalent to the above partial column insertion. ```SQL # Equivalent to the example above -insert into table1("region", "plant_id", "device_id", "model", "maintenance_cycle", Time, "temperature", "displacement") values ('Hamburg', '3001', '3', null, null, 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("region", "plant_id", "device_id", "model", "maintenance_cycle", Time, "temperature", "displacement") values ('Hamburg', '3001', '3', null, null, 5, 90.0, null) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` If no tag columns are included, the system will automatically create a device with all tag column values set to `null`. @@ -163,17 +162,16 @@ IoTDB supports inserting multiple rows of data in a single statement to improve **Example**: ```SQL -insert into table1 -values -(4, 'Frankfurt', '3001', '3', '1', '10', 90.0, 1200.0) -(5, 'Frankfurt', '3001', '3', '1', '10', 90.0, 1200.0) - - -insert into table1 -("region", "plant_id", "device_id", Time, "temperature", "displacement") -values -('Frankfurt', '3001', '3', 4, 90.0, 1200.0) -('Frankfurt', '3001', '3', 5, 90.0, 1200.0) +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') + +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) +VALUES +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` #### Notes diff --git a/src/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_timecho.md b/src/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_timecho.md index e1c03bd46..7d12c6bd7 100644 --- a/src/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_timecho.md +++ b/src/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_timecho.md @@ -131,10 +131,9 @@ It is possible to insert data for specific columns. Columns not specified will r **Example:** ```SQL -insert into table1("region", "plant_id", "device_id", Time, "temperature", "displacement") values ('Hamburg', '3001', '3', 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) - -insert into table1("region", "plant_id", "device_id", Time, "temperature") values ('Hamburg, '3001', '3', 5, 90.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` ### 1.4 Null Value Insertion @@ -147,9 +146,9 @@ Equivalent to the above partial column insertion. ```SQL # Equivalent to the example above -insert into table1("region", "plant_id", "device_id", "model", "maintenance_cycle", Time, "temperature", "displacement") values ('Hamburg', '3001', '3', null, null, 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("region", "plant_id", "device_id", "model", "maintenance_cycle", Time, "temperature", "displacement") values ('Hamburg', '3001', '3', null, null, 5, 90.0, null) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` If no tag columns are included, the system will automatically create a device with all tag column values set to `null`. @@ -163,17 +162,16 @@ IoTDB supports inserting multiple rows of data in a single statement to improve **Example**: ```SQL -insert into table1 -values -(4, 'Frankfurt', '3001', '3', '1', '10', 90.0, 1200.0) -(5, 'Frankfurt', '3001', '3', '1', '10', 90.0, 1200.0) - - -insert into table1 -("region", "plant_id", "device_id", Time, "temperature", "displacement") -values -('Frankfurt', '3001', '3', 4, 90.0, 1200.0) -('Frankfurt', '3001', '3', 5, 90.0, 1200.0) +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') + +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) +VALUES +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` #### Notes diff --git a/src/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md b/src/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md index 54046c3c0..6e7de7623 100644 --- a/src/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md +++ b/src/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md @@ -34,35 +34,33 @@ INSERT INTO [(COLUMN_NAME[, COLUMN_NAME]*)]? VALUES (COLUMN_VALUE[, **Example 1: Specified Columns Insertion** ```SQL -INSERT INTO table1("Region", "PlantID", "DeviceID", Time, "Temperature", "Displacement") -VALUES ('Hunan', '3001', '3', 4, 90.0, 1200.0); +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) -INSERT INTO table1("Region", "PlantID", "DeviceID", Time, "Temperature") -VALUES ('Hunan', '3001', '3', 5, 90.0); +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` **Example 2: NULL Value Insertion** ```SQL --- Equivalent to partial insertion with NULL values -INSERT INTO table1("Region", "PlantID", "DeviceID", "Model", "MaintenanceCycle", Time, "Temperature", "Displacement") -VALUES ('Hunan', '3001', '3', NULL, NULL, 4, 90.0, 1200.0); +# Equivalent to the example above +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -INSERT INTO table1("Region", "PlantID", "DeviceID", "Model", "MaintenanceCycle", Time, "Temperature", "Displacement") -VALUES ('Hunan', '3001', '3', NULL, NULL, 5, 90.0, NULL); +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` **Example 3: Multi-row Insertion** ```SQL -INSERT INTO table1 VALUES -(4, 'Beijing', '3001', '3', '1', '10', 90.0, 1200.0), -(5, 'Beijing', '3001', '3', '1', '10', 90.0, 1200.0); +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') -INSERT INTO table1("Region", "PlantID", "DeviceID", Time, "Temperature", "Displacement") +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) VALUES -('Beijing', '3001', '3', 4, 90.0, 1200.0), -('Beijing', '3001', '3', 5, 90.0, 1200.0); +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` **Example 4: Query Write-back** diff --git a/src/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md b/src/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md index 26edcaba3..74163386d 100644 --- a/src/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md +++ b/src/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md @@ -34,35 +34,33 @@ INSERT INTO [(COLUMN_NAME[, COLUMN_NAME]*)]? VALUES (COLUMN_VALUE[, **Example 1: Specified Columns Insertion** ```SQL -INSERT INTO table1("Region", "PlantID", "DeviceID", Time, "Temperature", "Displacement") -VALUES ('Hunan', '3001', '3', 4, 90.0, 1200.0); +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) -INSERT INTO table1("Region", "PlantID", "DeviceID", Time, "Temperature") -VALUES ('Hunan', '3001', '3', 5, 90.0); +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` **Example 2: NULL Value Insertion** ```SQL --- Equivalent to partial insertion with NULL values -INSERT INTO table1("Region", "PlantID", "DeviceID", "Model", "MaintenanceCycle", Time, "Temperature", "Displacement") -VALUES ('Hunan', '3001', '3', NULL, NULL, 4, 90.0, 1200.0); +# Equivalent to the example above +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -INSERT INTO table1("Region", "PlantID", "DeviceID", "Model", "MaintenanceCycle", Time, "Temperature", "Displacement") -VALUES ('Hunan', '3001', '3', NULL, NULL, 5, 90.0, NULL); +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` **Example 3: Multi-row Insertion** ```SQL -INSERT INTO table1 VALUES -(4, 'Beijing', '3001', '3', '1', '10', 90.0, 1200.0), -(5, 'Beijing', '3001', '3', '1', '10', 90.0, 1200.0); +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') -INSERT INTO table1("Region", "PlantID", "DeviceID", Time, "Temperature", "Displacement") +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) VALUES -('Beijing', '3001', '3', 4, 90.0, 1200.0), -('Beijing', '3001', '3', 5, 90.0, 1200.0); +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` **Example 4: Query Write-back** diff --git a/src/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_apache.md b/src/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_apache.md index 625e2ed75..a96828c88 100644 --- a/src/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_apache.md +++ b/src/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_apache.md @@ -75,13 +75,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -99,19 +99,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 Modify Database @@ -195,14 +196,17 @@ CREATE TABLE table1 ( arrival_time TIMESTAMP FIELD COMMENT 'arrival_time' ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE IF NOT EXISTS table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( - "plant" STRING TAG, - "temperature" INT32 FIELD COMMENT 'temperature' -) WITH (TTL=DEFAULT); + "Site" STRING TAG, + "Temperature" int32 FIELD COMMENT 'temperature' + ) with (TTL=DEFAULT); ``` +Note: If your terminal does not support multi-line paste (e.g., Windows CMD), please reformat the SQL statement into a single line before execution. + + ### 2.2 List Tables **Syntax:** @@ -214,21 +218,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **Examples:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 2.3 Describe Table Columns @@ -242,26 +244,37 @@ IoTDB> show tables details from test_db **Examples:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 2.4 Modify Table @@ -280,8 +293,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **Examples:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -297,8 +311,8 @@ DROP TABLE (IF EXISTS)? **Examples:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ``` diff --git a/src/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_timecho.md b/src/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_timecho.md index d3f8967d9..7c94bf290 100644 --- a/src/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_timecho.md +++ b/src/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_timecho.md @@ -75,13 +75,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -99,19 +99,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 Modify Database @@ -195,14 +196,17 @@ CREATE TABLE table1 ( arrival_time TIMESTAMP FIELD COMMENT 'arrival_time' ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE IF NOT EXISTS table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( - "plant" STRING TAG, - "temperature" INT32 FIELD COMMENT 'temperature' -) WITH (TTL=DEFAULT); + "Site" STRING TAG, + "Temperature" int32 FIELD COMMENT 'temperature' + ) with (TTL=DEFAULT); ``` +Note: If your terminal does not support multi-line paste (e.g., Windows CMD), please reformat the SQL statement into a single line before execution. + + ### 2.2 List Tables **Syntax:** @@ -214,21 +218,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **Examples:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 2.3 Describe Table Columns @@ -242,26 +244,37 @@ IoTDB> show tables details from test_db **Examples:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 2.4 Modify Table @@ -280,8 +293,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **Examples:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -297,8 +311,8 @@ DROP TABLE (IF EXISTS)? **Examples:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ``` diff --git a/src/UserGuide/latest-Table/Basic-Concept/Database-Management_apache.md b/src/UserGuide/latest-Table/Basic-Concept/Database-Management_apache.md index d4414a17e..bfcb44b69 100644 --- a/src/UserGuide/latest-Table/Basic-Concept/Database-Management_apache.md +++ b/src/UserGuide/latest-Table/Basic-Concept/Database-Management_apache.md @@ -96,13 +96,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -132,19 +132,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 Update a Database diff --git a/src/UserGuide/latest-Table/Basic-Concept/Database-Management_timecho.md b/src/UserGuide/latest-Table/Basic-Concept/Database-Management_timecho.md index d24e95e28..49b16dd01 100644 --- a/src/UserGuide/latest-Table/Basic-Concept/Database-Management_timecho.md +++ b/src/UserGuide/latest-Table/Basic-Concept/Database-Management_timecho.md @@ -96,13 +96,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -132,19 +132,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 Update a Database diff --git a/src/UserGuide/latest-Table/Basic-Concept/Table-Management_apache.md b/src/UserGuide/latest-Table/Basic-Concept/Table-Management_apache.md index 9cc3cf18a..820279d38 100644 --- a/src/UserGuide/latest-Table/Basic-Concept/Table-Management_apache.md +++ b/src/UserGuide/latest-Table/Basic-Concept/Table-Management_apache.md @@ -95,7 +95,7 @@ CREATE TABLE table1 ( ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE if not exists table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( "Site" STRING TAG, @@ -103,6 +103,8 @@ CREATE TABLE tableC ( ) with (TTL=DEFAULT); ``` +Note: If your terminal does not support multi-line paste (e.g., Windows CMD), please reformat the SQL statement into a single line before execution. + #### 1.1.2 Automatically Create Tables via SESSION Tables can be created automatically when inserting data via session. @@ -201,21 +203,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **Examples:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 1.3 View Table Columns @@ -238,26 +238,37 @@ Used to view column names, data types, categories, and states of a table. **Examples:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 1.4 Update Tables @@ -284,9 +295,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **Example:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -304,6 +315,6 @@ DROP TABLE (IF EXISTS)? **Examples:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ``` \ No newline at end of file diff --git a/src/UserGuide/latest-Table/Basic-Concept/Table-Management_timecho.md b/src/UserGuide/latest-Table/Basic-Concept/Table-Management_timecho.md index b169d83de..19d3a5e01 100644 --- a/src/UserGuide/latest-Table/Basic-Concept/Table-Management_timecho.md +++ b/src/UserGuide/latest-Table/Basic-Concept/Table-Management_timecho.md @@ -95,7 +95,7 @@ CREATE TABLE table1 ( ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE if not exists table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( "Site" STRING TAG, @@ -103,6 +103,8 @@ CREATE TABLE tableC ( ) with (TTL=DEFAULT); ``` +Note: If your terminal does not support multi-line paste (e.g., Windows CMD), please reformat the SQL statement into a single line before execution. + #### 1.1.2 Automatically Create Tables via SESSION Tables can be created automatically when inserting data via session. @@ -201,21 +203,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **Examples:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 1.3 View Table Columns @@ -238,26 +238,37 @@ Used to view column names, data types, categories, and states of a table. **Examples:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 1.4 Update Tables @@ -284,9 +295,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **Example:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -304,6 +315,6 @@ DROP TABLE (IF EXISTS)? **Examples:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ``` \ No newline at end of file diff --git a/src/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_apache.md b/src/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_apache.md index af0f1cf90..8598de7ff 100644 --- a/src/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_apache.md +++ b/src/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_apache.md @@ -131,10 +131,9 @@ It is possible to insert data for specific columns. Columns not specified will r **Example:** ```SQL -insert into table1("region", "plant_id", "device_id", Time, "temperature", "displacement") values ('Hamburg', '3001', '3', 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) - -insert into table1("region", "plant_id", "device_id", Time, "temperature") values ('Hamburg, '3001', '3', 5, 90.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` ### 1.4 Null Value Insertion @@ -147,9 +146,9 @@ Equivalent to the above partial column insertion. ```SQL # Equivalent to the example above -insert into table1("region", "plant_id", "device_id", "model", "maintenance_cycle", Time, "temperature", "displacement") values ('Hamburg', '3001', '3', null, null, 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("region", "plant_id", "device_id", "model", "maintenance_cycle", Time, "temperature", "displacement") values ('Hamburg', '3001', '3', null, null, 5, 90.0, null) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` If no tag columns are included, the system will automatically create a device with all tag column values set to `null`. @@ -163,17 +162,16 @@ IoTDB supports inserting multiple rows of data in a single statement to improve **Example**: ```SQL -insert into table1 -values -(4, 'Frankfurt', '3001', '3', '1', '10', 90.0, 1200.0) -(5, 'Frankfurt', '3001', '3', '1', '10', 90.0, 1200.0) - - -insert into table1 -("region", "plant_id", "device_id", Time, "temperature", "displacement") -values -('Frankfurt', '3001', '3', 4, 90.0, 1200.0) -('Frankfurt', '3001', '3', 5, 90.0, 1200.0) +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') + +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) +VALUES +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` #### Notes diff --git a/src/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_timecho.md b/src/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_timecho.md index e1c03bd46..7d12c6bd7 100644 --- a/src/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_timecho.md +++ b/src/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_timecho.md @@ -131,10 +131,9 @@ It is possible to insert data for specific columns. Columns not specified will r **Example:** ```SQL -insert into table1("region", "plant_id", "device_id", Time, "temperature", "displacement") values ('Hamburg', '3001', '3', 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) - -insert into table1("region", "plant_id", "device_id", Time, "temperature") values ('Hamburg, '3001', '3', 5, 90.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` ### 1.4 Null Value Insertion @@ -147,9 +146,9 @@ Equivalent to the above partial column insertion. ```SQL # Equivalent to the example above -insert into table1("region", "plant_id", "device_id", "model", "maintenance_cycle", Time, "temperature", "displacement") values ('Hamburg', '3001', '3', null, null, 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("region", "plant_id", "device_id", "model", "maintenance_cycle", Time, "temperature", "displacement") values ('Hamburg', '3001', '3', null, null, 5, 90.0, null) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` If no tag columns are included, the system will automatically create a device with all tag column values set to `null`. @@ -163,17 +162,16 @@ IoTDB supports inserting multiple rows of data in a single statement to improve **Example**: ```SQL -insert into table1 -values -(4, 'Frankfurt', '3001', '3', '1', '10', 90.0, 1200.0) -(5, 'Frankfurt', '3001', '3', '1', '10', 90.0, 1200.0) - - -insert into table1 -("region", "plant_id", "device_id", Time, "temperature", "displacement") -values -('Frankfurt', '3001', '3', 4, 90.0, 1200.0) -('Frankfurt', '3001', '3', 5, 90.0, 1200.0) +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') + +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) +VALUES +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` #### Notes diff --git a/src/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md b/src/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md index 54046c3c0..6e7de7623 100644 --- a/src/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md +++ b/src/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md @@ -34,35 +34,33 @@ INSERT INTO [(COLUMN_NAME[, COLUMN_NAME]*)]? VALUES (COLUMN_VALUE[, **Example 1: Specified Columns Insertion** ```SQL -INSERT INTO table1("Region", "PlantID", "DeviceID", Time, "Temperature", "Displacement") -VALUES ('Hunan', '3001', '3', 4, 90.0, 1200.0); +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) -INSERT INTO table1("Region", "PlantID", "DeviceID", Time, "Temperature") -VALUES ('Hunan', '3001', '3', 5, 90.0); +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` **Example 2: NULL Value Insertion** ```SQL --- Equivalent to partial insertion with NULL values -INSERT INTO table1("Region", "PlantID", "DeviceID", "Model", "MaintenanceCycle", Time, "Temperature", "Displacement") -VALUES ('Hunan', '3001', '3', NULL, NULL, 4, 90.0, 1200.0); +# Equivalent to the example above +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -INSERT INTO table1("Region", "PlantID", "DeviceID", "Model", "MaintenanceCycle", Time, "Temperature", "Displacement") -VALUES ('Hunan', '3001', '3', NULL, NULL, 5, 90.0, NULL); +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` **Example 3: Multi-row Insertion** ```SQL -INSERT INTO table1 VALUES -(4, 'Beijing', '3001', '3', '1', '10', 90.0, 1200.0), -(5, 'Beijing', '3001', '3', '1', '10', 90.0, 1200.0); +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') -INSERT INTO table1("Region", "PlantID", "DeviceID", Time, "Temperature", "Displacement") +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) VALUES -('Beijing', '3001', '3', 4, 90.0, 1200.0), -('Beijing', '3001', '3', 5, 90.0, 1200.0); +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` **Example 4: Query Write-back** diff --git a/src/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md b/src/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md index 26edcaba3..74163386d 100644 --- a/src/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md +++ b/src/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md @@ -34,35 +34,33 @@ INSERT INTO [(COLUMN_NAME[, COLUMN_NAME]*)]? VALUES (COLUMN_VALUE[, **Example 1: Specified Columns Insertion** ```SQL -INSERT INTO table1("Region", "PlantID", "DeviceID", Time, "Temperature", "Displacement") -VALUES ('Hunan', '3001', '3', 4, 90.0, 1200.0); +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) -INSERT INTO table1("Region", "PlantID", "DeviceID", Time, "Temperature") -VALUES ('Hunan', '3001', '3', 5, 90.0); +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('Hamburg', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` **Example 2: NULL Value Insertion** ```SQL --- Equivalent to partial insertion with NULL values -INSERT INTO table1("Region", "PlantID", "DeviceID", "Model", "MaintenanceCycle", Time, "Temperature", "Displacement") -VALUES ('Hunan', '3001', '3', NULL, NULL, 4, 90.0, 1200.0); +# Equivalent to the example above +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -INSERT INTO table1("Region", "PlantID", "DeviceID", "Model", "MaintenanceCycle", Time, "Temperature", "Displacement") -VALUES ('Hunan', '3001', '3', NULL, NULL, 5, 90.0, NULL); +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('Hamburg', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` **Example 3: Multi-row Insertion** ```SQL -INSERT INTO table1 VALUES -(4, 'Beijing', '3001', '3', '1', '10', 90.0, 1200.0), -(5, 'Beijing', '3001', '3', '1', '10', 90.0, 1200.0); +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', 'Frankfurt', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') -INSERT INTO table1("Region", "PlantID", "DeviceID", Time, "Temperature", "Displacement") +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) VALUES -('Beijing', '3001', '3', 4, 90.0, 1200.0), -('Beijing', '3001', '3', 5, 90.0, 1200.0); +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('Frankfurt', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` **Example 4: Query Write-back** diff --git a/src/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_apache.md b/src/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_apache.md index 625e2ed75..a96828c88 100644 --- a/src/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_apache.md +++ b/src/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_apache.md @@ -75,13 +75,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -99,19 +99,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 Modify Database @@ -195,14 +196,17 @@ CREATE TABLE table1 ( arrival_time TIMESTAMP FIELD COMMENT 'arrival_time' ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE IF NOT EXISTS table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( - "plant" STRING TAG, - "temperature" INT32 FIELD COMMENT 'temperature' -) WITH (TTL=DEFAULT); + "Site" STRING TAG, + "Temperature" int32 FIELD COMMENT 'temperature' + ) with (TTL=DEFAULT); ``` +Note: If your terminal does not support multi-line paste (e.g., Windows CMD), please reformat the SQL statement into a single line before execution. + + ### 2.2 List Tables **Syntax:** @@ -214,21 +218,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **Examples:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 2.3 Describe Table Columns @@ -242,26 +244,37 @@ IoTDB> show tables details from test_db **Examples:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 2.4 Modify Table @@ -280,8 +293,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **Examples:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -297,8 +311,8 @@ DROP TABLE (IF EXISTS)? **Examples:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ``` diff --git a/src/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_timecho.md b/src/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_timecho.md index d3f8967d9..7c94bf290 100644 --- a/src/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_timecho.md +++ b/src/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_timecho.md @@ -75,13 +75,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -99,19 +99,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 Modify Database @@ -195,14 +196,17 @@ CREATE TABLE table1 ( arrival_time TIMESTAMP FIELD COMMENT 'arrival_time' ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE IF NOT EXISTS table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( - "plant" STRING TAG, - "temperature" INT32 FIELD COMMENT 'temperature' -) WITH (TTL=DEFAULT); + "Site" STRING TAG, + "Temperature" int32 FIELD COMMENT 'temperature' + ) with (TTL=DEFAULT); ``` +Note: If your terminal does not support multi-line paste (e.g., Windows CMD), please reformat the SQL statement into a single line before execution. + + ### 2.2 List Tables **Syntax:** @@ -214,21 +218,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **Examples:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 2.3 Describe Table Columns @@ -242,26 +244,37 @@ IoTDB> show tables details from test_db **Examples:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 2.4 Modify Table @@ -280,8 +293,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **Examples:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -297,8 +311,8 @@ DROP TABLE (IF EXISTS)? **Examples:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ``` diff --git a/src/zh/UserGuide/Master/Table/Basic-Concept/Database-Management_apache.md b/src/zh/UserGuide/Master/Table/Basic-Concept/Database-Management_apache.md index eede4d4ca..e5234cfad 100644 --- a/src/zh/UserGuide/Master/Table/Basic-Concept/Database-Management_apache.md +++ b/src/zh/UserGuide/Master/Table/Basic-Concept/Database-Management_apache.md @@ -98,13 +98,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -134,19 +134,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 修改数据库 diff --git a/src/zh/UserGuide/Master/Table/Basic-Concept/Database-Management_timecho.md b/src/zh/UserGuide/Master/Table/Basic-Concept/Database-Management_timecho.md index 0c5b5c5da..a29b198da 100644 --- a/src/zh/UserGuide/Master/Table/Basic-Concept/Database-Management_timecho.md +++ b/src/zh/UserGuide/Master/Table/Basic-Concept/Database-Management_timecho.md @@ -98,13 +98,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -134,19 +134,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 修改数据库 diff --git a/src/zh/UserGuide/Master/Table/Basic-Concept/Table-Management_apache.md b/src/zh/UserGuide/Master/Table/Basic-Concept/Table-Management_apache.md index 3c3dc8d6e..727095ac9 100644 --- a/src/zh/UserGuide/Master/Table/Basic-Concept/Table-Management_apache.md +++ b/src/zh/UserGuide/Master/Table/Basic-Concept/Table-Management_apache.md @@ -102,14 +102,16 @@ CREATE TABLE table1 ( arrival_time TIMESTAMP FIELD COMMENT 'arrival_time' ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE if not exists table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( - "场站" STRING TAG, - "温度" int32 FIELD COMMENT 'temperature' + station STRING TAG, + temperature int32 FIELD COMMENT 'temperature' ) with (TTL=DEFAULT); ``` +注意：若您使用的终端不支持多行粘贴（例如 Windows CMD），请将 SQL 语句调整为单行格式后再执行。 + #### 1.1.2 通过 Session 写入自动创建表 在通过 Session 进行数据写入时，IoTDB 能够根据写入请求中的信息自动构建表结构，无需用户事先手动创建表即可直接执行数据写入操作。 @@ -208,21 +210,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **示例:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 1.3 查看表的列 @@ -244,26 +244,37 @@ IoTDB> show tables details from test_db **示例:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 1.4 修改表 @@ -290,9 +301,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **示例:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -310,6 +321,6 @@ DROP TABLE (IF EXISTS)? **示例:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ``` \ No newline at end of file diff --git a/src/zh/UserGuide/Master/Table/Basic-Concept/Table-Management_timecho.md b/src/zh/UserGuide/Master/Table/Basic-Concept/Table-Management_timecho.md index 314991c13..1c48c587e 100644 --- a/src/zh/UserGuide/Master/Table/Basic-Concept/Table-Management_timecho.md +++ b/src/zh/UserGuide/Master/Table/Basic-Concept/Table-Management_timecho.md @@ -102,14 +102,16 @@ CREATE TABLE table1 ( arrival_time TIMESTAMP FIELD COMMENT 'arrival_time' ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE if not exists table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( - "场站" STRING TAG, - "温度" int32 FIELD COMMENT 'temperature' + station STRING TAG, + temperature int32 FIELD COMMENT 'temperature' ) with (TTL=DEFAULT); ``` +注意：若您使用的终端不支持多行粘贴（例如 Windows CMD），请将 SQL 语句调整为单行格式后再执行。 + #### 1.1.2 通过 Session 写入自动创建表 在通过 Session 进行数据写入时，IoTDB 能够根据写入请求中的信息自动构建表结构，无需用户事先手动创建表即可直接执行数据写入操作。 @@ -208,21 +210,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **示例:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 1.3 查看表的列 @@ -244,26 +244,37 @@ IoTDB> show tables details from test_db **示例:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 1.4 修改表 @@ -290,9 +301,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **示例:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -310,6 +321,6 @@ DROP TABLE (IF EXISTS)? **示例:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ``` \ No newline at end of file diff --git a/src/zh/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_apache.md b/src/zh/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_apache.md index 3f21c60d9..1029cef84 100644 --- a/src/zh/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_apache.md +++ b/src/zh/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_apache.md @@ -131,10 +131,9 @@ IoTDB> desc table1 **示例：** ```SQL -insert into table1("地区", "厂号", "设备号", Time, "温度", "排量") values ('湖南', '3001', '3', 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('北京', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) - -insert into table1("地区", "厂号", "设备号", Time, "温度") values ('湖南, '3001', '3', 5, 90.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('北京', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` ### 1.4 空值写入 @@ -145,9 +144,9 @@ insert into table1("地区", "厂号", "设备号", Time, "温度") values ('湖 ```SQL # 上述部分列写入等价于如下的带空值写入 -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 5, 90.0, null) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` 当向不包含任何标签列的表中写入数据时，系统将默认创建一个所有标签列值均为 null 的device。 @@ -161,17 +160,16 @@ insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Ti **示例：** ```SQL -insert into table1 -values -(4, 北京', '3001', '3', '1', '10', 90.0, 1200.0), -(5, 北京', '3001', '3', '1', '10', 90.0, 1200.0); - - -insert into table1 -("地区", "厂号", "设备号", Time, "温度", "排量") -values -('北京', '3001', '3', 4, 90.0, 1200.0), -('北京', '3001', '3', 5, 90.0, 1200.0); +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') + +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) +VALUES +('北京', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('北京', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` #### 注意事项 diff --git a/src/zh/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_timecho.md b/src/zh/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_timecho.md index 2cf792b56..2d4bc3044 100644 --- a/src/zh/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_timecho.md +++ b/src/zh/UserGuide/Master/Table/Basic-Concept/Write-Updata-Data_timecho.md @@ -131,10 +131,9 @@ IoTDB> desc table1 **示例：** ```SQL -insert into table1("地区", "厂号", "设备号", Time, "温度", "排量") values ('湖南', '3001', '3', 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('北京', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) - -insert into table1("地区", "厂号", "设备号", Time, "温度") values ('湖南, '3001', '3', 5, 90.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('北京', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` ### 1.4 空值写入 @@ -145,9 +144,9 @@ insert into table1("地区", "厂号", "设备号", Time, "温度") values ('湖 ```SQL # 上述部分列写入等价于如下的带空值写入 -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 5, 90.0, null) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` 当向不包含任何标签列的表中写入数据时，系统将默认创建一个所有标签列值均为 null 的device。 @@ -161,17 +160,16 @@ insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Ti **示例：** ```SQL -insert into table1 -values -(4, 北京', '3001', '3', '1', '10', 90.0, 1200.0), -(5, 北京', '3001', '3', '1', '10', 90.0, 1200.0); - - -insert into table1 -("地区", "厂号", "设备号", Time, "温度", "排量") -values -('北京', '3001', '3', 4, 90.0, 1200.0), -('北京', '3001', '3', 5, 90.0, 1200.0); +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') + +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) +VALUES +('北京', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('北京', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` #### 注意事项 diff --git a/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md b/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md index 423898996..e84f1fef3 100644 --- a/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md +++ b/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md @@ -34,33 +34,33 @@ INSERT INTO [(COLUMN_NAME[, COLUMN_NAME]*)]? VALUES (COLUMN_VALUE[, **示例一：指定列写入** ```SQL -insert into table1("地区", "厂号", "设备号", Time, "温度", "排量") values ('湖南', '3001', '3', 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('北京', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("地区", "厂号", "设备号", Time, "温度") values ('湖南, '3001', '3', 5, 90.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('北京', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` **示例二：空值写入** ```SQL --- 上述部分列写入等价于如下的带空值写入 -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 4, 90.0, 1200.0) +# 上述部分列写入等价于如下的带空值写入 +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 5, 90.0, null) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` **示例三：多行写入** ```SQL -insert into table1 -values -(4, '北京', '3001', '3', '1', '10', 90.0, 1200.0), -(5, '北京', '3001', '3', '1', '10', 90.0, 1200.0); - -insert into table1 -("地区", "厂号", "设备号", Time, "温度", "排量") -values -('北京', '3001', '3', 4, 90.0, 1200.0), -('北京', '3001', '3', 5, 90.0, 1200.0); +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') + +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) +VALUES +('北京', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('北京', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` **示例四：查询写回** diff --git a/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md b/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md index f24b1e923..2b33cf13b 100644 --- a/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md +++ b/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md @@ -34,33 +34,33 @@ INSERT INTO [(COLUMN_NAME[, COLUMN_NAME]*)]? VALUES (COLUMN_VALUE[, **示例一：指定列写入** ```SQL -insert into table1("地区", "厂号", "设备号", Time, "温度", "排量") values ('湖南', '3001', '3', 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('北京', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("地区", "厂号", "设备号", Time, "温度") values ('湖南, '3001', '3', 5, 90.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('北京', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` **示例二：空值写入** ```SQL --- 上述部分列写入等价于如下的带空值写入 -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 4, 90.0, 1200.0) +# 上述部分列写入等价于如下的带空值写入 +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 5, 90.0, null) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` **示例三：多行写入** ```SQL -insert into table1 -values -(4, '北京', '3001', '3', '1', '10', 90.0, 1200.0), -(5, '北京', '3001', '3', '1', '10', 90.0, 1200.0); - -insert into table1 -("地区", "厂号", "设备号", Time, "温度", "排量") -values -('北京', '3001', '3', 4, 90.0, 1200.0), -('北京', '3001', '3', 5, 90.0, 1200.0); +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') + +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) +VALUES +('北京', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('北京', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` **示例四：查询写回** diff --git a/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_apache.md b/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_apache.md index 638e001de..b32a0d726 100644 --- a/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_apache.md +++ b/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_apache.md @@ -75,13 +75,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -99,19 +99,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 修改数据库 @@ -195,13 +196,14 @@ CREATE TABLE table1 ( arrival_time TIMESTAMP FIELD COMMENT 'arrival_time' ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE if not exists table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( - "场站" STRING TAG, - "温度" int32 FIELD COMMENT 'temperature' + station STRING TAG, + temperature int32 FIELD COMMENT 'temperature' ) with (TTL=DEFAULT); ``` +注意：若您使用的终端不支持多行粘贴（例如 Windows CMD），请将 SQL 语句调整为单行格式后再执行。 ### 2.2 查看表 @@ -214,21 +216,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **示例:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 2.3 查看表的列 @@ -242,26 +242,37 @@ IoTDB> show tables details from test_db **示例:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 2.4 修改表 @@ -280,8 +291,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **示例:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -297,8 +309,8 @@ DROP TABLE (IF EXISTS)? **示例:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ``` diff --git a/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_timecho.md b/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_timecho.md index 5a612565a..31e1aaf72 100644 --- a/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_timecho.md +++ b/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Metadata-Operations_timecho.md @@ -75,13 +75,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -99,19 +99,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 修改数据库 @@ -195,13 +196,14 @@ CREATE TABLE table1 ( arrival_time TIMESTAMP FIELD COMMENT 'arrival_time' ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE if not exists table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( - "场站" STRING TAG, - "温度" int32 FIELD COMMENT 'temperature' + station STRING TAG, + temperature int32 FIELD COMMENT 'temperature' ) with (TTL=DEFAULT); ``` +注意：若您使用的终端不支持多行粘贴（例如 Windows CMD），请将 SQL 语句调整为单行格式后再执行。 ### 2.2 查看表 @@ -214,21 +216,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **示例:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 2.3 查看表的列 @@ -242,26 +242,37 @@ IoTDB> show tables details from test_db **示例:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 2.4 修改表 @@ -280,8 +291,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **示例:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -297,8 +309,8 @@ DROP TABLE (IF EXISTS)? **示例:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ``` diff --git a/src/zh/UserGuide/latest-Table/Basic-Concept/Database-Management_apache.md b/src/zh/UserGuide/latest-Table/Basic-Concept/Database-Management_apache.md index eede4d4ca..e5234cfad 100644 --- a/src/zh/UserGuide/latest-Table/Basic-Concept/Database-Management_apache.md +++ b/src/zh/UserGuide/latest-Table/Basic-Concept/Database-Management_apache.md @@ -98,13 +98,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -134,19 +134,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 修改数据库 diff --git a/src/zh/UserGuide/latest-Table/Basic-Concept/Database-Management_timecho.md b/src/zh/UserGuide/latest-Table/Basic-Concept/Database-Management_timecho.md index 0c5b5c5da..a29b198da 100644 --- a/src/zh/UserGuide/latest-Table/Basic-Concept/Database-Management_timecho.md +++ b/src/zh/UserGuide/latest-Table/Basic-Concept/Database-Management_timecho.md @@ -98,13 +98,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -134,19 +134,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 修改数据库 diff --git a/src/zh/UserGuide/latest-Table/Basic-Concept/Table-Management_apache.md b/src/zh/UserGuide/latest-Table/Basic-Concept/Table-Management_apache.md index 3c3dc8d6e..727095ac9 100644 --- a/src/zh/UserGuide/latest-Table/Basic-Concept/Table-Management_apache.md +++ b/src/zh/UserGuide/latest-Table/Basic-Concept/Table-Management_apache.md @@ -102,14 +102,16 @@ CREATE TABLE table1 ( arrival_time TIMESTAMP FIELD COMMENT 'arrival_time' ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE if not exists table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( - "场站" STRING TAG, - "温度" int32 FIELD COMMENT 'temperature' + station STRING TAG, + temperature int32 FIELD COMMENT 'temperature' ) with (TTL=DEFAULT); ``` +注意：若您使用的终端不支持多行粘贴（例如 Windows CMD），请将 SQL 语句调整为单行格式后再执行。 + #### 1.1.2 通过 Session 写入自动创建表 在通过 Session 进行数据写入时，IoTDB 能够根据写入请求中的信息自动构建表结构，无需用户事先手动创建表即可直接执行数据写入操作。 @@ -208,21 +210,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **示例:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 1.3 查看表的列 @@ -244,26 +244,37 @@ IoTDB> show tables details from test_db **示例:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 1.4 修改表 @@ -290,9 +301,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **示例:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -310,6 +321,6 @@ DROP TABLE (IF EXISTS)? **示例:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ``` \ No newline at end of file diff --git a/src/zh/UserGuide/latest-Table/Basic-Concept/Table-Management_timecho.md b/src/zh/UserGuide/latest-Table/Basic-Concept/Table-Management_timecho.md index 314991c13..1c48c587e 100644 --- a/src/zh/UserGuide/latest-Table/Basic-Concept/Table-Management_timecho.md +++ b/src/zh/UserGuide/latest-Table/Basic-Concept/Table-Management_timecho.md @@ -102,14 +102,16 @@ CREATE TABLE table1 ( arrival_time TIMESTAMP FIELD COMMENT 'arrival_time' ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE if not exists table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( - "场站" STRING TAG, - "温度" int32 FIELD COMMENT 'temperature' + station STRING TAG, + temperature int32 FIELD COMMENT 'temperature' ) with (TTL=DEFAULT); ``` +注意：若您使用的终端不支持多行粘贴（例如 Windows CMD），请将 SQL 语句调整为单行格式后再执行。 + #### 1.1.2 通过 Session 写入自动创建表 在通过 Session 进行数据写入时，IoTDB 能够根据写入请求中的信息自动构建表结构，无需用户事先手动创建表即可直接执行数据写入操作。 @@ -208,21 +210,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **示例:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 1.3 查看表的列 @@ -244,26 +244,37 @@ IoTDB> show tables details from test_db **示例:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 1.4 修改表 @@ -290,9 +301,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **示例:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -310,6 +321,6 @@ DROP TABLE (IF EXISTS)? **示例:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ``` \ No newline at end of file diff --git a/src/zh/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_apache.md b/src/zh/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_apache.md index 3f21c60d9..1029cef84 100644 --- a/src/zh/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_apache.md +++ b/src/zh/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_apache.md @@ -131,10 +131,9 @@ IoTDB> desc table1 **示例：** ```SQL -insert into table1("地区", "厂号", "设备号", Time, "温度", "排量") values ('湖南', '3001', '3', 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('北京', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) - -insert into table1("地区", "厂号", "设备号", Time, "温度") values ('湖南, '3001', '3', 5, 90.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('北京', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` ### 1.4 空值写入 @@ -145,9 +144,9 @@ insert into table1("地区", "厂号", "设备号", Time, "温度") values ('湖 ```SQL # 上述部分列写入等价于如下的带空值写入 -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 5, 90.0, null) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` 当向不包含任何标签列的表中写入数据时，系统将默认创建一个所有标签列值均为 null 的device。 @@ -161,17 +160,16 @@ insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Ti **示例：** ```SQL -insert into table1 -values -(4, 北京', '3001', '3', '1', '10', 90.0, 1200.0), -(5, 北京', '3001', '3', '1', '10', 90.0, 1200.0); - - -insert into table1 -("地区", "厂号", "设备号", Time, "温度", "排量") -values -('北京', '3001', '3', 4, 90.0, 1200.0), -('北京', '3001', '3', 5, 90.0, 1200.0); +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') + +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) +VALUES +('北京', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('北京', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` #### 注意事项 diff --git a/src/zh/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_timecho.md b/src/zh/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_timecho.md index 2cf792b56..2d4bc3044 100644 --- a/src/zh/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_timecho.md +++ b/src/zh/UserGuide/latest-Table/Basic-Concept/Write-Updata-Data_timecho.md @@ -131,10 +131,9 @@ IoTDB> desc table1 **示例：** ```SQL -insert into table1("地区", "厂号", "设备号", Time, "温度", "排量") values ('湖南', '3001', '3', 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('北京', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) - -insert into table1("地区", "厂号", "设备号", Time, "温度") values ('湖南, '3001', '3', 5, 90.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('北京', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` ### 1.4 空值写入 @@ -145,9 +144,9 @@ insert into table1("地区", "厂号", "设备号", Time, "温度") values ('湖 ```SQL # 上述部分列写入等价于如下的带空值写入 -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 5, 90.0, null) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` 当向不包含任何标签列的表中写入数据时，系统将默认创建一个所有标签列值均为 null 的device。 @@ -161,17 +160,16 @@ insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Ti **示例：** ```SQL -insert into table1 -values -(4, 北京', '3001', '3', '1', '10', 90.0, 1200.0), -(5, 北京', '3001', '3', '1', '10', 90.0, 1200.0); - - -insert into table1 -("地区", "厂号", "设备号", Time, "温度", "排量") -values -('北京', '3001', '3', 4, 90.0, 1200.0), -('北京', '3001', '3', 5, 90.0, 1200.0); +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') + +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) +VALUES +('北京', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('北京', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` #### 注意事项 diff --git a/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md b/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md index 423898996..e84f1fef3 100644 --- a/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md +++ b/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_apache.md @@ -34,33 +34,33 @@ INSERT INTO [(COLUMN_NAME[, COLUMN_NAME]*)]? VALUES (COLUMN_VALUE[, **示例一：指定列写入** ```SQL -insert into table1("地区", "厂号", "设备号", Time, "温度", "排量") values ('湖南', '3001', '3', 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('北京', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("地区", "厂号", "设备号", Time, "温度") values ('湖南, '3001', '3', 5, 90.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('北京', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` **示例二：空值写入** ```SQL --- 上述部分列写入等价于如下的带空值写入 -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 4, 90.0, 1200.0) +# 上述部分列写入等价于如下的带空值写入 +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 5, 90.0, null) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` **示例三：多行写入** ```SQL -insert into table1 -values -(4, '北京', '3001', '3', '1', '10', 90.0, 1200.0), -(5, '北京', '3001', '3', '1', '10', 90.0, 1200.0); - -insert into table1 -("地区", "厂号", "设备号", Time, "温度", "排量") -values -('北京', '3001', '3', 4, 90.0, 1200.0), -('北京', '3001', '3', 5, 90.0, 1200.0); +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') + +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) +VALUES +('北京', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('北京', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` **示例四：查询写回** diff --git a/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md b/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md index f24b1e923..2b33cf13b 100644 --- a/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md +++ b/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Data-Addition-Deletion_timecho.md @@ -34,33 +34,33 @@ INSERT INTO [(COLUMN_NAME[, COLUMN_NAME]*)]? VALUES (COLUMN_VALUE[, **示例一：指定列写入** ```SQL -insert into table1("地区", "厂号", "设备号", Time, "温度", "排量") values ('湖南', '3001', '3', 4, 90.0, 1200.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature, humidity) VALUES ('北京', '1001', '100', '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("地区", "厂号", "设备号", Time, "温度") values ('湖南, '3001', '3', 5, 90.0) +INSERT INTO table1(region, plant_id, device_id, time, temperature) VALUES ('北京', '1001', '100', '2025-11-26 13:38:00', 91.0) ``` **示例二：空值写入** ```SQL --- 上述部分列写入等价于如下的带空值写入 -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 4, 90.0, 1200.0) +# 上述部分列写入等价于如下的带空值写入 +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:37:00', 90.0, 35.1) -insert into table1("地区", "厂号", "设备号", "型号", "维修周期", Time, "温度", "排量") values ('湖南', '3001', '3', null, null, 5, 90.0, null) +INSERT INTO table1(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity) VALUES ('北京', '1001', '100', null, null, '2025-11-26 13:38:00', 91.0, null) ``` **示例三：多行写入** ```SQL -insert into table1 -values -(4, '北京', '3001', '3', '1', '10', 90.0, 1200.0), -(5, '北京', '3001', '3', '1', '10', 90.0, 1200.0); - -insert into table1 -("地区", "厂号", "设备号", Time, "温度", "排量") -values -('北京', '3001', '3', 4, 90.0, 1200.0), -('北京', '3001', '3', 5, 90.0, 1200.0); +INSERT INTO table1 +VALUES +('2025-11-26 13:37:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('2025-11-26 13:38:00', '北京', '1001', '100', 'A', '180', 90.0, 35.1, true, '2025-11-26 13:38:25') + +INSERT INTO table1 +(region, plant_id, device_id, model_id, maintenance, time, temperature, humidity, status, arrival_time) +VALUES +('北京', '1001', '100', 'A', '180', '2025-11-26 13:37:00', 90.0, 35.1, true, '2025-11-26 13:37:34'), +('北京', '1001', '100', 'A', '180', '2025-11-26 13:38:00', 90.0, 35.1, true, '2025-11-26 13:38:25') ``` **示例四：查询写回** diff --git a/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_apache.md b/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_apache.md index 638e001de..b32a0d726 100644 --- a/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_apache.md +++ b/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_apache.md @@ -75,13 +75,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -99,19 +99,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 修改数据库 @@ -195,13 +196,14 @@ CREATE TABLE table1 ( arrival_time TIMESTAMP FIELD COMMENT 'arrival_time' ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE if not exists table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( - "场站" STRING TAG, - "温度" int32 FIELD COMMENT 'temperature' + station STRING TAG, + temperature int32 FIELD COMMENT 'temperature' ) with (TTL=DEFAULT); ``` +注意：若您使用的终端不支持多行粘贴（例如 Windows CMD），请将 SQL 语句调整为单行格式后再执行。 ### 2.2 查看表 @@ -214,21 +216,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **示例:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 2.3 查看表的列 @@ -242,26 +242,37 @@ IoTDB> show tables details from test_db **示例:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 2.4 修改表 @@ -280,8 +291,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **示例:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -297,8 +309,8 @@ DROP TABLE (IF EXISTS)? **示例:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ``` diff --git a/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_timecho.md b/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_timecho.md index 5a612565a..31e1aaf72 100644 --- a/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_timecho.md +++ b/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Metadata-Operations_timecho.md @@ -75,13 +75,13 @@ IoTDB> SHOW CURRENT_DATABASE; | null| +---------------+ -IoTDB> USE test; +IoTDB> USE database1; IoTDB> SHOW CURRENT_DATABASE; +---------------+ |CurrentDatabase| +---------------+ -| iot_database| +| database1| +---------------+ ``` @@ -99,19 +99,20 @@ SHOW DATABASES (DETAILS)? ```SQL IoTDB> show databases -+---------+-------+-----------------------+---------------------+---------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| -+---------+-------+-----------------------+---------------------+---------------------+ -|test_prop| 300| 3| 2| 100000| -| test2| 300| 3| 2| 604800000| -+---------+-------+-----------------------+---------------------+---------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval| ++------------------+-------+-----------------------+---------------------+---------------------+ +| database1| INF| 1| 1| 604800000| +|information_schema| INF| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+ + IoTDB> show databases details -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum| DataRegionGroupNum| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ -|test_prop| 300| 3| 2| 100000| 1| 2| -| test2| 300| 3| 2| 604800000| 1| 2| -+---------+-------+-----------------------+---------------------+---------------------+-----------------------+-----------------------+ ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| Database|TTL(ms)|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|DataRegionGroupNum| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ +| database1| INF| 1| 1| 604800000| 1| 2| +|information_schema| INF| null| null| null| null| null| ++------------------+-------+-----------------------+---------------------+---------------------+--------------------+------------------+ ``` ### 1.5 修改数据库 @@ -195,13 +196,14 @@ CREATE TABLE table1 ( arrival_time TIMESTAMP FIELD COMMENT 'arrival_time' ) COMMENT 'table1' WITH (TTL=31536000000); -CREATE TABLE if not exists table2 (); +CREATE TABLE if not exists tableB (); CREATE TABLE tableC ( - "场站" STRING TAG, - "温度" int32 FIELD COMMENT 'temperature' + station STRING TAG, + temperature int32 FIELD COMMENT 'temperature' ) with (TTL=DEFAULT); ``` +注意：若您使用的终端不支持多行粘贴（例如 Windows CMD），请将 SQL 语句调整为单行格式后再执行。 ### 2.2 查看表 @@ -214,21 +216,19 @@ SHOW TABLES (DETAILS)? ((FROM | IN) database_name)? **示例:** ```SQL -IoTDB> show tables from test_db -+---------+-------+-------+ -|TableName|TTL(ms)|Comment| -+---------+-------+-------+ -| test| INF| TEST| -+---------+-------+-------+ - -IoTDB> show tables details from test_db -+---------+-------+----------+-------+ -|TableName|TTL(ms)| Status|Comment| -+---------+-------+----------+-------+ -| test| INF| USING| TEST| -| turbine| INF|PRE_CREATE| null| -| car| 1000|PRE_DELETE| null| -+---------+-------+----------+-------+ +IoTDB> show tables from database1 ++---------+---------------+ +|TableName| TTL(ms)| ++---------+---------------+ +| table1| 31536000000| ++---------+---------------+ + +IoTDB> show tables details from database1 ++---------------+-----------+------+-------+ +| TableName| TTL(ms)|Status|Comment| ++---------------+-----------+------+-------+ +| table1|31536000000| USING| table1| ++---------------+-----------+------+-------+ ``` ### 2.3 查看表的列 @@ -242,26 +242,37 @@ IoTDB> show tables details from test_db **示例:** ```SQL -IoTDB> desc tableB -+----------+---------+-----------+-------+ -|ColumnName| DataType| Category|Comment| -+----------+---------+-----------+-------+ -| time|TIMESTAMP| TIME| null| -| a| STRING| TAG| a| -| b| STRING| ATTRIBUTE| b| -| c| INT32| FIELD| c| -+----------+---------+-----------+-------+ - -IoTDB> desc tableB details -+----------+---------+-----------+----------+-------+ -|ColumnName| DataType| Category| Status|Comment| -+----------+---------+-----------+----------+-------+ -| time|TIMESTAMP| TIME| USING| null| -| a| STRING| TAG| USING| a| -| b| STRING| ATTRIBUTE| USING| b| -| c| INT32| FIELD| USING| c| -| d| INT32| FIELD|PRE_DELETE| d| -+----------+---------+-----------+----------+-------+ +IoTDB> desc table1 ++------------+---------+---------+ +| ColumnName| DataType| Category| ++------------+---------+---------+ +| time|TIMESTAMP| TIME| +| region| STRING| TAG| +| plant_id| STRING| TAG| +| device_id| STRING| TAG| +| model_id| STRING|ATTRIBUTE| +| maintenance| STRING|ATTRIBUTE| +| temperature| FLOAT| FIELD| +| humidity| FLOAT| FIELD| +| status| BOOLEAN| FIELD| +|arrival_time|TIMESTAMP| FIELD| ++------------+---------+---------+ + +IoTDB> desc table1 details ++------------+---------+---------+------+------------+ +| ColumnName| DataType| Category|Status| Comment| ++------------+---------+---------+------+------------+ +| time|TIMESTAMP| TIME| USING| null| +| region| STRING| TAG| USING| null| +| plant_id| STRING| TAG| USING| null| +| device_id| STRING| TAG| USING| null| +| model_id| STRING|ATTRIBUTE| USING| null| +| maintenance| STRING|ATTRIBUTE| USING| maintenance| +| temperature| FLOAT| FIELD| USING| temperature| +| humidity| FLOAT| FIELD| USING| humidity| +| status| BOOLEAN| FIELD| USING| status| +|arrival_time|TIMESTAMP| FIELD| USING|arrival_time| ++------------+---------+---------+------+------------+ ``` ### 2.4 修改表 @@ -280,8 +291,9 @@ ALTER TABLE (IF EXISTS)? tableName=qualifiedName ADD COLUMN (IF NOT EXISTS)? col **示例:** ```SQL -ALTER TABLE tableB ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' -ALTER TABLE tableB set properties TTL=3600 +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS a TAG COMMENT 'a' +ALTER TABLE table1 ADD COLUMN IF NOT EXISTS b FLOAT FIELD COMMENT 'b' +ALTER TABLE table1 set properties TTL=3600 COMMENT ON TABLE table1 IS 'table1' COMMENT ON COLUMN table1.a IS null ``` @@ -297,8 +309,8 @@ DROP TABLE (IF EXISTS)? **示例:** ```SQL -DROP TABLE tableA -DROP TABLE test.tableB +DROP TABLE table1 +DROP TABLE database1.table1 ```