文档型数据库 SequoiaDB_MongoDB 国产化替换首选

CSharp 开发环境搭建

本文档主要介绍如何获取驱动开发包和配置开发环境。获取驱动开发包用户可以从 SequoiaDB 巨杉数据库官网下载对应操作系统版本的 SequoiaDB 驱动开发包。配置开发环境解压下载的驱动开发包从压缩包的 driver/CSharp/ 目录中获取 sequoiadb.dll 链接库在 Visual Studio 中引用该链接库，或者在命令行编译时指定引用该链接库，例如：“csc /target:exe /reference:sequoiadb.dll Find.cs Common.cs”，即可使用相关 API Note: 用户可以在安装目录下的 smaples/C# 目录中找到 CSharp 驱动的完整示例。 BSON库API SequoiaDB 巨杉数据库的 CSharp 驱动使用了第三方公司 MongoDB 提供的 CSharp BSON 库，详细

文档

C# 驱动

SequoiaDB CSharp（又称为 C#）驱动提供了数据库操作和集群操作的接口。数据库操作包括数据库的连接、用户的创建删除、数据的增删改查、索引的创建删除、快照的获取与重置、集合与集合空间的创建删除操作等操作。集群操作包括管理复制组和数据节点的各种操作，例如：启动或停止复制组、启动或停止数据节点、获取主从数据节点、集合分区等。 CSharp 类实例 CSharp 驱动的有两种类实例。一种用于数据库操作，另一种用于集群操作。数据库操作实例 SequoiaDB 巨杉数据库中的数据存放分为三个级别：数据库集合空间集合在数据库操作中，可用三个类来分别表示数据库连接、集合空间、集合实例，一个类表示游标实例，一个类表示大对象。类名称描述 SequoiaDB 数据库实例代表一个单独的数据库连接 CollectionSpace 集合空间实例代表一个

文档

PHP 开发基础

本文档主要介绍如何使用 PHP 驱动接口编写使用 SequoiaDB 巨杉数据库的程序。完整的示例代码请参考 SequoiaDB 安装目录下的 samples/PHP 连接数据库连接 SequoiaDB 数据库，之后即可访问、操作数据库。 // 创建 SequoiaDB 对象 $db = new SequoiaDB(); // 连接数据库 $arr = $db -> connect( "sdbserver:11810" ); // 打印连接结果，返回的默认是 php 数组类型，返回值是 array(0){"errno"=>0} var_dump($arr); // 如果 errno 为 0，那么连接成功 if( $arr['errno'] !=0 ) { exit()

文档

集群模式部署

本文档主要介绍如何在本地主机采用三副本机制部署 SequoiaDB 巨杉数据库集群。集群模式是 SequoiaDB 巨杉数据库部署的标准模式，具有高可用、容灾、数据分区等能力。集群模式说明在集群环境下，SequoiaDB 巨杉数据库需要三种角色的节点，分别为：数据节点、编目节点和协调节点。集群模式的最小配置中，每种角色的节点都至少启动一个，才能构成完整的集群模式。集群模式中客户端或应用程序只需连接协调节点，协调节点会对接收到的请求进行解析，并将请求发送到数据节点进行处理。一个或多个节点组成复制组，复制组间的数据无共享。复制组内各节点采用异步数据复制，以保证数据的最终一致性。检查服务状态在进行集群模式部署前，用户需要在每台数据库服务器上检查 SequoiaDB 配置服务的状态。 # service sdbcm status 系统提示“sdbcm is running”

文档

容灾切换合并工具

用户可以通过安装路径 tools/dr_ha 下的脚本实现 SequoiaDB 巨杉数据库集群环境的分离及合并、故障节点的剔除与加入功能。集群分离与合并工具集群分离与合并工具适用于需要 SequoiaDB 提供可靠的备份方案及高可用方案，以应对可能发生的各种意外，确保用户的数据在各种意外情况下都能得到有效保障。典型的应用场景可参考高可用与容灾章节。使用说明集群分离与合并工具包括如下几个脚本： init.sh：初始化脚本，SequoiaDB 集群环境正常时初始化集群信息，用于保存当前集群所有的组信息，供集群合并时恢复集群环境 split.sh：集群分离脚本，当两个子网发生网络分离，相互无法访问时，使用该脚本进行集群分离，让两个子网分离成两个独立的集群 merge.sh：集群合并脚本，当两个子网网络连通时，使用该脚本将之前分离的两个独立集群合并成一个大集群 cluster_

文档

全文索引

