RavenDB数据库 v5.1.7 官方版

　　RavenDB是一款绿色安全、免费开源且稳定可靠的NOSQL数据库源码，通过该源码用户可以快速建立一个NoSQL数据架构，或者为目前的关系型数据库添加一个NoSQL层，而RavenDB中的查询使用一种称为RQL的类似SQL的语言，该语言易于理解和使用且不会给用户带来负担，可让用户更简单便捷的使用SQL数据库；RavenDB所有对服务器的请求及其响应都缓存在文档存储中，一旦查询到达RavenDB实例，该实例就会调用其查询优化器来分析查询并确定应使用哪些索引来检索所请求的数据，非常方便实用。

软件功能

　　会话-使用会话对象对特定数据库执行操作

　　操作-使用一组低级操作命令管理服务器

　　批量插入-在插入大量数据时很有用

　　约定-自定义客户端API行为

　　更改API-从服务器接收消息

　　积极的缓存-配置缓存行为

　　事件-执行自定义操作以响应会话的操作

　　数据订阅-在客户端定义和管理数据处理

软件特色

　　完全事务性

　　在保留关系数据库最重要部分的同时,获得NoSQL的好处。

　　RavenDB非常适合OLTP任务,例如处理销售,购买等。

　　多模型架构

　　RavenDB支持自动ETL(提取,转换和加载)过程,以将数据复制到SQL解决方案。

　　作为ACD数据库,您可以将 RavenDB与现有的SQL数据库一起使用,并享受两全其美的优势。

　　多合一数据库

　　我们的内部存储引擎旨在在一处满足您的所有需求。

　　您通常可以从其他地方获得触手可及的功能,从而节省了时间和金钱。我们自动执行许多任务以减少您的开销,因此对昂贵的支持的需求减少了。

　　易于使用

　　RavenDB易于安装,实现和使用。有一个小的学习坡道。

　　我们的高质量GU具有强大的内置监视功能和基于SQL的查询语言,使RavenDB对开发人员和非开发人员均易于使用。

　　快速放大

　　设置集群非常简单,只需在 RavenDB Management Studio中单击即可。

　　通过在几分钟之内创建新的数据库节点,可以有效,高效地跟上不断增长的数据和Web流量。

　　高可用性

　　节点之间的实时复制使您的数据库保持联机状态,并始终可跨多个点使用。

　　您的群集在网络分区中保持正常工作。平衡负载,减少延迟并在多个位置优化性能以为您的用户提供服务。

　　比以往更快

　　每秒可在简单的商品硬件上管理超过100万次读取和150,000次写入。

官方教程

　　入门欢迎来到RavenDB！

　　本文将帮助您入门，并指导您完成RavenDB的所有基本知识和简单设置所需的部分。它由两部分组成：

　　该服务器部分将集中在RavenDB服务器的安装，设置和配置

　　该客户端部分将介绍我们的客户端库背后的一般原则

　　服务器让我们从安装和配置服务器开始。为了做到这一点，我们首先需要从下载页面下载服务器软件包。

　　RavenDB是跨平台的，支持以下操作系统：

　　Windows x64 / x86

　　Linux x64

　　码头工人

　　苹果系统

　　先决条件RavenDB是用.NET Core编写的，因此它需要与.NET Core相同的先决条件集。

　　视窗

　　在启动RavenDB服务器之前，请安装Visual C ++ 2015可再发行组件包（或更高版本）。该软件包应该是“ Windows”平台的唯一要求。如果遇到困难，请查看Microsoft撰写的Windows上.NET Core的先决条件文章。

　　的Linux

　　我们强烈推荐更新您的Linux操作系统之前启动RavenDB服务器。还要在Microsoft撰写的《Linux上的.NET Core的先决条件》一文中检查.NET Core是否需要任何其他先决条件。

　　苹果系统

　　我们强烈建议您在启动RavenDB服务器之前，更新您的MacOS并检查Microsoft撰写的《macOS上.NET Core的先决条件》一文。

　　安装与设定提取服务器软件包后，您可以通过运行（或）脚本或禁用“安装向导”并手动配置服务器来启动安装向导。run.ps1run.sh

　　在Docker容器中运行

　　如果您有兴趣将服务器托管在Docker容器中，请阅读我们的专用文章。

　　在VM中运行

　　如果您有兴趣在VM上托管服务器，请参阅

　　AWS Windows虚拟机

