From 12f0f210a1fc1273eeb71d2a8b178f192717861a Mon Sep 17 00:00:00 2001 From: idanlib-wix Date: Sun, 28 Jul 2024 17:56:46 +0300 Subject: [PATCH] add request timeout info to wix data api --- .../Items/guides/data-items-1-intro.md | 25 ++++++++++--------- 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/wix-data-v2/wix-data-v2/Items/guides/data-items-1-intro.md b/wix-data-v2/wix-data-v2/Items/guides/data-items-1-intro.md index 6af563e776..c66120ae9b 100644 --- a/wix-data-v2/wix-data-v2/Items/guides/data-items-1-intro.md +++ b/wix-data-v2/wix-data-v2/Items/guides/data-items-1-intro.md @@ -18,11 +18,11 @@ The Data Items API allows you to access and manage items in a Wix site's data co With the Data Items API, you can: -+ Create and manage data items in a site's collections. -+ Retrieve data items from a collection individually or with filtering and sorting queries. -+ Create and manage reference fields. -+ Perform aggregations and calculations on data in collections. -+ Truncate a data collection, removing all its contents. +- Create and manage data items in a site's collections. +- Retrieve data items from a collection individually or with filtering and sorting queries. +- Create and manage reference fields. +- Perform aggregations and calculations on data in collections. +- Truncate a data collection, removing all its contents. The Data Items API only works with existing collections. To create and manage data collections, use the [Data Collections API](https://www.wix.com/velo/reference/wix-data-v2/collections). @@ -30,10 +30,11 @@ The Data Items API only works with existing collections. To create and manage da It's important to note the following points before starting to code: -+ The maximum size of an item you can save to a collection is 500 kb. -+ We don't recommend updating a data item more than once per second. -+ When using data retrieval functions such as [`queryDataItems()`](https://www.wix.com/velo/reference/wix-data-v2/items/querydataitems) or [`getDataItem()`](https://www.wix.com/velo/reference/wix-data-v2/items/getdataitem) following an update to a collection's data, the data retrieved may not yet contain the most recent changes. See [Wix Data and Eventual Consistency](https://www.wix.com/velo/reference/wix-data-v2/eventual-consistency) for more information and instructions for overriding this. -+ When querying Wix App Collections, check which fields can be filtered in the relevant collection field article. -+ Updating a data item replaces the existing item entirely. If the existing item had fields with values and those fields aren't included in the updated item, the values in those properties are lost. -+ Aggregations can't be performed on Wix App collections. -+ After connecting external database collections to a Wix site using the [External Database Connections API](https://www.wix.com/velo/reference/wix-data-v2/externaldatabaseconnections), you can use the Data Items API to manage and retrieve data from those collections as if they were Wix Data collections. +- The maximum size of an item you can save to a collection is 500 kb. +- We don't recommend updating a data item more than once per second. +- When using data retrieval functions such as [`queryDataItems()`](https://www.wix.com/velo/reference/wix-data-v2/items/querydataitems) or [`getDataItem()`](https://www.wix.com/velo/reference/wix-data-v2/items/getdataitem) following an update to a collection's data, the data retrieved may not yet contain the most recent changes. See [Wix Data and Eventual Consistency](https://www.wix.com/velo/reference/wix-data-v2/eventual-consistency) for more information and instructions for overriding this. +- When your site makes a data request, it may take some time to receive a response. Wix Data places limits on how long a response can take before the [request times out](https://dev.wix.com/docs/develop-websites/articles/databases/wix-data/data-api/working-with-wix-data#request-timeouts). If the response time exceeds this limit, Wix Data returns an error instead of the intended result. +- When querying Wix App Collections, check which fields can be filtered in the relevant collection field article. +- Updating a data item replaces the existing item entirely. If the existing item had fields with values and those fields aren't included in the updated item, the values in those properties are lost. +- Aggregations can't be performed on Wix App collections. +- After connecting external database collections to a Wix site using the [External Database Connections API](https://www.wix.com/velo/reference/wix-data-v2/externaldatabaseconnections), you can use the Data Items API to manage and retrieve data from those collections as if they were Wix Data collections.