typesense

typesense官网,提供快速,容错和内存模糊搜索功能的开源搜索引擎

简介

在数字化时代，用户体验的关键要素之一是一个高效、准确且愉悦的搜索引擎。Typesense作为一款开源搜索引擎，旨在提供快速、容错和内存模糊搜索功能，为用户打造出令人满意的搜索体验。相较于Algolia和ElasticSearch，Typesense是一个更为用户友好的替代方案。

typesense官网: https://typesense.org/

Typesense 快速入门指南

# Typesense 快速入门教程

欢迎使用 Typesense，一款专注于提供高效、准确和愉悦搜索体验的先进搜索引擎。本教程将详细介绍如何从安装到基本使用，一步步带您了解 Typesense 的强大功能。

## 步骤1：安装 Typesense

首先，您需要安装 Typesense。按照以下步骤进行：

### 选项1：下载二进制包

1. 访问 Typesense 的官方网站：[https://typesense.org/](https://typesense.org/)。
2. 下载适用于您操作系统的二进制包。目前支持 Linux（x86_64和arm64）和 Mac（x86_64）。

### 选项2：使用 Docker

1. 安装 Docker：[https://docs.docker.com/get-docker/](https://docs.docker.com/get-docker/)。
2. 运行以下命令启动 Typesense：

“`bash
docker run -p 8108:8108 typesense/typesense:0.25.0 –data-dir /data
“`

### 选项3：Typesense Cloud

1. 访问 Typesense Cloud：[https://cloud.typesense.org/](https://cloud.typesense.org/)。
2. 创建账户并按照指示设置托管集群。

## 步骤2：配置和启动 Typesense

一旦安装完成，现在我们需要配置和启动 Typesense。

1. 创建一个配置文件（例如 `typesense-server-config.json`）并编辑以下内容：

“`json
{
“nodes”: [
{
“host”: “localhost”,
“port”: 8108,
“protocol”: “http”
}
],
“api_key”: “your-api-key”,
“enable_cors”: true,
“num_shards”: 1,
“num_replicas”: 1
}
“`

确保根据需要修改配置参数。

2. 使用以下命令启动 Typesense：

“`bash
typesense-server –config typesense-server-config.json
“`

## 步骤3：使用 Typesense API

Typesense 提供了直观且功能丰富的 API，使您能够轻松地与搜索引擎进行交互。

1. 创建一个集合：

“`bash
curl -X POST -H “Content-Type: application/json” \
-H “X-TYPESENSE-API-KEY: your-api-key” \
–data ‘{
“name”: “movies”,
“fields”: [
{“name”: “id”, “type”: “string”, “facet”: false},
{“name”: “title”, “type”: “string”, “facet”: false},
{“name”: “year”, “type”: “int32”, “facet”: false},
{“name”: “genres”, “type”: “string[]”, “facet”: true}
],
“default_sorting_field”: “year”
}’ \
http://localhost:8108/collections
“`

2. 导入数据：

“`bash
curl -X POST -H “Content-Type: application/json” \
-H “X-TYPESENSE-API-KEY: your-api-key” \
–data ‘[{
“id”: “1”,
“title”: “Inception”,
“year”: 2010,
“genres”: [“Action”, “Sci-Fi”, “Thriller”]
},{
“id”: “2”,
“title”: “The Matrix”,
“year”: 1999,
“genres”: [“Action”, “Sci-Fi”]
}]’ \
http://localhost:8108/collections/movies/documents
“`

3. 执行搜索：

“`bash
curl -X GET -H “Content-Type: application/json” \
-H “X-TYPESENSE-API-KEY: your-api-key” \
–data ‘{
“q”: “matrix”,
“query_by”: “title”
}’ \
http://localhost:8108/collections/movies/documents
“`

## 步骤4：深入体验 Typesense 的特色功能

现在，您已经完成了基本设置，可以开始尝试 Typesense 的特色功能：

– **容错处理：** 输入一些带有拼写错误的搜索词，观察 Typesense 如何处理并返回相关结果。

– **可调排名：** 调整搜索结果的排名顺序，了解如何根据不同条件进行排序。

– **地理搜索：** 使用地理坐标进行搜索，了解 Typesense 如何处理基于位置的搜索。

– **语义/混合搜索：** 利用内置模型或第三方 API，尝试进行语义搜索并观察结果。

## 步骤5：参与 Typesense 社区

如果您有任何问题或反馈，我们鼓励您积极参与 Typesense 社区。查看问题跟踪器，提出新功能请求或回答其他用户的问题。我们重视用户反馈，期待听到您的声音！

通过这个详细的快速入门教程，您应该已经能够深入了解 Typesense 的基本使用和强大功能。祝您在使用 Typesense 过程中取得成功！

 

特色功能

## Typesense: 强大开源搜索引擎的卓越功能

在数字化时代，搜索引擎的效率和用户体验对于互联网应用至关重要。Typesense作为一款开源搜索引擎，以其卓越的特色功能，为用户提供了强大而愉悦的搜索体验。以下是Typesense引擎的主要特色功能，为您带来更全面、高效的搜索解决方案。

### 1. 容错处理

Typesense能够以优雅的方式处理打字错误，提供卓越的容错处理。即便用户在输入时存在拼写错误，Typesense也能确保返回相关结果，提高搜索的准确性。

### 2. 简单愉悦

Typesense易于设置、集成、操作和扩展，使得用户能够轻松上手。即使是对搜索引擎了解有限的初学者，也能快速掌握Typesense的使用，为其提供无缝的搜索体验。

### 3. 极速搜索

由C++构建的Typesense从底层精心设计，实现了低延迟（<50毫秒）的即时搜索。用户能够快速获取搜索结果，提供高效的搜索体验。

### 4. 可调排名

Typesense提供了轻松调整搜索结果的功能，使用户能够根据个人需求和优先级，定制搜索结果的排名顺序，实现个性化搜索。

### 5. 排序

在查询时，Typesense支持根据特定字段动态排序结果，例如“按价格升序排列”。这一功能使得搜索结果更有序，更符合用户的需求。

### 6. 分面和过滤

Typesense允许用户深入了解并细化搜索结果，通过分面和过滤功能，用户能够更迅速地找到需要的信息，提升搜索体验。

### 7. 分组和去重

相似的结果能够被分组显示，提供更多多样性。这种分组和去重的方式使用户能够更轻松地浏览和比较搜索结果。

### 8. 联合搜索

Typesense支持在单个HTTP请求中跨多个集合（索引）进行搜索。这使得用户能够更全面地检索相关信息，提高搜索的广度和深度。

### 9. 地理搜索

基于纬度/经度或在一个边界框内进行搜索和排序，Typesense的地理搜索功能使得用户能够根据地理位置获取相关信息，适用于地理信息相关的应用场景。

### 10. 向量搜索

Typesense支持将来自机器学习模型的嵌入索引到引擎中，进行最近邻搜索。这使得构建相似性搜索、语义搜索、视觉搜索和推荐等功能成为可能。

### 11. 语义/混合搜索

Typesense能够利用内置模型或第三方API，如S-BERT、E-5等，生成嵌入并用于查询和索引数据。这为用户提供了出色的语义搜索和关键字搜索体验。

### 12. 作用域API密钥

引擎支持生成仅允许访问特定记录的API密钥，特别适用于多租户应用，提高数据的安全性。

### 13. 同义词

用户可以定义单词的等效词，确保搜索一个词将返回定义的同义词的结果，提高搜索的涵盖面。

### 14. 策展和推销

Typesense允许将特定记录提升到搜索结果的固定位置，进行特别展示。这一功能对于推广特定内容或产品非常有用。

### 15. 基于Raft的集群

引擎支持基于Raft的集群，用户能够设置高度可用的分布式集群，确保搜索服务的稳定性和可靠性。

### 16. 无缝版本升级

Typesense设计了无缝版本升级的机制。当新版本发布时，用户只需替换二进制文件并重新启动Typesense即可完成升级，简化了系统维护的流程。

### 17. 无运行时依赖

Typesense是一个单一的二进制文件，用户可以使用单一命令在本地或生产环境中运行它。这种设计减少了运行时依赖，简化了安装和配置过程。

这些功能使 Typesense 成为一款强大而灵活的搜索引擎，适用于各种应用场景和用户需求。无论是提升搜索的准确性、速度，还是实现个性化和多样化的搜索体验，Typesense都为用户提供了卓越的搜索解决方案。

路线图

Typesense的公共路线图可在[此处](https://github.com/typesense/typesense/projects/1)找到。第一列还解释了我们如何根据用户反馈、您如何影响优先级以及我们的发布节奏来设置功能的优先级。

基准测试

我们进行了基准测试，包含以下数据集：

1. 包含220万个食谱（食谱名称和配料）的数据集：
– 在Typesense中索引时占用约900MB的RAM。
– 索引所有220万条记录耗时3.6分钟。
– 在4vCPU服务器上，Typesense能够处理每秒104个并发搜索查询，平均搜索处理时间为11毫秒。

2. 包含2800万本书（书名、作者和分类）的数据集：
– 在Typesense中索引时占用约14GB的RAM。
– 索引所有2800万条记录耗时78分钟。
– 在4vCPU服务器上，Typesense能够处理每秒46个并发搜索查询，平均搜索处理时间为28毫秒。

3. 包含300万个产品（亚马逊产品数据）的数据集：
– 在8-vCPU 3节点高可用Typesense集群上，Typesense能够处理每秒250个并发搜索查询。

我们期待使用更大的数据集进行基准测试。如果您知道公共领域中的大型结构化数据集，请告诉我们。如果您有关于自己大型数据集的基准测试结果，请通过开启一个问题告诉我们！

用户

Typesense被许多领域和行业的用户广泛使用。在Typesense Cloud上，我们每月为用户提供超过15亿次搜索服务。Typesense的Docker镜像已被下载超过