　　AWS Linux虚拟机

　　AWS Linux VM上的Docker

　　帮助我们改善提示

　　首次启动RavenDB时，您会看到以下提示，询问您是否愿意与我们匿名共享一些Studio使用情况数据，以帮助我们改善RavenDB：

　　帮助我们改善

　　响应此提示后，它不应再次出现。但是，在某些情况下，例如运行嵌入式RavenDB或在没有浏览器cookie的情况下工作，提示可能会再次出现。

　　如有必要，您可以将此标志添加到Studio URL中，以防止出现提示：

　　#dashboard?disableAnalytics=true

　　配置RavenDB服务器正在使用settings.json文件来存储服务器范围的配置选项。该文件位于Server目录中，但是请注意，对该文件进行更改后，需要重新启动服务器才能应用它们。

　　您可以在我们的专用文章中了解有关可用配置选项的更多信息。

　　默认配置

　　每个RavenDB服务器分发软件包中包含的配置文件如下：

　　这意味着服务器将运行：

　　上localhost一个random port

　　在Setup Wizard模式下

　　将数据存储在RavenData目录中。

　　使用中的港口

　　在某些情况下，端口可能正在使用中。这样可以防止服务器以“使用中的地址”错误（EADDRINUSE）开头。

　　可以通过编辑ServerUrl值来更改端口。

　　写权限

　　RavenDB需要对以下位置的写许可权：

　　运行RavenDB服务器的文件夹（通过安装向导更新settings.json）

　　数据文件夹（DataDir设置）

　　日志文件夹（Logs.Path设置）

　　如果打算作为服务运行，则应将写权限授予运行该服务的用户（例如“本地服务”）。

　　工作室自由

　　我们的GUI（RavenDB Management Studio）随每种许可证类型免费提供：

　　社区

　　专业的

　　企业

　　安装和设置后，可以使用ServerUrl或ServerPublicUrl值（例如）通过浏览器访问Studio http://localhost:8080。

　　安全问题为了使开发人员能够快速开始对应用程序进行编码，RavenDB将以以下默认安全模式运行：

　　默认安全模式

　　只要数据库是在本地计算机内部使用的，并且不允许外部连接，您就可以忽略安全问题，并且不需要身份验证。一旦将RavenDB设置为侦听本地计算机外部的连接，您的数据库将立即阻止此易受攻击的配置，并要求管理员正确设置安全性和访问控制，以防止对数据的未授权访问或明确允许不安全的配置。

　　我们建议您使用“安装向导”从一开始就轻松轻松地安全地安装RavenDB。

　　在此处阅读有关安全性以及如何启用身份验证的更多信息。

　　客户服务器启动并运行后，要编写应用程序，您需要获取以下Client访问库之一：

　　.NET从NuGet

　　来自Maven的Java

　　NPM的Node.js

　　PyPi的Python

　　红宝石

　　文件库首先，您需要创建一个实例DocumentStore-应用程序的主入口点，该实例负责建立和管理RavenDB服务器（或集群）与应用程序之间的连接。

　　例子

　　在继续进行示例之前，我们想指出大多数文章都在使用Northwind数据库。您可以在此处了解有关它以及如何部署它的更多信息。

　　在DocumentStore能够使用多个数据库，并进行适当的操作，我们建议为每个应用程序只有它的一个实例。

　　以下文章可以扩展您对DocumentStore和及其配置的了解：

　　什么是文件存储？

　　如何创建文件存储？

　　如何设置默认数据库？

　　如何使用约定配置文档存储？

　　会议的Session用于操作的数据。它实现了Unit of Work模式，并且能够批量处理请求，以节省昂贵的远程调用。与a相反，DocumentStore它是一个轻量级的对象，可以更频繁地创建。例如，在Web应用程序中，常见的（推荐的）模式是为每个请求创建一个会话。

　　示例I-存储RavenDB是一个文档数据库。所有存储的对象都称为documents。每个文档都包含一个唯一的ID，用于标识该文档，数据和相邻的元数据（均以JSON格式存储）。元数据包含描述文档的信息，例如上次修改日期（@last-modified属性）或集合（@collection属性）分配。

　　示例II-加载在Session旨在帮助用户写高效的代码很容易。例如，当.Load从服务器加载文档（）时，可以选择在同一请求中检索其他文档（使用.Include），从而使昂贵的调用次数保持最少。

