apache-iotdb 1.3.2__py3-none-any.whl → 1.3.3__py3-none-any.whl

{apache_iotdb-1.3.2.dist-info → apache_iotdb-1.3.3.dist-info}/METADATA

@@ -1,23 +1,24 @@
 Metadata-Version: 2.1
 Name: apache-iotdb
-Version: 1.3.2
+Version: 1.3.3
 Summary: Apache IoTDB client API
-Home-page: https://github.com/apache/iotdb
-Author: Apache Software Foundation
-Author-email: dev@iotdb.apache.org
+Author-email: Apache IoTDB <dev@iotdb.apache.org>
 License: Apache License, Version 2.0
+Project-URL: Homepage, https://iotdb.apache.org
+Project-URL: Documentation, https://github.com/apache/iotdb
+Keywords: iotdb,apache,client,API
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.7
+Requires-Python: >=3.6
 Description-Content-Type: text/markdown
-Requires-Dist: thrift >=0.14.1
-Requires-Dist: pandas >=1.3.5
-Requires-Dist: numpy >=1.21.4
-Requires-Dist: sqlalchemy <1.5,>=1.4
-Requires-Dist: sqlalchemy-utils >=0.37.8
+Requires-Dist: thrift>=0.14.1
+Requires-Dist: pandas>=1.0.0
+Requires-Dist: numpy>=1.0.0
+Requires-Dist: sqlalchemy<1.5,>=1.4
+Requires-Dist: sqlalchemy-utils>=0.37.8
 
 <!--
 
@@ -42,7 +43,6 @@ Requires-Dist: sqlalchemy-utils >=0.37.8
 
 # Apache IoTDB
 
