DocumentDB安装与配置指南

DocumentDB安装与配置指南

documentdb DocumentDB offers a native implementation of document-oriented NoSQL database, enabling seamless CRUD operations on BSON data types within a PostgreSQL framework. Powering vCore-based Azure Cosmos DB for MongoDB. 项目地址: https://gitcode.com/gh_mirrors/do/documentdb

1. 项目基础介绍

DocumentDB 是微软开源的文档型NoSQL数据库引擎，它是基于 PostgreSQL 的，支持 BSON 数据类型的操作。DocumentDB 提供了在 PostgreSQL 框架下对文档数据进行 CRUD 操作的 native 支持，并且可以进行全文搜索、地理空间查询等复杂操作。

主要编程语言：C、Python

2. 项目使用的关键技术和框架

关键技术：

• PostgreSQL：强大的开源对象关系型数据库系统。
• BSON：Binary JSON，一种二进制形式的 JSON 数据格式，用于存储 semi-structured data。
• Docker：容器技术，用于简化部署和运行环境。

框架：

• PostgreSQL 扩展：用于支持 BSON 数据类型和操作。
• DocumentDB API：提供对文档存储的 CRUD 功能。

3. 安装和配置准备工作及详细步骤

准备工作

• 确保系统中已安装 Docker。
• 准备一个 PostgreSQL 环境。

安装步骤

步骤 1：克隆项目仓库

打开终端（或命令提示符），执行以下命令克隆仓库：

git clone https://github.com/microsoft/documentdb.git

步骤 2：构建 Docker 镜像

切换到克隆的仓库目录下，构建 Docker 镜像：

docker build -f .devcontainer/Dockerfile -t documentdb

构建完成后，可以通过以下命令验证镜像是否创建成功：

docker image ls

步骤 3：运行 Docker 容器

运行以下命令来启动容器：

docker run -v $(pwd):/home/documentdb/code -it documentdb /bin/bash

在容器中，切换到代码目录：

cd /home/documentdb/code

步骤 4：编译安装

在容器内部，执行以下命令进行编译：

make

如果编译失败，可能需要在容器内部设置 safe.directory：

git config --global --add safe.directory /home/documentdb/code

编译成功后，执行以下命令安装：

sudo make install

步骤 5：运行后端 PostgreSQL 测试（可选）

安装完成后，可以运行测试来验证安装是否成功：

make check

步骤 6：启动 DocumentDB 服务器

退出容器，回到主机上，运行以下命令启动 DocumentDB 服务器：

./scripts/start_oss_server.sh

步骤 7：连接到服务器

启动服务器后，使用以下命令连接到 psql shell：

psql -p 9712 -d postgres

以上就是 DocumentDB 的详细安装与配置指南，按照上述步骤操作后，你就可以开始使用 DocumentDB 进行开发了。

documentdb DocumentDB offers a native implementation of document-oriented NoSQL database, enabling seamless CRUD operations on BSON data types within a PostgreSQL framework. Powering vCore-based Azure Cosmos DB for MongoDB. 项目地址: https://gitcode.com/gh_mirrors/do/documentdb