　　除此之外，会话还实现了Unit of Work模式，这意味着将自动跟踪对已加载实体的所有更改。该调用将仅与会话中已更改的文档（与服务器）同步。所有这些更改都在一个请求中发送（保存网络调用）并在一个事务中处理（您可以在此处了解RavenDB为什么是ACID数据库）。SaveChanges

　　示例III-查询为了满足查询，使用了索引。从查询的角度来看，索引定义了可用于查找文档的文档字段。整个索引过程是异步完成的，即使更改了大量数据，查询响应时间也非常快。但是，这种方法的含义是索引可能是陈旧的。

　　当查询中未指定索引时（如下面的查询中所示），RavenDB将使用其智能自动索引功能，该功能将使用现有索引或如果找不到匹配项则创建一个新索引。另一种选择是自己编写索引并将其部署到服务器。这些索引称为静态索引。

　　在后台，查询被转换为Raven查询语言（RQL）语法。在此处阅读有关RQL的更多信息。

更新日志

　　5.1.7（51024）-2021/04/23

　　服务器

　　[Indexes] 修复了索引替换（因此更新索引）可能导致索引暂停的问题

　　[Indexes] 修复了使用'Indexing.MaxNumberOfConcurrentlyRunningIndexes'时可能发生的索引编制死锁

　　[TCP] 轻轻关闭TCP TestConnection和TCP Ping，以避免进入CLOSE_WAIT状态

　　5.1.6（51023）-2021/04/13

　　服务器

　　[Backup] 修复了从备份还原逻辑删除的问题

　　[Cluster] 添加了端点以从筏日志中删除条目

　　[Configuration]添加了Indexing.MaxNumberOfConcurrentlyRunningIndexes配置选项（默认值：null-无限制）

　　[Configuration]Indexing.Encrypted.TransactionSizeLimitInMb根据可用内存量，增加的配置选项dafault值：

　　<= 1GB RAM或以32位运行-96MB

　　<= 4GB RAM-128MB

　　<= 16GB RAM-256MB

　　<= 64GB RAM-512MB

　　> 64GB RAM-1024MB

　　[Configuration]添加了Http.AllowSynchronousIO配置选项（默认值：false）

　　[Indexing] 修复了每次提交时重新创建索引编写器的行为

　　[Indexing] 修复ERROR_COMMITMENT_LIMIT的处理视为内存不足

　　[Indexing] 减少处理临时文件所需的IO数量

　　[Indexing]增加了限制并发运行索引的数量的功能，以减少内存和IO使用率（Indexing.MaxNumberOfConcurrentlyRunningIndexes）

　　[Indexing] 修复了Lucene中无效的内存分配

　　[Indexing] 添加了群集范围内的禁用索引

　　[Indexing] 减少了与在索引中使用Nuget DLL相关的错误的日志记录杠杆

　　[Indexing] 比较其他来源时规范换行符

　　[Fixed]修复了跳过文档而不检查是否需要检查CanContinueBatch导致OutOfMemory错误的问题

　　[Querying] 无效JS日期的更好例外

　　[Querying] 确保在HTTP请求中止的情况下停止查询执行

　　[Querying] 在不存在的索引上进行流传输应引发适当的异常，而不是NRE

　　[Querying]修复了将搜索查询与Boost仅包含引号的on词一起使用时的问题

　　[SNMP] 禁用，加密和当前节点数据库的公开数量

　　[SNMP] 公开的GC内存信息

　　[Server]禁用Kestrel AllowSynchronousIO，并使请求处理完全异步。添加Http.AllowSynchronousIO以允许用户显式控制它。

　　[SQL ETL] 在将记录加载到PostgreSQL时，增加了将GUID转换为UUID的处理

　　[Time Series] 固定附加带有DateTime.MinValue的条目

　　[Time Series] 当时间序列名称不是字符串时，避免引发异常

　　[Time Series] 添加了对查询带引号的时间序列的支持

　　[Tombstones] 添加了端点，可以强制清理墓碑并检查清理状态

　　[Voron]修复了压缩页面的页面拆分中未处理的情况。这适用于map-reduce索引，并可能导致“遇到不是根目录的空页面”错误。

　　[Voron] 确保在数据刷新期间发生错误时报告警报，并重新创建backgroud任务

　　[Voron] 修复暂存缓冲区中未释放的分配，该暂存缓冲区使暂存文件从未清除过