Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 0 additions & 2 deletions src/pages/guides/app_builder_guides/storage/database.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
17 changes: 14 additions & 3 deletions src/pages/guides/app_builder_guides/storage/db-commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
14 changes: 11 additions & 3 deletions src/pages/guides/app_builder_guides/storage/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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)`. |
Expand All @@ -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

Expand Down
Loading