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镜像已被下载超过