SequoiaDB 巨杉数据库支持创建全文索引，用于在大量文本中进行快速检索。与其他索引相比，全文索引通过建立词库，统计每个词条出现的频率和位置，可以快速定位关键词出现的位置，以提升检索效率。一个新的文档从插入集合到可被搜索会有一定的延迟，延迟长短取决于构建全文索引的速度。索引的构建主要分为以下两种情况：在空集合或者只有很少量数据的集合上创建全文索引。在写入压力不大的情况下，通常在若干秒（典型值如 1~5 秒）内，新增的数据即可被搜索到。创建全文索引时，集合中已存在大量的数据。此时要在集合的所有文档中构建索引，耗时从分钟级到若干小时不等，取决于数据规模、搜索服务器性能等因素。如果在索引构建完成之前进行查询，只能查到部分结果。基本原理 SequoiaDB 巨杉数据库使用 Elasticsearch 作为全文检索引擎实现全文索引。全文索引与普通索引的最大区别在于，索引数据不

文档

集群管理诊断日志

SequoiaDB 巨杉数据库的集群管理诊断日志记录了数据库集群被执行的所有操作。通过诊断日志，用户可以对数据库集群的运行状态进行故障分析、行为分析等操作，能有效帮助用户获取数据库集群的执行情况。集群管理诊断日志诊断日志作用记录用户对 SequoiaDB 集群管理的行为操作后台遇到的重大事件的信息用于分析和定位问题诊断日志分类 SequoiaDB 的集群管理诊断日志主要包括集群管理服务、集群节点和集群任务等三大模块的操作日志和运行日志，相关操作和对应的日志文件见如下表格：类型相关操作日志文件集群管理服务诊断日志主要包括 CM 服务运行日志 sdbcm.logsdbcm_script.logsdbcmart.logsdbcmtop.logsdbcmd.log 集群节点诊断日志节点启停 sdbstart.logsdbstop.log 集

文档

同城双中心部署

节点故障场景进行灾难恢复。如果故障节点未超过半数，用户仅需修复故障节点并恢复节点数据即可。主中心故障当主中心发生故障，集群将失去半数以上的节点，导致无法对外提供读写服务。针对该情况，用户需参考数据中心故障场景进行灾难恢复。灾备中心故障当灾备中心发生故障，主中心仍可提供读写服务。针对该情况，用户仅需修复故障中心并恢复节点数据即可。数据中心网络故障当数据中心发生网络故障，集群仍可提供读写服务。针对该情况，用户仅需修复网络故障并恢复节点数据即可。灾难恢复 SequoiaDB 巨杉数据库提供容灾切换合并工具，用于对节点故障场景和数据中心故障场景进行灾难恢复。下述以 SequoiaDB 安装目录 /opt/sequoiadb/、集群鉴权用户名“sdbadmin”和用户密码“sdbadmin”为例，介绍不同场景的灾难恢复步骤。节点故障场景下述以复制

文档

同城三中心部署

，用户仅需修复故障中心并恢复节点数据即可。两个数据中心故障当两个数据中心发生故障，集群将失去半数以上的节点，导致无法对外提供读写服务。针对该情况，用户需参考数据中心故障场景进行灾难恢复。数据中心网络故障当一个数据中心发生网络故障，另外两个数据中心仍可提供读写服务。针对该情况，用户仅需修复网络故障并恢复节点数据即可。当两个数据中心发生网络故障，集群将失去半数以上的节点，导致无法对外提供读写服务。针对该情况，用户需参考数据中心故障场景进行灾难恢复。灾难恢复 SequoiaDB 巨杉数据库提供容灾切换合并工具，用于对节点故障场景和数据中心故障场景进行灾难恢复。下述以 SequoiaDB 安装目录 /opt/sequoiadb/、集群鉴权用户名“sdbadmin”和用户密码“sdbadmin”为例，介绍不同场景的灾难恢复步骤。节点故障场景下述以复制

文档

两地三中心部署

，用户仅需修复故障中心并恢复节点数据即可。当灾备中心B发生故障，集群仍对外提供读写服务。针对该情况，用户仅需修复故障中心，并恢复日志重放进程即可。同城双中心故障当主中心和灾备中心A发生故障，本地集群将无法提供读写服务。针对该情况，用户需将应用请求发送至灾备中心B所在集群，并修复故障中心。待故障修复后再将应用请求切换回主中心所在集群。数据中心网络故障当数据中心发生网络故障，集群仍可提供读写服务。针对该情况，用户仅需修复网络故障并恢复节点数据即可。灾难恢复 SequoiaDB 巨杉数据库提供容灾切换合并工具，用于对节点故障场景和数据中心故障场景进行灾难恢复。下述以 SequoiaDB 安装目录 /opt/sequoiadb/、集群鉴权用户名“sdbadmin”和用户密码“sdbadmin”为例，介绍不同场景的灾难恢复步骤。节点故障场景下述以复制

文档

搜索