diff --git a/src/pages/guides/app_builder_guides/storage/database.md b/src/pages/guides/app_builder_guides/storage/database.md index 1642add48..83dfe5086 100644 --- a/src/pages/guides/app_builder_guides/storage/database.md +++ b/src/pages/guides/app_builder_guides/storage/database.md @@ -12,8 +12,6 @@ description: All the basics needed to start using Database Storage for App Build # Getting started with Database Storage -**IMPORTANT:** This documentation describes a product in early-access development and does not reflect all functionality intended for general availability (GA). It cannot be used in production until GA. - Database Storage for App Builder provides document-style database persistence for AIO Runtime Actions. The [`aio-lib-db` library](https://github.com/adobe/aio-lib-db), which is closely modeled on the MongoDB Database Driver for NodeJS, provides the primary programming interface, while the DB Plugin in the AIO CLI provides additional access. There is a strict one-to-one relationship between an AIO project workspace and a workspace database, and each workspace database is entirely isolated from all other workspace databases. diff --git a/src/pages/guides/app_builder_guides/storage/db-commands.md b/src/pages/guides/app_builder_guides/storage/db-commands.md index d459cd66e..e5fb88e74 100644 --- a/src/pages/guides/app_builder_guides/storage/db-commands.md +++ b/src/pages/guides/app_builder_guides/storage/db-commands.md @@ -18,11 +18,22 @@ The following is only a brief introduction to the DB Plugin. For more thorough d ## Installation -To install the early access plugin for the AIO CLI: +If you installed the early access versions of the plugins, you must uninstall them before updating `@adobe/aio-cli`: ```bash -aio plugins:install @adobe/aio-cli-plugin-app@next -aio plugins:install @adobe/aio-cli-plugin-app-storage@next +aio plugins:uninstall @adobe/aio-cli-plugin-app +aio plugins:uninstall @adobe/aio-cli-plugin-app-storage +``` + +The DB plugin for the AIO CLI requires the following: + +- `@adobe/aio-cli-plugin-app` version 14.7.0 or higher +- `@adobe/aio-cli-plugin-app-storage` version 1.5.0 or higher. + +These are installed automatically by updating `@adobe/aio-cli` to the latest version: + +```bash +npm install -g @adobe/aio-cli ``` ## Region selection diff --git a/src/pages/guides/app_builder_guides/storage/index.md b/src/pages/guides/app_builder_guides/storage/index.md index e92868860..e7a55edac 100644 --- a/src/pages/guides/app_builder_guides/storage/index.md +++ b/src/pages/guides/app_builder_guides/storage/index.md @@ -9,8 +9,6 @@ title: Storage Options # Storage Options -**IMPORTANT:** This documentation describes a product in early-access development and does not reflect all functionality intended for general availability (GA). It cannot be used in production until GA. - As part of App Builder, you have access to three storage services for persisting data dynamically from your Runtime actions: **Database**, **Files**, and **State**. Each service is designed for different use cases, with distinct benefits and trade-offs. ## Quick comparison @@ -34,6 +32,8 @@ The following quotas and limits apply while dealing with Persistent Storage asso Quotas are shared across the organization. Workspace limits are defined at the *workspace* level. The Database and State services may return 429 (rate-limits) or 403 (storage limits) errors if limits are exceeded. +### State storage limits + | Limit | Limit Type | Default Limit | Can it be Increased? | Notes | |-----------------------------------------------------------------------------------------|----------------------------------------|-----------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------| | How much data can you store in State? | Quota (increases with number of packs) | Up to 10 GB per App Builder pack | Yes, by purchasing more packs of App Builder | Storage is calculated as: `(2 * total size of keys) + (total size of values)`. | @@ -43,9 +43,17 @@ Quotas are shared across the organization. Workspace limits are defined at the * | How fast can you increase your bandwidth consumption in a single App Builder workspace? | Workspace limit (fixed per workspace) | 100 KB/s per minute | No | - | | How many keys can you store in State in a single App Builder workspace? | Workspace limit (fixed per workspace) | 200K | Yes, by raising a support ticket. You can request an increase up to 500K keys. | This limit does not scale with the number of App Builder packs purchased. | | How many list operations can you run per minute in a single App Builder workspace? | Workspace limit (fixed per workspace) | 1K/min | Yes, by raising a support ticket. You can request an increase up to 10K/min. | This limit does not scale with the number of App Builder packs purchased. | + +### Database storage limits + +| Limit | Limit Type | Default Limit | Can it be Increased? | Notes | +|-----------------------------------------------------------------------------------------|----------------------------------------|-----------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------| | How much data can you store in the Database Service? | Quota (increases with number of packs) | Up to 40 GB per App Builder pack | Yes, by purchasing more packs of App Builder | Includes storage used for both data and indexes. | -| How much Database bandwidth can you utilize? | Quota (increases with number of packs) | Up to 10 TB per App Builder pack | Yes, by purchasing more packs of App Builder | Includes both uploaded and downloaded traffic. | +| How much Database bandwidth can you utilize? | Quota (increases with number of packs) | Up to 10 TB per month per App Builder pack | Yes, by purchasing more packs of App Builder | Includes both uploaded and downloaded traffic. | | How many Database collections (tables) can you create? | Hard Limit | 1,000 | No | Enforced to ensure service reliability and performance. | +| How many Database requests can you make per minute in a single App Builder workspace? | Workspace limit (fixed per workspace) | 20,000 requests/min | No | | +| How much Database burst bandwidth can you consume per minute in a single App Builder workspace? | Workspace limit (fixed per workspace) | 500 MB/min | Yes, by raising a support ticket. | | +How much Database burst bandwidth can you consume per second in a single App Builder workspace? | Workspace limit (fixed per workspace) | 100 MB/sec | Yes, by raising a support ticket. | | ## State