-[![Python Client](https://github.com/apache/iotdb/actions/workflows/client-python.yml/badge.svg?branch=master)](https://github.com/apache/iotdb/actions/workflows/client-python.yml)
 [![GitHub release](https://img.shields.io/github/release/apache/iotdb.svg)](https://github.com/apache/iotdb/releases)
 [![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)
 ![](https://github-size-badge.herokuapp.com/apache/iotdb.svg)
@@ -61,7 +61,7 @@ high-speed data ingestion and complex data analysis in the IoT industrial fields
 
 ### Requirements
 
-You have to install thrift (>=0.13) before using the package.
+You have to install thrift (>=0.14.1) before using the package.
 
 
 
@@ -69,8 +69,6 @@ You have to install thrift (>=0.13) before using the package.
 
 First, download the latest package: `pip3 install apache-iotdb`
 
-*Notice: If you are installing Python API v0.13.0, DO NOT install by `pip install apache-iotdb==0.13.0`, use `pip install apache-iotdb==0.13.0.post1` instead!* 
-
 You can get an example of using the package to read and write data at here: [Example](https://github.com/apache/iotdb/blob/master/client-py/SessionExample.py)
 
 An example of aligned timeseries: [Aligned Timeseries Session Example](https://github.com/apache/iotdb/blob/master/client-py/SessionAlignedTimeseriesExample.py)
@@ -333,91 +331,6 @@ session.execute_non_query_statement(sql)
 session.execute_statement(sql)
 ```
 
-### Device Template
-#### Create Device Template
-The step for creating a metadata template is as follows
-1. Create the template class
-2. Adding child Node，InternalNode and MeasurementNode can be chose
-3. Execute create device template function
-
-```python
-template = Template(name=template_name, share_time=True)
-
-i_node_gps = InternalNode(name="GPS", share_time=False)
-i_node_v = InternalNode(name="vehicle", share_time=True)
-m_node_x = MeasurementNode("x", TSDataType.FLOAT, TSEncoding.RLE, Compressor.SNAPPY)
-
-i_node_gps.add_child(m_node_x)
-i_node_v.add_child(m_node_x)
-
-template.add_template(i_node_gps)
-template.add_template(i_node_v)
-template.add_template(m_node_x)
-
-session.create_schema_template(template)
-```
-#### Modify Device Template nodes
-Modify nodes in a template, the template must be already created. These are functions that add or delete some measurement nodes.
-* add node in template
-```python
-session.add_measurements_in_template(template_name, measurements_path, data_types, encodings, compressors, is_aligned)
-```
-
-* delete node in template
-```python
-session.delete_node_in_template(template_name, path)
-```
-
-#### Set Device Template
-```python
-session.set_schema_template(template_name, prefix_path)
-```
-
-#### Uset Device Template
-```python
-session.unset_schema_template(template_name, prefix_path)
-```
-
-#### Show Device Template
-* Show all device templates
-```python
-session.show_all_templates()
-```
-* Count all nodes in templates
-```python
-session.count_measurements_in_template(template_name)
-```
-
-* Judge whether the path is measurement or not in templates, This measurement must be in the template
-```python
-session.count_measurements_in_template(template_name, path)
-```
-
-* Judge whether the path is exist or not in templates, This path may not belong to the template
-```python
-session.is_path_exist_in_template(template_name, path)
-```
-
-* Show nodes under in device template
-```python
-session.show_measurements_in_template(template_name)
-```
-
-* Show the path prefix where a device template is set
-```python
-session.show_paths_template_set_on(template_name)
-```
-
-* Show the path prefix where a device template is used (i.e. the time series has been created)
-```python
-session.show_paths_template_using_on(template_name)
-```
-
-#### Drop Device Template
-Delete an existing metadata template，dropping an already set template is not supported
-```python
-session.drop_schema_template("template_python")
-```
 
 
 ### Pandas Support
@@ -622,9 +535,9 @@ This is an example of how to connect to IoTDB with python, using the thrift rpc
 
 ### Prerequisites
 
-Python3.7 or later is preferred.
+Python3.6 or later is preferred.
 
-You have to install Thrift (0.11.0 or later) to compile our thrift file into python code. Below is the official tutorial of installation, eventually, you should have a thrift executable.
+You have to install Thrift (0.14.1 or later) to compile our thrift file into python code. Below is the official tutorial of installation, eventually, you should have a thrift executable.
 
 ```
 http://thrift.apache.org/docs/install/
@@ -710,8 +623,7 @@ Namely, these are
 
 * Remove all transient directories from last release (if exists)
 * (Re-)generate all generated sources via mvn
-* Run Linting (flake8)
-* Run Tests via pytest
+* Run Tests via pytest (optional)
 * Build
 * Release to pypi
 

{apache_iotdb-1.3.2.dist-info → apache_iotdb-1.3.3.dist-info}/RECORD

@@ -1,5 +1,5 @@
 iotdb/IoTDBContainer.py,sha256=gmGMEzacytqvrpCXGn0xrm3ab4LDyToNCHPEFg82Mwg,2514
-iotdb/Session.py,sha256=CvIgzCtOE4TvrlraseS4xuDFrWScmauRnv_4Z0o3WMQ,89871
+iotdb/Session.py,sha256=dByc74pmLqWuctP5ILBZpWh_TiiMYcamUWLwH1lor9k,93922
 iotdb/SessionPool.py,sha256=To4o6oOacL8KEHJbU3G-1BtJywu__dUaAyFUh-t6ON8,5478
 iotdb/__init__.py,sha256=vGVFsdMOp1iKaCQl5rfYcPVa0FV94d-a7MsMDQDhHMc,789
 iotdb/dbapi/Connection.py,sha256=t5CuwOTrMJxJ2YVxaEKi2fdaH9Vob-u7nQRCD_9vLcg,2569
@@ -16,16 +16,15 @@ iotdb/sqlalchemy/IoTDBTypeCompiler.py,sha256=1ZrQvMt3lieN-HUjJLlmSVGy1DwBCWZMwC8
 iotdb/sqlalchemy/__init__.py,sha256=vGVFsdMOp1iKaCQl5rfYcPVa0FV94d-a7MsMDQDhHMc,789
 iotdb/sqlalchemy/tests/__init__.py,sha256=vGVFsdMOp1iKaCQl5rfYcPVa0FV94d-a7MsMDQDhHMc,789
 iotdb/sqlalchemy/tests/test_dialect.py,sha256=MdrJXqVpwRznppYvqC3OfVUOjR0sbMU5ubpJacDxOAU,3083
-iotdb/template/InternalNode.py,sha256=jLFe_t4BG6Fq-ePD6u6_l8lox6syXDrXgH2S-xzDqiA,1417
-iotdb/template/MeasurementNode.py,sha256=bIBAXBFJqbmg4TOFMB8JbzuHTiBjRUew515kde2pWyM,2012
-iotdb/template/Template.py,sha256=p5ofgl0urb1eg6qfORR82ry5NbX_oeB8G9oLyvb1atk,3378
-iotdb/template/TemplateNode.py,sha256=CxsaJlt65FDayRETADzdDZhMYDybOO6iURDheDFCFAw,1285
+iotdb/template/MeasurementNode.py,sha256=O0-MVLN9a-Sap8uPriQxlmkh_NyUsiWGEoNQgmyBQ28,2315
+iotdb/template/Template.py,sha256=9zSaBsTwT_hWj-qf8Y_r9cIdd4WhdIrhxAl31Ejmo5E,3649
+iotdb/template/TemplateNode.py,sha256=6dR84yg7QV5A4nmGqws8cfV3GygfrR5HErQS5t2ORNw,1556
 iotdb/template/TemplateQueryType.py,sha256=6bNiydOiIqFnzutiuxdpWrOm-z9CkSawMCd_52EYh44,1272
 iotdb/template/__init__.py,sha256=vGVFsdMOp1iKaCQl5rfYcPVa0FV94d-a7MsMDQDhHMc,789
 iotdb/thrift/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 iotdb/thrift/common/__init__.py,sha256=YFcZTT8Cm-6Y4oTiCaqq0DT1lw2W09WqoEc5_pTAwW0,34
 iotdb/thrift/common/constants.py,sha256=IKRM8SpfhYWXERWBgUbUhbdFpn363hmZjXDhEYnVRbw,366
-iotdb/thrift/common/ttypes.py,sha256=EfE9QC6UmDoOZ42-mP6uLS-cISdt737cLE2cj0yOugM,75737
+iotdb/thrift/common/ttypes.py,sha256=5nQMSxiQ_-nYXFVdNz9Ojy42Qe8JxU_Gm4N90rJCuLg,114618
 iotdb/thrift/rpc/IClientRPCService.py,sha256=C9CZxONUf14jJgAjrgOXfxwK3rfwfVrnCDnucwpDkwI,416186
 iotdb/thrift/rpc/__init__.py,sha256=69gRO2XxQu71SDeCRxiZFjK6Xw_61hdl5MdWceI-e1A,55
 iotdb/thrift/rpc/constants.py,sha256=IKRM8SpfhYWXERWBgUbUhbdFpn363hmZjXDhEYnVRbw,366
@@ -34,33 +33,36 @@ iotdb/tsfile/__init__.py,sha256=vGVFsdMOp1iKaCQl5rfYcPVa0FV94d-a7MsMDQDhHMc,789
 iotdb/tsfile/common/__init__.py,sha256=vGVFsdMOp1iKaCQl5rfYcPVa0FV94d-a7MsMDQDhHMc,789
 iotdb/tsfile/common/constant/TsFileConstant.py,sha256=uLSw9vnQZ6objfyhO3b9bHTip8yUW5aapPHEsXC0e7s,1165
 iotdb/tsfile/common/constant/__init__.py,sha256=vGVFsdMOp1iKaCQl5rfYcPVa0FV94d-a7MsMDQDhHMc,789
+iotdb/tsfile/utils/DateUtils.py,sha256=Z31FexAA_pR72X2PDLT6pVJOFRWguIAEUjOyAwjipcI,1496
 iotdb/tsfile/utils/Pair.py,sha256=91ecijUAlEiMRLlH2hjRi_mT_xWp6Vm-R3n4Z4USFqQ,952
 iotdb/tsfile/utils/ReadWriteIOUtils.py,sha256=31CKH_1XWz8xc7DyInKaD-avkY-hVqNQILDb5PMucm4,2977
 iotdb/tsfile/utils/__init__.py,sha256=vGVFsdMOp1iKaCQl5rfYcPVa0FV94d-a7MsMDQDhHMc,789
 iotdb/utils/BitMap.py,sha256=dGvruuvDJlT4KH7pIrkprZWsY_AG-P8HXe6JHBKDOpI,1436
-iotdb/utils/Field.py,sha256=VcbEsTVCCzthTcXuZK5lSLH6FKe8SgOKidSDotbhY8s,5910
+iotdb/utils/Field.py,sha256=zc4oJBcib8BPnVpLTq_3sbPfmGRAO7SmQiWeuPgaiGc,7303
 iotdb/utils/IoTDBConnectionException.py,sha256=D38r5MicwIdVsliCwtipICjx19wbvRI4ye0doAX7DPM,1179
-iotdb/utils/IoTDBConstants.py,sha256=u3ZevIqqKlL4NVU5LDGoB0YiZfhsYqkdYWKXfAXU7Tw,1717
-iotdb/utils/IoTDBRpcDataSet.py,sha256=vKPuaXq-GL-jpeLQdaK2y__BQoeSvEu8sVv77op9Iuk,16482
-iotdb/utils/NumpyTablet.py,sha256=HBlYmjE4Ohy5fimWvP9iex7Xte7LybDPjOHmYnwwVrc,6210
-iotdb/utils/RowRecord.py,sha256=-dQRu5YsPoFyDbEpdJdt5Eo-CvGleba9CcCPc7Nm3Vw,1750
-iotdb/utils/SessionDataSet.py,sha256=MabD9x9eLi23ytRqLmdpjOW7efrei76HDJBUuzK2Sks,5157
-iotdb/utils/Tablet.py,sha256=4ADT4ZJYH9ijQM0OO7dcTMFWDh3oXIHG-Gl8OyQhkLQ,8169
+iotdb/utils/IoTDBConstants.py,sha256=mOXYQvaOccFS0cOUEqSXgZ3qSjhe6K8_sIjTT9S6qaI,1950
+iotdb/utils/IoTDBRpcDataSet.py,sha256=WItp7DSnDucBpkZ2b-qnlLV1eJqA985Gu5FBoxX1Yf4,18231
+iotdb/utils/NumpyTablet.py,sha256=VQiuRb2vJSVgqpzod4OocehXh7JdUNBGH-MTV4lzg0g,6919
+iotdb/utils/RowRecord.py,sha256=TIfQzMdi84GhGGIfVcZ-kvmm7aQwsDWge2kY00sf1lo,1690
+iotdb/utils/SessionDataSet.py,sha256=uS06ceDkhb8TocGM8MzdefofauoOrC4GWYi1TjWQS1w,5359
+iotdb/utils/Tablet.py,sha256=VM0Prem8xqLqV3YF9lbtGQ4N4pqQ1KvdbqrvczB6A2g,9035
 iotdb/utils/__init__.py,sha256=vGVFsdMOp1iKaCQl5rfYcPVa0FV94d-a7MsMDQDhHMc,789
 tests/__init__.py,sha256=vGVFsdMOp1iKaCQl5rfYcPVa0FV94d-a7MsMDQDhHMc,789
-tests/tablet_performance_comparison.py,sha256=cjWV-RGhp73JjzITyKwC7Abx5IRGg00cLrS3cH3BkOo,10724
-tests/test_aligned_timeseries.py,sha256=hig7q7UEBEdYiQnCmW2uOUiVopBW9_WpUBWE8sWP8lk,9906
-tests/test_dataframe.py,sha256=c3ATEbljj6NKFhbOOAFZX-WC4saoNUFNVfLfic9ogf8,2808
-tests/test_delete_data.py,sha256=vDDNWJ_WUZihLOMdwRMyS4r9F6nm-SalVSx1hPXrDlE,5121
-tests/test_numpy_tablet.py,sha256=w3lLK8Cft7lGsCj_6Z1Y7kDshltN0osSDJb-EESi6_Y,7235
-tests/test_one_device.py,sha256=QW6t8GfH4FnYxZODYztpHEt8m3NAC-AUcs18KKK4q0w,4734
-tests/test_session.py,sha256=aLhjUxZJ1IX2DBPuh3h7E4vfJs2jTnBa4dSIDgnMLIo,14343
-tests/test_session_pool.py,sha256=v4cbLLwob8JTG0vEV1zhr_YCHM7649JacBOg2Svcemo,3891
-tests/test_tablet.py,sha256=m0jLWJPQpy0K8sgOMS-91MaIL8QnwI3u4SWHjcEWbDI,4438
-tests/test_template.py,sha256=oN4vL6qvF89NG3vw_kj77RgH2DZVVizQX52AMBWOmCE,4021
-tests/test_todf.py,sha256=DPqapHpwjgits_y3OI3fU1mw7JHa8sUMg_-ViJ6NeYg,8071
-apache_iotdb-1.3.2.dist-info/METADATA,sha256=cqbP9uBdjETc3PFqZj88YKXf75kMsRqdxl3oPE-2lwI,21482
-apache_iotdb-1.3.2.dist-info/WHEEL,sha256=mguMlWGMX-VHnMpKOjjQidIo1ssRlCFu4a4mBpz1s2M,91
-apache_iotdb-1.3.2.dist-info/entry_points.txt,sha256=BmQWy6NHyWXorQcVm8-VWpt9MSqe46UFyV2hnsl4yok,73
-apache_iotdb-1.3.2.dist-info/top_level.txt,sha256=B9jGGOaAAqF1WrWw2jX2K-naWAZn2nhyrL-6hM1qwyM,12
-apache_iotdb-1.3.2.dist-info/RECORD,,
+tests/integration/__init__.py,sha256=vGVFsdMOp1iKaCQl5rfYcPVa0FV94d-a7MsMDQDhHMc,789
+tests/integration/tablet_performance_comparison.py,sha256=cjWV-RGhp73JjzITyKwC7Abx5IRGg00cLrS3cH3BkOo,10724
+tests/integration/test_aligned_timeseries.py,sha256=hig7q7UEBEdYiQnCmW2uOUiVopBW9_WpUBWE8sWP8lk,9906
+tests/integration/test_dataframe.py,sha256=c3ATEbljj6NKFhbOOAFZX-WC4saoNUFNVfLfic9ogf8,2808
+tests/integration/test_delete_data.py,sha256=vDDNWJ_WUZihLOMdwRMyS4r9F6nm-SalVSx1hPXrDlE,5121
+tests/integration/test_new_data_types.py,sha256=qi1VKybP9S-KNRpXlnzgKYGoMEdRUayrr_WiXy7IN4A,6367
+tests/integration/test_one_device.py,sha256=QW6t8GfH4FnYxZODYztpHEt8m3NAC-AUcs18KKK4q0w,4734
+tests/integration/test_session.py,sha256=aLhjUxZJ1IX2DBPuh3h7E4vfJs2jTnBa4dSIDgnMLIo,14343
+tests/integration/test_session_pool.py,sha256=v4cbLLwob8JTG0vEV1zhr_YCHM7649JacBOg2Svcemo,3891
+tests/integration/test_tablet.py,sha256=m0jLWJPQpy0K8sgOMS-91MaIL8QnwI3u4SWHjcEWbDI,4438
+tests/integration/test_todf.py,sha256=MlntH0pnz9xXx7CJMNlb5Dm3MijKh6tpcQrr7jYTM9Q,8128
+tests/unit/__init__.py,sha256=vGVFsdMOp1iKaCQl5rfYcPVa0FV94d-a7MsMDQDhHMc,789
+tests/unit/test_numpy_tablet.py,sha256=w3lLK8Cft7lGsCj_6Z1Y7kDshltN0osSDJb-EESi6_Y,7235
+apache_iotdb-1.3.3.dist-info/METADATA,sha256=jGvXUIJuiWmpou85Vif79DaggfC6AXjsYsRjAlW9Tt8,18771
+apache_iotdb-1.3.3.dist-info/WHEEL,sha256=R06PA3UVYHThwHvxuRWMqaGcr-PuniXahwjmQRFMEkY,91
+apache_iotdb-1.3.3.dist-info/entry_points.txt,sha256=BmQWy6NHyWXorQcVm8-VWpt9MSqe46UFyV2hnsl4yok,73
+apache_iotdb-1.3.3.dist-info/top_level.txt,sha256=B9jGGOaAAqF1WrWw2jX2K-naWAZn2nhyrL-6hM1qwyM,12
+apache_iotdb-1.3.3.dist-info/RECORD,,

{apache_iotdb-1.3.2.dist-info → apache_iotdb-1.3.3.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (70.1.1)
+Generator: setuptools (75.5.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

iotdb/Session.py

@@ -20,6 +20,7 @@ import logging
 import random
 import struct
 import time
+import warnings
 from thrift.protocol import TBinaryProtocol, TCompactProtocol
 from thrift.transport import TSocket, TTransport
 
@@ -57,9 +58,11 @@ from .thrift.rpc.ttypes import (
     TSLastDataQueryReq,
     TSInsertStringRecordsOfOneDeviceReq,
 )
+from .tsfile.utils.DateUtils import parse_date_to_int
 from .utils.IoTDBConnectionException import IoTDBConnectionException
 
 logger = logging.getLogger("IoTDB")
+warnings.simplefilter("always", DeprecationWarning)
 
 
 class Session(object):
@@ -1440,6 +1443,36 @@ class Session(object):
                 values_tobe_packed.append(b"\x05")
                 values_tobe_packed.append(len(value_bytes))
                 values_tobe_packed.append(value_bytes)
+            # TIMESTAMP
+            elif data_type == 8:
+                format_str_list.append("cq")
+                values_tobe_packed.append(b"\x08")
+                values_tobe_packed.append(value)
+            # DATE
+            elif data_type == 9:
+                format_str_list.append("ci")
+                values_tobe_packed.append(b"\x09")
+                values_tobe_packed.append(parse_date_to_int(value))
+            # BLOB
+            elif data_type == 10:
+                format_str_list.append("ci")
+                format_str_list.append(str(len(value)))
+                format_str_list.append("s")
+                values_tobe_packed.append(b"\x0a")
+                values_tobe_packed.append(len(value))
+                values_tobe_packed.append(value)
+            # STRING
+            elif data_type == 11:
+                if isinstance(value, str):
+                    value_bytes = bytes(value, "utf-8")
+                else:
+                    value_bytes = value
+                format_str_list.append("ci")
+                format_str_list.append(str(len(value_bytes)))
+                format_str_list.append("s")
+                values_tobe_packed.append(b"\x0b")
+                values_tobe_packed.append(len(value_bytes))
+                values_tobe_packed.append(value_bytes)
             else:
                 raise RuntimeError("Unsupported data type:" + str(data_type))
         format_str = "".join(format_str_list)
@@ -1810,6 +1843,11 @@ class Session(object):
         return request
 
     def create_schema_template(self, template: Template):
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         """
         create device template, users using this method should use the template class as an argument
         :param template: The template contains multiple child node(see Template.py)
@@ -1833,6 +1871,11 @@ class Session(object):
                 raise IoTDBConnectionException(self.connection_error_msg()) from None
 
     def drop_schema_template(self, template_name: str):
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         """
         drop device template, this method should be used to the template unset anything
         :param template_name: template name
@@ -1861,6 +1904,11 @@ class Session(object):
         compressors: list,
         is_aligned: bool = False,
     ):
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         """
         add measurements in the template, the template must already create. This function adds some measurements' node.
         :param template_name: template name, string list, like ["name_x", "name_y", "name_z"]
@@ -1895,6 +1943,11 @@ class Session(object):
                 raise IoTDBConnectionException(self.connection_error_msg()) from None
 
     def delete_node_in_template(self, template_name: str, path: str):
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         """
         delete a node in the template, this node must be already in the template
         :param template_name: template name
@@ -1916,6 +1969,11 @@ class Session(object):
                 raise IoTDBConnectionException(self.connection_error_msg()) from None
 
     def set_schema_template(self, template_name, prefix_path):
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         """
         set template in prefix path, template already exit, prefix path is not measurements
         :param template_name: template name
@@ -1937,6 +1995,11 @@ class Session(object):
                 raise IoTDBConnectionException(self.connection_error_msg()) from None
 
     def unset_schema_template(self, template_name, prefix_path):
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         """
         unset device template from prefix path, this method unsetting the template from entities,
         which have already inserted records using the template, is not supported.
@@ -1961,6 +2024,11 @@ class Session(object):
                 raise IoTDBConnectionException(self.connection_error_msg()) from None
 
     def count_measurements_in_template(self, template_name: str):
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         """
         drop device template, this method should be used to the template unset anything
         :param template_name: template name
@@ -1986,6 +2054,11 @@ class Session(object):
                 raise IoTDBConnectionException(self.connection_error_msg()) from None
 
     def is_measurement_in_template(self, template_name: str, path: str):
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         """
         judge the node in the template is measurement or not, this node must in the template
         :param template_name: template name
@@ -2014,6 +2087,11 @@ class Session(object):
                 raise IoTDBConnectionException(self.connection_error_msg()) from None
 
     def is_path_exist_in_template(self, template_name: str, path: str):
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         """
         judge whether the node is a measurement or not in the template, this node must be in the template
         :param template_name: template name
@@ -2039,6 +2117,11 @@ class Session(object):
                 raise IoTDBConnectionException(self.connection_error_msg()) from None
 
     def show_measurements_in_template(self, template_name: str, pattern: str = ""):
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         """
         show all measurements under the pattern in template
         :param template_name: template name
@@ -2067,6 +2150,11 @@ class Session(object):
                 raise IoTDBConnectionException(self.connection_error_msg()) from None
 
     def show_all_templates(self):
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         """
         show all device templates
         """
@@ -2092,6 +2180,11 @@ class Session(object):
                 raise IoTDBConnectionException(self.connection_error_msg()) from None
 
     def show_paths_template_set_on(self, template_name):
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         """
         show the path prefix where a device template is set
         :param template_name:
@@ -2116,6 +2209,11 @@ class Session(object):
                 raise IoTDBConnectionException(self.connection_error_msg()) from None
 
     def show_paths_template_using_on(self, template_name):
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         """
         show the path prefix where a device template is used
         :param template_name:

iotdb/template/MeasurementNode.py

@@ -15,13 +15,17 @@
 # specific language governing permissions and limitations
 # under the License.
 #
+import warnings
 
 from iotdb.utils.IoTDBConstants import TSDataType, TSEncoding, Compressor
 from .TemplateNode import TemplateNode
 from ..tsfile.utils.ReadWriteIOUtils import ReadWriteUtils
 
+warnings.simplefilter("always", DeprecationWarning)
+
 
 class MeasurementNode(TemplateNode):
+
     def __init__(
         self,
         name: str,
@@ -29,6 +33,12 @@ class MeasurementNode(TemplateNode):
         encoding: TSEncoding,
         compression_type: Compressor,
     ):
+        super().__init__(name)
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self.name = name
         self.data_type = data_type
         self.encoding = encoding

iotdb/template/Template.py

@@ -17,15 +17,23 @@
 #
 
 import struct
+import warnings
 
 from .TemplateNode import TemplateNode
 from ..tsfile.common.constant.TsFileConstant import TsFileConstant
 from ..tsfile.utils.Pair import Pair
 from ..tsfile.utils.ReadWriteIOUtils import ReadWriteUtils
 
+warnings.simplefilter("always", DeprecationWarning)
+
 
 class Template:
     def __init__(self, name, share_time: bool = False):
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self.name = name
         self.children = dict()
         self.share_time = share_time

iotdb/template/TemplateNode.py

@@ -15,6 +15,9 @@
 # specific language governing permissions and limitations
 # under the License.
 #
+import warnings
+
+warnings.simplefilter("always", DeprecationWarning)
 
 
 class TemplateNode(object):
@@ -23,6 +26,11 @@ class TemplateNode(object):
     """
 
     def __init__(self, name):
+        warnings.warn(
+            "The APIs about template are deprecated and will be removed in future versions. Use sql instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self.name = name
 
     def get_name(self):