Merge pull request #701 from Avaiga/fix/core#816-sqldatanote-example-…

…not-work

Fix/Core#816 - Update SQLDataNode example to run successfully

docs/manuals/core/config/advanced-config.md

@@ -120,11 +120,10 @@ the default configuration applies if some values are not provided.
         import pandas as pd
 
         def write_orders_plan(data: pd.DataFrame):
-            insert_data = list(
-                data[["date", "product_id", "number_of_products"]].itertuples(index=False, name=None))
+            insert_data = data[["date", "product_id", "number_of_products"]].to_dict("records")
             return [
                 "DELETE FROM orders",
-                ("INSERT INTO orders VALUES (?, ?, ?)", insert_data)
+                ("INSERT INTO orders VALUES (:date, :product_id, :number_of_products)", insert_data)
             ]
 
         def train(sales_history: pd.DataFrame):

docs/manuals/core/config/code_example/data_node_cfg/data-node-config_sql_with_mssql_engine.py

@@ -2,11 +2,10 @@
 import pandas as pd
 
 def write_query_builder(data: pd.DataFrame):
-    insert_data = list(
-        data[["date", "nb_sales"]].itertuples(index=False, name=None))
+    insert_data = data[["date", "nb_sales"]].to_dict("records")
     return [
         "DELETE FROM sales",
-        ("INSERT INTO sales VALUES (?, ?)", insert_data)
+        ("INSERT INTO sales VALUES (:date, :nb_sales)", insert_data)
     ]
 
 sales_history_cfg = Config.configure_sql_data_node(

docs/manuals/core/config/code_example/data_node_cfg/data-node-config_sql_with_sqlite_engine.py

@@ -2,14 +2,13 @@
 import pandas as pd
 
 def write_query_builder(data: pd.DataFrame):
-    insert_data = list(
-        data[["date", "nb_sales"]].itertuples(index=False, name=None))
+    insert_data = data[["date", "nb_sales"]].to_dict("records")
     return [
         "DELETE FROM sales",
-        ("INSERT INTO sales VALUES (?, ?)", insert_data)
+        ("INSERT INTO sales VALUES (:date, :nb_sales)", insert_data)
     ]
 
-sales_history_cfg = Config.configure_sql_table_data_node(
+sales_history_cfg = Config.configure_sql_data_node(
     id="sales_history",
     db_name="taipy",
     db_engine="sqlite",

docs/manuals/core/entities/code_example/my_config.py

@@ -6,8 +6,8 @@
 
 
 def write_orders_plan(data: pd.DataFrame):
-    insert_data = list(data[["date", "product_id", "number_of_products"]].itertuples(index=False, name=None))
-    return ["DELETE FROM orders", ("INSERT INTO orders VALUES (?, ?, ?)", insert_data)]
+    insert_data = data[["date", "product_id", "number_of_products"]].to_dict("records")
+    return ["DELETE FROM orders", ("INSERT INTO orders VALUES (:date, :product_id, :number_of_products)", insert_data)]
 
 
 def train(sales_history: pd.DataFrame):

docs/manuals/core/entities/data-node-mgt.md

@@ -763,9 +763,9 @@ execute a list of queries returned by the query builder:
     ```python
     data = pandas.DataFrame(
         [
-            {"date": "01/08/2019", "product_id": 1 "number_of_products": 450},
-            {"date": "01/08/2019", "product_id": 3 "number_of_products": 320},
-            {"date": "01/08/2019", "product_id": 4 "number_of_products": 350},
+            {"date": "01/08/2019", "product_id": 1, "number_of_products": 450},
+            {"date": "01/08/2019", "product_id": 3, "number_of_products": 320},
+            {"date": "01/08/2019", "product_id": 4, "number_of_products": 350},
         ]
     )
 

docs/manuals/core/scheduling/code_example/my_config.py

@@ -6,8 +6,8 @@
 
 
 def write_orders_plan(data: pd.DataFrame):
-    insert_data = list(data[["date", "product_id", "number_of_products"]].itertuples(index=False, name=None))
-    return ["DELETE FROM orders", ("INSERT INTO orders VALUES (?, ?, ?)", insert_data)]
+    insert_data = data[["date", "product_id", "number_of_products"]].to_dict("records")
+    return ["DELETE FROM orders", ("INSERT INTO orders VALUES (:date, :product_id, :number_of_products)", insert_data)]
 
 
 def train(sales_history: pd.DataFrame):

docs/relnotes.md

@@ -33,6 +33,12 @@ This is the list of changes to Taipy releases as they were published.
 
 ## Significant bug fixes
 
+<h4><strong><code>taipy-core</code></strong> 3.1.0 </h4>
+
+- Can not write to a SQLDataNode or a SQLTableDataNode using examples provided by the
+    documentation.<br/>
+    See [issue #816](https://github.com/Avaiga/taipy-core/issues/816).
+
 
 # Community edition: 3.0