# @adobe/aio-cli-plugin-app-storage 中文文档 规范地址：https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/ 版本：1\.6\.1 npm 元数据更新时间：2026-10-01T01:32:05.776Z 中文译文更新时间：2026-11-05T20:58:59.766Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40adobe/aio-cli-plugin-app-storage 原文对照：https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/?lang=original ## 关键信息（来自 npm 元数据） - 包体积（解压后）：206 kB，40 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=20\.0\.0 - 运行依赖：13 个 - 首次发布：2024-08-19T09:37:40.472Z - 最新版本发布：2026-05-08T04:36:25.847Z - 近 30 天下载量：22489（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：13（近 12 个月 8 个） ## 中文简介 管理您的 App 构建器状态存储和数据库服务的 CLI 插件 . ## 安装 ```sh npm install @adobe/aio-cli-plugin-app-storage ``` 也可以使用：`pnpm add @adobe/aio-cli-plugin-app-storage`、`yarn add @adobe/aio-cli-plugin-app-storage`、`bun add @adobe/aio-cli-plugin-app-storage` ## README # aio-cli-plugin-app-存储器 管理您的 App 构建器状态存储和数据库服务的 CLI 插件 . 如果您需要通过程序访问国家,请检查 [@adobe/aio-lib-状态](https://github.com/adobe/aio-lib-state) 图书馆. 如果您需要程序访问数据库, 请检查 [@adobe/aio-lib-db](https://github.com/adobe/aio-lib-db) 图书馆. * * * - [aio-cli-plugin-app-存储器](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-cli-plugin-app-storage) - [使用量](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-usage) - [图标](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-commands) # 使用量 ```sh-session $ aio plugins:install @adobe/aio-cli-plugin-app-storage $ # OR $ aio discover -i $ aio app state --help $ aio app db --help ``` # 图标 - [`aio app add db`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-add-db) - [`aio app db collection create COLLECTION`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-collection-create-collection) - [`aio app db collection drop COLLECTION`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-collection-drop-collection) - [`aio app db collection list`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-collection-list) - [`aio app db collection rename CURRENTNAME NEWNAME`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-collection-rename-currentname-newname) - [`aio app db collection stats COLLECTION`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-collection-stats-collection) - [`aio app db delete`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-delete) - [`aio app db document count COLLECTION [QUERY]`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-document-count-collection-query) - [`aio app db document delete COLLECTION FILTER`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-document-delete-collection-filter) - [`aio app db document find COLLECTION FILTER`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-document-find-collection-filter) - [`aio app db document insert COLLECTION DOCUMENTS`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-document-insert-collection-documents) - [`aio app db document replace COLLECTION FILTER REPLACEMENT`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-document-replace-collection-filter-replacement) - [`aio app db document update COLLECTION FILTER UPDATE`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-document-update-collection-filter-update) - [`aio app db index create COLLECTION`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-index-create-collection) - [`aio app db index drop COLLECTION INDEXNAME`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-index-drop-collection-indexname) - [`aio app db index list COLLECTION`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-index-list-collection) - [`aio app db org stats`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-org-stats) - [`aio app db ping`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-ping) - [`aio app db provision`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-provision) - [`aio app db stats`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-stats) - [`aio app db status`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-db-status) - [`aio app state delete [KEYS]`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-state-delete-keys) - [`aio app state get KEY`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-state-get-key) - [`aio app state list`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-state-list) - [`aio app state put KEY VALUE`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-state-put-key-value) - [`aio app state stats`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-app-state-stats) - [`aio help [COMMAND]`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-storage/#readme-aio-help-command) ## `aio app add db` 为您的 App 构建程序提供新数据库 ``` USAGE $ aio app add db [--json] [--region ] [-y] FLAGS -y, --yes Skip confirmation prompt and provision automatically GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Provision a new database for your App Builder application EXAMPLES $ aio app add db $ aio app add db --region amer $ aio app add db --json $ aio app add db --yes ``` ## `aio app db collection create COLLECTION` 在数据库中创建新收藏 ``` USAGE $ aio app db collection create COLLECTION [--json] [--region ] [-v ] ARGUMENTS COLLECTION The name of the collection to create FLAGS -v, --validator= JSON schema validator for document validation (JSON string) GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Create a new collection in the database ALIASES $ aio app db col create EXAMPLES $ aio app db collection create users $ aio app db collection create inventory --validator '{"type": "object", "required": ["id", "quantity"]}' --json $ aio app db col create products --json $ aio app db col create products --validator '{"type": "object", "properties": {"name": {"type": "string"}, "price": {"type": "number", "minimum": 0}}, "required": ["name", "price"]}' ``` ## `aio app db collection drop COLLECTION` 从数据库中丢弃收藏 ``` USAGE $ aio app db collection drop COLLECTION [--json] [--region ] ARGUMENTS COLLECTION The name of the collection to drop GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Drop a collection from the database ALIASES $ aio app db col drop EXAMPLES $ aio app db collection drop users $ aio app db collection drop products --json $ aio app db col drop inventory ``` ## `aio app db collection list` 在您的 App 构建器数据库中获取收藏列表 ``` USAGE $ aio app db collection list [--json] [--region ] [-i] FLAGS -i, --info Show detailed collection information instead of just names GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Get the list of collections in your App Builder database ALIASES $ aio app db col list $ aio app db show collections EXAMPLES $ aio app db collection list $ aio app db collection list --info $ aio app db collection list --json $ aio app db col list --info --json ``` ## `aio app db collection rename CURRENTNAME NEWNAME` 重命名数据库中的收藏 ``` USAGE $ aio app db collection rename CURRENTNAME NEWNAME [--json] [--region ] ARGUMENTS CURRENTNAME The current name of the collection to rename NEWNAME The new name for the collection GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Rename a collection in the database ALIASES $ aio app db col rename EXAMPLES $ aio app db collection rename users customers $ aio app db collection rename old_products new_products --json $ aio app db col rename inventory stock ``` ## `aio app db collection stats COLLECTION` 获取数据库收藏的统计数据 ``` USAGE $ aio app db collection stats COLLECTION [--json] [--region ] ARGUMENTS COLLECTION The name of the collection to get stats for GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Get statistics for a collection in the database ALIASES $ aio app db col stats EXAMPLES $ aio app db collection stats users $ aio app db collection stats products --json $ aio app db col stats inventory ``` ## `aio app db delete` 删除您的 App 构建器应用程序的数据库( 不只生产) ``` USAGE $ aio app db delete [--json] [--region ] [--force] FLAGS --force [use with caution!] force delete, skips confirmation safety prompt GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Delete the database for your App Builder application (non-production only) EXAMPLES $ aio app db delete $ aio app db delete --force $ aio app db delete --json ``` ## `aio app db document count COLLECTION [QUERY]` 计算收藏中的文档 ``` USAGE $ aio app db document count COLLECTION [QUERY] [--json] [--region ] ARGUMENTS COLLECTION The name of the collection [QUERY] The query filter document (JSON string). If not provided, counts all documents. GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Count documents in a collection ALIASES $ aio app db doc count EXAMPLES $ aio app db document countDocuments users $ aio app db document countDocuments users '{"age": {"$gte": 21}}' $ aio app db document countDocuments products '{"category": "electronics"}' --json $ aio app db doc count orders '{"status": "shipped"}' ``` ## `aio app db document delete COLLECTION FILTER` 从收藏中删除单个文档 ``` USAGE $ aio app db document delete COLLECTION FILTER [--json] [--region ] ARGUMENTS COLLECTION The name of the collection FILTER The filter document (JSON string) GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Delete a single document from a collection ALIASES $ aio app db doc delete EXAMPLES $ aio app db document delete users '{"name": "John"}' $ aio app db document delete products '{"id": "123"}' --json $ aio app db doc delete posts '{"status": "draft"}' ``` ## `aio app db document find COLLECTION FILTER` 在一个基于过滤标准的集合中查找文档. ``` USAGE $ aio app db document find COLLECTION FILTER [--json] [--region ] [-l ] [-s ] [-o ] [-p ] ARGUMENTS COLLECTION The name of the collection FILTER Filter criteria for the documents to find (JSON string, e.g. '{"status": "active"}') FLAGS -l, --limit= [default: 20] Limit the number of documents returned, max: 100 -o, --sort= Sort specification as a JSON object (e.g. '{"field": 1}') -p, --projection= Projection specification as a JSON object (e.g. '{"field1": 1, "field2": 0}') -s, --skip= Skip the first N documents GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Find documents in a collection based on filter criteria. ALIASES $ aio app db doc find EXAMPLES $ aio app db document find users '{}' $ aio app db document find products '{"category": "Computer Accessories"}' --json $ aio app db document find products '{"name": {"$regex": "Speakers$"}}' --sort '{"price": -1}' --limit 10 --skip 5 --projection '{"name": 1, "price": 1}' $ aio app db doc find orders '{"status": "pending"}' --sort '{"orderDate": -1}' ``` ## `aio app db document insert COLLECTION DOCUMENTS` 在收藏中插入一个或多个文档 ``` USAGE $ aio app db document insert COLLECTION DOCUMENTS [--json] [--region ] [-b] ARGUMENTS COLLECTION The name of the collection to insert documents into DOCUMENTS JSON object or array of documents to insert FLAGS -b, --bypassDocumentValidation Bypass schema validation if present GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Insert one or more documents into a collection ALIASES $ aio app db doc insert EXAMPLES $ aio app db document insert users '{"name": "John", "age": 30}' $ aio app db document insert products '[{"id": 1, "name": "Product A"}, {"id": 2, "name": "Product B"}]' --json $ aio app db document insert temp '{"data": "test"}' --bypassDocumentValidation $ aio app db doc insert bulk '[{"field": "foo"}, {"field": "bar"}]' --bypassDocumentValidation --json ``` ## `aio app db document replace COLLECTION FILTER REPLACEMENT` 在收藏中替换单个文档 ``` USAGE $ aio app db document replace COLLECTION FILTER REPLACEMENT [--json] [--region ] [-u] ARGUMENTS COLLECTION The name of the collection FILTER The filter document (JSON string) REPLACEMENT The replacement document (JSON string) FLAGS -u, --upsert If no document is found, create a new one GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Replace a single document in a collection ALIASES $ aio app db doc replace EXAMPLES $ aio app db document replace users '{"name": "John"}' '{"name": "John Doe", "age": 30, "status": "active"}' $ aio app db document replace products '{"id": "123"}' '{"id": "123", "name": "New Product", "price": 99.99}' --json $ aio app db document replace posts '{"slug": "hello-world"}' '{"title": "Hello World", "content": "Updated content", "status": "published"}' --upsert $ aio app db doc replace users '{"email": "john@example.com"}' '{"email": "john@example.com", "name": "John", "verified": true}' --upsert --json ``` ## `aio app db document update COLLECTION FILTER UPDATE` 更新收藏中的文档 ``` USAGE $ aio app db document update COLLECTION FILTER UPDATE [--json] [--region ] [-u] [-m] ARGUMENTS COLLECTION The name of the collection FILTER The filter document (JSON string) UPDATE The update document (JSON string) FLAGS -m, --many Update all documents matching the filter. Without this option, only the first matching document is updated. -u, --upsert If no document is found, create a new one GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Update document(s) in a collection ALIASES $ aio app db doc update EXAMPLES $ aio app db document update users '{"name": "John"}' '{"$set": {"age": 31}}' $ aio app db document update products '{"id": "123"}' '{"$inc": {"stock": -1}}' --json $ aio app db document update posts '{"slug": "hello-world"}' '{"$set": {"status": "published"}}' --many $ aio app db doc update users '{"email": "john@example.com"}' '{"$set": {"lastLogin": "2024-01-01"}}' --upsert ``` ## `aio app db index create COLLECTION` 在数据库中的收藏上创建新索引 ``` USAGE $ aio app db index create COLLECTION [--json] [--region ] [-s ...] [-k ...] [-n ] [-u] ARGUMENTS COLLECTION The name of the collection to create the index on FLAGS -n, --name= A name that uniquely identifies the index -u, --unique Creates a unique index so that the collection will not accept insertion or update of documents where the index key value matches an existing value in the index REQUIRES AT LEAST ONE OF THE INDEX DEFINITION FLAGS -k, --key=... Index key to use with default specification -s, --spec=... Index specification as a JSON object (e.g., '{"name":1, "age":-1}') GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Create a new index on a collection in the database ALIASES $ aio app db idx create EXAMPLES $ aio app db index create users --spec '{"name":1, "age":-1}' $ aio app db index create users -s '{"name":1, "age":-1}' --name "name_age_index" $ aio app db index create students -s '{"name":1}' --key grade --unique $ aio app db index create reviews -k sku -k rating $ aio app db index create products -s '{"name":"text", "category":"text"}' --json $ aio app db index create books -s '{"author":1}' -k year $ aio app db idx create orders --spec '{"customerId":1}' --spec '{"orderDate":-1}' --name "customer_order_index" --unique ``` ## `aio app db index drop COLLECTION INDEXNAME` 从数据库中的收藏中丢出索引 ``` USAGE $ aio app db index drop COLLECTION INDEXNAME [--json] [--region ] ARGUMENTS COLLECTION The name of the collection to drop the index from INDEXNAME The name of the index to drop GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Drop an index from a collection in the database ALIASES $ aio app db idx drop EXAMPLES $ aio app db index drop users name_age_index $ aio app db index drop products category_1 --json $ aio app db idx drop orders orderDate_index ``` ## `aio app db index list COLLECTION` 从数据库的收藏中获取索引列表 ``` USAGE $ aio app db index list COLLECTION [--json] [--region ] ARGUMENTS COLLECTION The name of the collection to retrieve indexes from GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Get the list of indexes from a collection in the database ALIASES $ aio app db idx list EXAMPLES $ aio app db index list users $ aio app db index list products --json $ aio app db idx list orders ``` ## `aio app db org stats` 获取您组织的 App 构建器数据库的综合统计数据 ``` USAGE $ aio app db org stats [--json] [--region ] [-s ] FLAGS -s, --scale= [default: 1] Scale factor for size-related statistics (e.g. 1024 for KB, 1048576 for MB). GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Get combined statistics about the App Builder databases in your organization EXAMPLES $ aio app db org stats $ aio app db org stats --scale 1024 $ aio app db org stats --json ``` ## `aio app db ping` 测试您的 App 构建器数据库的连接 ``` USAGE $ aio app db ping [--json] [--region ] GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Test connectivity to your App Builder database EXAMPLES $ aio app db ping $ aio app db ping --json ``` ## `aio app db provision` 为您的 App 构建程序提供新数据库 ``` USAGE $ aio app db provision [--json] [--region ] [-y] FLAGS -y, --yes Skip confirmation prompt and provision automatically GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Provision a new database for your App Builder application EXAMPLES $ aio app db provision $ aio app db provision --region amer $ aio app db provision --json $ aio app db provision --yes ``` ## `aio app db stats` 获取关于您的 App 构建器数据库的统计数据 ``` USAGE $ aio app db stats [--json] [--region ] [-s ] FLAGS -s, --scale= [default: 1] Scale factor for size-related statistics (e.g. 1024 for KB, 1048576 for MB). GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Get statistics about your App Builder database EXAMPLES $ aio app db stats $ aio app db stats --scale 1024 $ aio app db stats --json ``` ## `aio app db status` 检查您的 App 构建器数据库的提供状态 ``` USAGE $ aio app db status [--json] [--region ] [--watch] FLAGS --watch Watch for status changes (press Ctrl+C to stop) GLOBAL FLAGS --json Format output as json. --region= Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any database region set in 'app.config.yaml' takes precedence over all of these. DESCRIPTION Check the provisioning status of your App Builder database EXAMPLES $ aio app db status $ aio app db status --watch $ aio app db status --json ``` ## `aio app state delete [KEYS]` 删除密钥值 ``` USAGE $ aio app state delete [KEYS...] [--json] [--region amer|emea|apac|aus] [--match ] [--force] ARGUMENTS [KEYS...] keys to delete. Above 5 keys, you will be prompted for confirmation FLAGS --force [use with caution!] force delete, no safety prompt --match= [use with caution!] deletes ALL key-values matching the provided glob-like pattern --region=