Data tables and the Data table node (#3675)

docs/data/data-tables.md

@@ -0,0 +1,78 @@
+---
+title: Data tables
+description: Structured tabular data management for workflows within project boundaries
+contentType: overview
+tags:
+  - data tables
+hide:
+  - tags
+---
+
+# Data tables 
+
+## Overview
+
+Data tables integrate data storage within your n8n environment. Using data tables, you can save, manage, and interact with data directly inside your workflows without relying on external database systems for scenarios such as:
+
+- Storing data generated from workflow executions
+- Persisting data aross workflows in the same project
+- Storing markers to prevent duplicate runs or control workflow triggers
+- Reusing prompts or messages across workflows
+- Storing evaluation data for AI workflows
+- Combining data from different sources to enrich your datasets
+- Creating lookup tables as quick reference points within workflows
+
+## How to use data tables
+
+There are two parts to working with data tables: creating them and interacting with them in workflows.
+
+### Step 1: Creating a data table
+
+1. In your n8n project, select the **Data tables** tab.
+2. Click the split button located in the top right corner and select **Create Data table**.
+
+    ![Data table creation](/_images/data/data-tables/create-data-table.png)
+
+3. Enter a descriptive name for your table.
+   
+   In the table view that appears, you can:
+   
+   * add and reorder columns to organize your data
+   * Add, delete, and update rows
+   * edit existing data
+
+### Step 2: Interacting with Data tables in workflows
+
+Interact with data tables in your workflow using the **Data table** node, which allows you to retreive, update, and manipulate the data stored in a Data table.
+
+See [Data table node](/integrations/builtin/core-nodes/n8n-nodes-base.datatable/index.md).
+
+## Considerations and limitations of data tables
+
+- Data tables are suitable for light to moderate data storage. By default, a data table can't contain more than **50MB** of data. In self-hosted environments, you can increase this default size limit using the environment variable `N8N_DATA_TABLES_MAX_SIZE_BYTES`.
+- When a data table approaches **80%** of your storage limit, a warning will alert you. A final warning appears when you reach the storage limit. Exceeding this limit will disable manual additions to tables and cause workflow execution errors during attempts to insert or update data.
+- By default, data tables created within a project are accessible to all team members in that project.
+- Tables created in a **Personal** space are only accessible by their creator.
+
+## Data tables versus variables
+
+| Feature | Data tables | Variables |
+|---------|-------------|-----------|
+| Unified tabular view | ✓ | ✗ |
+| Row-column relationships | ✓ | ✗ |
+| Cross-project access | ✗ | ✓ |
+| Individual value display | ✗ | ✓ |
+| Optimized for short values | ✗ | ✓ |
+| Structured data | ✓ | ✗ |
+| Scoped to projects | ✓ | ✗ |
+| Use values as expressions | ✗ | ✓ |
+
+## Exporting and importing data
+
+To transfer data between n8n and external tools, use workflows that:
+
+1. Retrieve data from a data table.
+2. Export it using an API or file export.
+3. Import data into another system or data table accordingly.
+
+    ![Data export workflow](/_images/data/data-tables/data-table-export.png)

docs/integrations/builtin/core-nodes/n8n-nodes-base.datatable/index.md

@@ -0,0 +1,37 @@
+---
+title: Data table
+description: Documentation for the data table node in n8n, a workflow automation platform. Includes guidance on usage, and links to examples.
+contentType: [integration, reference]
+priority: critical
+tags:
+  - data table node
+  - data
+hide:
+  - tags
+search:
+  boost: 1.5
+---
+
+# Data table
+
+The Data Table node allows you to permanently save data across workflow executions in a table format. It provides functionality to perform various data operations on stored data.
+
+## Node parameters
+
+### Resource
+
+Select the resource on which you want to operate
+
+- Rows
+
+### Operations
+
+Select the operation you want to run on the resource:
+
+| Operation | Description | Options |
+|---|---|---|
+| **Get** | Get one or more rows from your table based on defined filters. | **Limit**: The number of rows you want to return, specified as a number. Default value is 50. |
+| **Update** | Update one or more rows. | |
+| **Insert** | Insert rows into an existing table. | **Optimize Bulk**: Optimize the speed of insertions when working with many rows. If you switch on this option, n8n won't return the data that was inserted. Default state is `off`. |
+| **Upsert** | Upsert one or more rows. If the row exists, it's updated; otherwise, a new row is created. | |
+| **Delete** | Delete one or more rows. | **Dry Run:** Simulate a deletion before finalizing it. If you switch on this option, n8n returns the rows that will be deleted by the operation. Default state is `off`. |

nav.yml

@@ -123,6 +123,7 @@ nav:
         - Data editing: data/data-editing.md
         - Data filtering: data/data-filtering.md
         - Data mocking: data/data-mocking.md
+        - Data tables: data/data-tables.md
         - Binary data: data/binary-data.md
         - Schema preview: data/schema-preview.md
       - Glossary: glossary.md
@@ -193,6 +194,7 @@ nav:
           - Common issues: integrations/builtin/core-nodes/n8n-nodes-langchain.chattrigger/common-issues.md
         - integrations/builtin/core-nodes/n8n-nodes-base.converttofile.md
         - integrations/builtin/core-nodes/n8n-nodes-base.crypto.md
+        - integrations/builtin/core-nodes/n8n-nodes-base.datatable/index.md
         - integrations/builtin/core-nodes/n8n-nodes-base.datetime.md
         - integrations/builtin/core-nodes/n8n-nodes-base.debughelper.md
         - integrations/builtin/core-nodes/n8n-nodes-base.set.md